name: sync-status description: “同步进度与Plans.md到现实。‘我在哪里？‘快速位置确认。当用户提到’/sync-status’、进度检查、'我在哪里’或同步Plans.md时使用。不要用于：随意的’最近怎么样’聊天、非正式的进度问题。” description-en: “同步进度与Plans.md到现实。‘我在哪里？‘快速位置确认。当用户提到’/sync-status’、进度检查、'我在哪里’或同步Plans.md时使用。不要用于：随意的’最近怎么样’聊天、非正式的进度问题。” description-ja: “同步进度与Plans.md到现实。‘我在哪里？‘快速位置确认。当用户提到’/sync-status’、进度检查、'我在哪里’或同步Plans.md时使用。不要用于：随意的’最近怎么样’聊天、非正式的进度问题。” allowed-tools: [“Read”, “Write”, “Edit”, “Bash”, “Grep”, “Glob”] argument-hint: “[–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的请求 |
| 大差距 | ⚠️ 任务管理跟不上 |