fit-framework: Command for Claude Code

Sync Issue Command

功能说明

将任务的处理进度摘要同步到对应的 GitHub Issue 评论板中，确保 Issue 中的信息有逻辑、完整且易于追踪。

执行流程

1. 验证任务存在

按以下优先级搜索任务：

• 查找 .ai-workspace/active/{task-id}/task.md（优先）
• 如果不存在，查找 .ai-workspace/blocked/{task-id}/task.md
• 如果不存在，查找 .ai-workspace/completed/{task-id}/task.md
• 如果都不存在，提示用户任务不存在

找到后记录任务状态（status）和任务目录路径。

注意：{task-id} 格式为 TASK-{yyyyMMdd-HHmmss}，例如 TASK-20260205-202013

2. 读取任务信息

从任务文件中获取：

• Issue 号码（issue_number 字段）
• 任务标题和描述
• 当前步骤（current_step）
• 任务状态（status）
• 创建和更新时间

3. 读取上下文文件

检查并读取以下文件（如果存在）：

• .ai-workspace/{status}/{task-id}/analysis.md - 需求分析
• .ai-workspace/{status}/{task-id}/plan.md - 技术方案
• .ai-workspace/{status}/{task-id}/implementation.md - 实现报告
• .ai-workspace/{status}/{task-id}/review.md - 审查报告

4. 生成进度摘要

根据当前状态生成清晰的进度摘要：

基本格式：

## 🤖 任务进度更新

**任务ID**: {task-id}
**更新时间**: {当前时间}
**当前状态**: {状态描述}

### ✅ 已完成

- [x] 需求分析 - {完成时间}
  - {核心要点摘要 1-2 条}
- [x] 技术方案设计 - {完成时间}
  - {方案选择和关键决策 1-2 条}
- [ ] 代码实现（进行中）
- [ ] 代码审查
- [ ] 最终提交

### 📋 当前进展

{当前步骤的详细说明}

### 🎯 下一步

{下一步计划}

### 📂 相关文件

- 任务文件: `.ai-workspace/{status}/{task-id}/task.md`
- 需求分析: `.ai-workspace/{status}/{task-id}/analysis.md`
- 技术方案: `.ai-workspace/{status}/{task-id}/plan.md`

---
*由 Claude Code 自动生成 - [任务管理系统](../.agents/README.md)*

摘要原则：

• 简洁：每个阶段只提取核心要点，避免冗长
• 逻辑清晰：按时间顺序展示进展
• 突出关键决策：技术方案选择、重要发现等
• 面向人类阅读：避免技术细节，使用易懂的语言

5. 同步到 Issue

使用 gh 命令将摘要发布到 Issue：

gh issue comment {issue-number} --body "$(cat <<'EOF'
{生成的进度摘要}
EOF
)"

6. 更新任务状态

在任务文件中记录同步时间：

• 添加或更新 last_synced_at 字段
• 记录同步的 Issue 评论链接（如果 gh 返回）

7. 告知用户

输出格式：

✅ 任务进度已同步到 Issue #{issue-number}

**同步内容**：
- 已完成步骤: {数量}
- 当前状态: {状态}
- 下一步: {下一步说明}

**查看链接**：
https://github.com/{owner}/{repo}/issues/{issue-number}

参数说明

• <task-id>: 任务ID，格式为 TASK-{yyyyMMdd-HHmmss}（必需）

使用示例

# 同步任务进度到对应的 Issue
/sync-issue TASK-20251227-104654

# 也可以简写
/sync-issue TASK-20251227-104654