会话初始化技能Skill session-init

会话初始化技能用于在 Claude Code 开发会话开始时自动执行环境检查和任务状态概述,包括确认 Git 状态、计划文件、代理角色等,确保开发流程顺畅并避免错误。关键词:会话初始化、环境检查、任务管理、DevOps、软件开发、自动化、Claude、Git、Plans.md、AGENTS.md。

DevOps 0 次安装 0 次浏览 更新于 3/10/2026

name: session-init description: “通过环境检查和任务状态概述进行会话初始化。当用户提到开始会话、开始工作或状态检查时使用。不要用于:实现工作、评审或会话中期任务。” description-en: “Initializes session with environment checks and task status overview. Use when user mentions starting a session, beginning work, or status checks. Do NOT load for: implementation work, reviews, or mid-session tasks.” description-ja: “環境チェックとタスク状況概要でセッション初期化。Use when user mentions starting a session, beginning work, or status checks. Do NOT load for: implementation work, reviews, or mid-session tasks.” allowed-tools: [“Read”, “Write”, “Bash”] user-invocable: false

会话初始化技能

在会话开始时执行环境确认和当前任务状态把握的技能。


触发短语

这个技能在以下短语时启动:

  • 「会话开始」
  • 「作业开始」
  • 「开始今天的工作」
  • 「确认情况」
  • 「应该做什么?」
  • “start session”
  • “what should I work on?”

概述

会话初始化技能在 Claude Code 会话开始时自动确认以下内容:

  1. Git 状态: 当前分支、未提交的更改
  2. Plans.md: 进行中任务、请求的任务
  3. AGENTS.md: 角色分配、禁止事项的确认
  4. 上次会话: 交接事项的确认

执行步骤

Step 0: 文件状态检查(自动整理)

会话开始前检查文件大小:

# 检查 Plans.md 的行数
if [ -f "Plans.md" ]; then
  lines=$(wc -l < Plans.md)
  if [ "$lines" -gt 200 ]; then
    echo "⚠️ Plans.md 有 ${lines} 行。建议使用「整理一下」进行整理"
  fi
fi

# 检查 session-log.md 的行数
if [ -f ".claude/memory/session-log.md" ]; then
  lines=$(wc -l < .claude/memory/session-log.md)
  if [ "$lines" -gt 500 ]; then
    echo "⚠️ session-log.md 有 ${lines} 行。建议使用「整理会话日志」进行整理"
  fi
fi

如果需要整理,则显示建议(不影响作业)。

Step 0.5: Claude-mem 上下文确认(可选)

如果 Claude-mem 有效,自动显示过去的上下文:

# 检查 Claude-mem 的状态
if [ -f "$HOME/.claude-mem/settings.json" ]; then
  mode=$(cat ~/.claude-mem/settings.json | grep -o '"CLAUDE_MEM_MODE"[^,}]*' | cut -d'"' -f4)
  if [ "$mode" = "harness" ] || [ "$mode" = "harness--ja" ]; then
    echo "📚 Claude-mem (harness 模式) 有效"
  fi
fi

Claude-mem 有效时显示的内容:

  1. 过去的护栏触发:

    • 使用 mem-search 搜索 guard 类型的观测
    • “在这个项目中,过去 N 次防止了测试篡改”
  2. 最近的作业摘要:

    • 显示最新的会话摘要
    • “上次:Feature X 设计完成”
  3. 持续任务的建议:

## 📚 过去的上下文(Claude-mem)

**护栏历史**:
- 防止测试篡改:2次

**上次会话**:
- Feature X 设计完成
- 决定采用 RBAC

**💡 持续推荐**: 从 Plans.md 的「Feature X 实现」开始

注意: 如果 Claude-mem 未设置,则跳过此步骤。 使用 Unified Harness Memory(Step 0.7)时,为避免重复,可以省略此步骤。

Step 0.7: Unified Harness Memory Resume Pack(必需)

从 Codex / Claude / OpenCode 共用数据库(~/.harness-mem/harness-mem.db)获取恢复上下文。

必需调用:

harness_mem_resume_pack(project, session_id?, limit=5, include_private=false)

运营规则:

  • project 必须指定当前项目名
  • session_id$CLAUDE_SESSION_ID.claude/state/session.json.session_id 顺序获取
  • harness_mem_sessions_list(project, limit=1) 的首个使用仅限于 read-only(恢复确认),不用于 record_checkpoint / finalize_session 的写入
  • 获取结果注入到会话开始时的上下文中
  • 获取失败时,使用 harness_mem_health() 确认 daemon 状态,并明确失败后继续
  • 恢复按 scripts/harness-memd doctorscripts/harness-memd cleanup-stalescripts/harness-memd start 顺序进行

Step 1: 环境确认

并行执行以下:

# Git 状态
git status -sb
git log --oneline -3
# Plans.md
cat Plans.md 2>/dev/null || echo "Plans.md not found"
# AGENTS.md 的要点
head -50 AGENTS.md 2>/dev/null || echo "AGENTS.md not found"

Step 2: 把握任务状况

Plans.md 提取以下:

  • cc:WIP - 从上次持续中的任务
  • pm:请求中 - PM 新请求的任务(兼容:cursor:请求中)
  • cc:TODO - 未着手但已分配的任务

Step 3: 输出状况报告

## 🚀 会话开始

**日期时间**: {{YYYY-MM-DD HH:MM}}
**分支**: {{branch}}
**会话ID**: ${CLAUDE_SESSION_ID}

---

### 📋 今天的任务

**优先任务**:
- {{pm:请求中(兼容:cursor:请求中) 或 cc:WIP 的任务}}

**其他任务**:
- {{cc:TODO 的任务列表}}

---

### ⚠️ 注意事项

{{AGENTS.md 的重要约束·禁止事项}}

---

**开始作业吗?**

输出格式

会话开始时,简洁提示以下信息:

项目 内容
当前分支 staging
优先任务 最重要的 1-2 件
注意事项 禁止事项的摘要
下一个动作 具体的建议

相关命令

  • /work - 任务执行(支持并行执行)
  • /sync-status - Plans.md 的进度摘要
  • /maintenance - 文件的自动整理

注意事项

  • 务必确认 AGENTS.md: 把握角色分配后开始作业
  • 如果 Plans.md 不存在: 引导使用 /harness-init
  • 如果上次作业中断: 确认是否继续