名称: sync-status 描述: “同步进度与Plans.md到现实。『我在哪里？』快速位置检查。当用户提及’/sync-status’、进度检查、where am I at或sync Plans.md时使用。不要用于：非正式的’最近怎么样’聊天、随意的进度询问。” 英文描述: “Sync progress with Plans.md to reality. ‘Where am I?’ quick location check. Use when user mentions ‘/sync-status’, progress check, where am I at, or sync Plans.md. Do NOT load for: casual ‘how is it going’ chat, informal progress questions.” 日文描述: “進捗とPlans.mdを現実に同期。『今どこ？』がすぐわかる現在地確認。Use when user mentions ‘/sync-status’, progress check, where am I at, or sync Plans.md. Do NOT load for: casual ‘how is it going’ chat, informal progress questions.” 允许工具: [“Read”, “Write”, “Edit”, “Bash”, “Grep”, “Glob”] 参数提示: “[–verbose]”
同步状态技能
检查当前实现状态，检测与Plans.md的差异，并建议下一步行动。
快速参考
- “我们进展如何了？” → 本技能
- “下一步应该做什么？” → 组织并建议
- “检查Plans.md是否与实际进度匹配” → 检测并更新
交付成果
- 进度检查: 实现与Plans.md之间的一致性
- 差异更新: 更新Plans.md标记以匹配现实
- 下一步行动建议: 按优先级建议下一步行动
执行流程
步骤 1: 收集当前状态（并行）
# Plans.md状态
cat Plans.md
# Git变更状态
git status
git diff --stat HEAD~3
# 最近提交历史
git log --oneline -10
# 代理跟踪（最近编辑文件）
tail -20 .claude/state/agent-trace.jsonl 2>/dev/null | jq -r '.files[].path' | sort -u
步骤 1.5: 代理跟踪分析
从代理跟踪获取最近编辑历史，并与Plans.md的任务核对：
# 最近编辑文件列表
RECENT_FILES=$(tail -20 .claude/state/agent-trace.jsonl 2>/dev/null | jq -r '.files[].path' | sort -u)
# 项目信息
PROJECT=$(tail -1 .claude/state/agent-trace.jsonl 2>/dev/null | jq -r '.metadata.project')
PROJECT_TYPE=$(tail -1 .claude/state/agent-trace.jsonl 2>/dev/null | jq -r '.metadata.projectType')
核对要点:
| 检查项目 | 检测方法 |
|---|---|
| Plans.md中没有的文件编辑 | 代理跟踪 vs 任务描述 |
| 与任务描述不同的文件 | 预期文件 vs 实际编辑 |
| 长时间未编辑的任务 | 代理跟踪时间序列 vs WIP期间 |
步骤 2: 检测差异
| 检查项 | 检测方法 |
|---|---|
已完成但仍标记为cc:WIP |
提交历史 vs 标记 |
已开始但仍标记为cc:TODO |
变更文件 vs 标记 |
标记为cc:done但未提交 |
git状态 vs 标记 |
步骤 3: 更新Plans.md
如果检测到差异，建议并执行：
📝 Plans.md需要更新
| 任务 | 当前 | 之后 | 原因 |
|------|---------|-------|--------|
| XX | cc:WIP | cc:done | 已提交 |
是否更新？（是 / 否）
步骤 4: 输出进度摘要
## 📊 进度摘要
**项目**: {{project_name}} ({{project_type}})
| 状态 | 数量 |
|--------|-------|
| 🔴 未开始 (cc:TODO) | {{count}} |
| 🟡 进行中 (cc:WIP) | {{count}} |
| 🟢 已完成 (cc:done) | {{count}} |
**进度率**: {{percent}}%
### 📄 最近编辑文件（代理跟踪）
- {{file1}}
- {{file2}}
- ...
步骤 5: 建议下一步行动
🎯 下一步行动
**优先级 1**: {{task}}
- 原因: {{requested / unblock}}
**推荐**: /work, /harness-review
异常检测
| 情况 | 警告 |
|---|---|
多个cc:WIP |
⚠️ 多个任务进行中 |
pm:requested未处理 |
⚠️ 先处理PM的请求 |
| 大差距 | ⚠️ 任务管理未跟上 |