Back to Details

sync-status

Compare original and translation side by side

🇺🇸

Original

English
🇨🇳

Translation

Chinese

Sync Status Skill

Sync Status Skill

Checks current implementation status, detects differences with Plans.md, and suggests next action.
检查当前实施状态，检测与Plans.md的差异，并建议下一步行动。

Quick Reference

快速参考

  • "How far have we progressed?" → this skill
  • "What should I do next?" → organize and suggest
  • "Check if Plans.md matches actual progress" → detect and update
  • "我们进展到哪一步了？" → 调用此技能
  • "我下一步该做什么？" → 整理并给出建议
  • "检查Plans.md是否与实际进度匹配" → 检测差异并更新

Deliverables

交付成果

  1. Progress check: Consistency between implementation and Plans.md
  2. Difference update: Update Plans.md markers to match reality
  3. Next action suggestion: What to do next with priority
  1. 进度检查：确认实施内容与Plans.md的一致性
  2. 差异更新：更新Plans.md中的标记以匹配实际状态
  3. 下一步行动建议：按优先级推荐后续任务

Execution Flow

执行流程

Step 1: Gather Current Status (Parallel)

步骤1：收集当前状态（并行执行）

bash
undefined
bash
undefined

Plans.md state

Plans.md状态

cat Plans.md
cat Plans.md

Git change status

Git变更状态

git status git diff --stat HEAD~3
git status git diff --stat HEAD~3

Recent commit history

最近提交历史

git log --oneline -10
git log --oneline -10

Agent Trace (直近の編集ファイル)

Agent Trace（最近编辑的文件）

tail -20 .claude/state/agent-trace.jsonl 2>/dev/null | jq -r '.files[].path' | sort -u
undefined
tail -20 .claude/state/agent-trace.jsonl 2>/dev/null | jq -r '.files[].path' | sort -u
undefined

Step 1.5: Agent Trace Analysis

步骤1.5：Agent Trace分析

Agent Trace から直近の編集履歴を取得し、Plans.md のタスクと照合:
bash
undefined
从Agent Trace获取最近的编辑历史，与Plans.md中的任务进行核对：
bash
undefined

直近の編集ファイル一覧

最近编辑的文件列表

RECENT_FILES=$(tail -20 .claude/state/agent-trace.jsonl 2>/dev/null | jq -r '.files[].path' | sort -u)
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期間 |
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与任务描述对比 |
| 编辑的文件与任务描述不符 | 预期文件与实际编辑文件对比 |
| 长时间未编辑的任务 | Agent Trace时间序列与WIP周期对比 |

Step 2: Detect Differences

步骤2：检测差异

Check ItemDetection Method
Done but still 
cc:WIP
Commit history vs marker
Started but still 
cc:TODO
Changed files vs marker
cc:done
but not committed		git status vs marker
检查项目检测方法
已完成但标记仍为
cc:WIP
提交历史与标记对比
已开始但标记仍为
cc:TODO
变更文件与标记对比
标记为
cc:done
但未提交		git状态与标记对比

Step 3: Update Plans.md

步骤3：更新Plans.md

If differences detected, suggest and execute:
📝 Plans.md update needed

| Task | Current | After | Reason |
|------|---------|-------|--------|
| XX | cc:WIP | cc:done | Committed |

Update? (yes / no)
如果检测到差异，将给出建议并执行：
📝 需要更新Plans.md

| 任务 | 当前状态 | 更新后 | 原因 |
|------|---------|-------|--------|
| XX | cc:WIP | cc:done | 已提交 |

是否更新？(yes / no)

Step 4: Output Progress Summary

步骤4：输出进度摘要

markdown
undefined
markdown
undefined

📊 Progress Summary

📊 进度摘要

Project: {{project_name}} ({{project_type}})
StatusCount
🔴 Not started (cc:TODO){{count}}
🟡 In progress (cc:WIP){{count}}
🟢 Done (cc:done){{count}}
Progress rate: {{percent}}%
项目: {{project_name}} ({{project_type}})
状态数量
🔴 未开始 (cc:TODO){{count}}
🟡 进行中 (cc:WIP){{count}}
🟢 已完成 (cc:done){{count}}
进度率: {{percent}}%

📄 直近の編集ファイル (Agent Trace)

📄 最近编辑的文件（Agent Trace）

  • {{file1}}
  • {{file2}}
  • ...
undefined
  • {{file1}}
  • {{file2}}
  • ...
undefined

Step 5: Suggest Next Action

步骤5：建议下一步行动

🎯 What to do next

**Priority 1**: {{task}}
- Reason: {{requested / unblock}}

**Recommended**: /work, /harness-review
🎯 下一步行动建议

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

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

Anomaly Detection

异常检测

SituationWarning
Multiple 
cc:WIP
⚠️ Multiple tasks in progress
pm:requested
not processed		⚠️ Process PM's request first
Large gap⚠️ Task management not keeping up
场景警告信息
存在多个
cc:WIP
任务		⚠️ 同时进行多个任务
pm:requested
任务未处理		⚠️ 请优先处理PM的请求
实际与计划差距较大⚠️ 任务管理未跟上进度