name: sync-status description: “同步进度与Plans.md到现实。『现在在哪里？』快速位置确认。当用户提到’/sync-status’、进度检查、where am I at或同步Plans.md时使用。不要用于：随意的’how is it going’聊天、非正式的进度问题。” description-en: “将进度与Plans.md同步到现实。‘我在哪里？‘快速位置检查。当用户提到’/sync-status’、进度检查、where am I at或同步Plans.md时使用。不要用于：随意的’how is it going’聊天、非正式的进度问题。” description-ja: “将进度与Plans.md同步到现实。『现在在哪里？』快速位置确认。当用户提到’/sync-status’、进度检查、where am I at或同步Plans.md时使用。不要用于：随意的’how is it going’聊天、非正式的进度问题。” 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

# Agent Trace (最近的编辑文件)
tail -20 .claude/state/agent-trace.jsonl 2>/dev/null | jq -r '.files[].path' | sort -u

步骤 1.5: Agent Trace 分析

从 Agent Trace 获取最近的编辑历史，并与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 中没有的文件编辑	Agent Trace vs 任务描述
任务描述与不同的文件	预期文件 vs 实际编辑
长时间没有编辑的任务	Agent Trace 时间序列 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}}%

### 📄 最近的编辑文件 (Agent Trace)
- {{file1}}
- {{file2}}
- ...

步骤 5: 建议下一步行动

🎯 下一步做什么

**优先级 1**: {{task}}
- 原因: {{requested / unblock}}

**推荐**: /work, /harness-review

异常检测

情况	警告
多个 `cc:WIP`	⚠️ 多个任务进行中
`pm:requested` 未处理	⚠️ 先处理PM的请求
大差距	⚠️ 任务管理未跟上