更新开发文档技能Skill update-dev-docs

name: update-dev-docs description: 在会话压缩前更新开发文档以捕获进度。在压缩对话、结束会话或切换任务前使用。

更新开发文档

在会话压缩或结束会话前更新开发文档以捕获当前进度。

何时使用

• 在使用 /compact 压缩对话前
• 在结束长会话前
• 当切换到不同任务时
• 在非常长的实施过程中定期

用法

/update-dev-docs [任务名称]

如果未提供任务名称，将在 dev/active/ 中查找活动任务。

说明

当调用此命令时：

1. 查找活动开发文档：

   • 检查 dev/active/ 中现有的任务文件夹
   • 如果找到多个且未提供任务名称，列出它们并询问更新哪个

2. 更新 tasks.md：

   • 同步当前 TodoWrite 状态
   • 标记已完成的项目为完成
   • 添加实施过程中发现的任何新任务
   • 如果需要，更新复杂度估计

3. 更新 context.md：

   • 添加新发现的关键文件
   • 记录任何新做出的决策
   • 更新代码模式，如果识别出新的
   • 添加任何陷阱或经验教训

4. 更新 plan.md（如果需要）：

   • 更新目标的进度
   • 注意任何策略变更
   • 基于发现更新风险评估

5. 生成会话摘要：

   • 本次会话完成了什么
   • 下一步是什么
   • 任何阻碍或开放性问题

会话摘要模板

添加到 context.md 的末尾：

## 会话日志

### [日期] 会话

**已完成：**

- 项目 1
- 项目 2

**下一步：**

- 项目 1
- 项目 2

**阻碍/问题：**

- 问题 1

注意

• 保持更新简洁但信息丰富
• 专注于捕获压缩后会丢失的上下文
• 包括具体的文件路径和行号，如果相关
• 记录“为什么”而不仅仅是“什么”的决策