工作计划技能
工作计划是带时间戳的Markdown文件,能在自动压缩后保留下来。它们是您处理多步骤工作的外部大脑。
文件约定
- 位置: 项目根目录,已加入git忽略
- 名称:
WORKPLAN-YYYYMMDD-slug.md(例如WORKPLAN-20260228-auth-refactor.md) - 每个任务/阶段一个文件。 不要重复使用旧的工作计划。每个独立的工作都重新开始。
动作
创建(/workplan 或 /workplan create)
-
先阅读。 在编写计划之前,阅读所有相关文件、问题和上下文。
-
确保
.gitignore中包含WORKPLAN-*.md(如果缺失则添加)。 -
在编写计划前选择范围模式:
- 扩展:“十分完美的版本是什么样的?”大胆设想,扩大范围。
- 保持:“让这个坚如磐石。”范围合适,最大化严谨性。
- 缩减:“能交付价值的最小方案是什么?”果断剪枝。
默认值:全新功能 = 扩展,错误修复/发布准备 = 保持,有时间限制 = 缩减。
-
使用以下模板创建文件:
# 工作计划:[标题]
创建时间:YYYY-MM-DD HH:MM
最后更新:YYYY-MM-DD HH:MM
状态:进行中
模式:保持 / 扩展 / 缩减
## 背景
[为什么需要这项工作。问题是什么。根本原因。关键限制。相关的问题/PR链接。]
## 路线图
- [ ] 1. 步骤描述
- [ ] 2. 步骤描述
- [ ] 3. 步骤描述
## 决策
[记录架构或方法决策,附带时间戳]
- [HH:MM] 选择了X而非Y,原因是Z
## 发现的问题
[过程中发现的、不在原始范围内的内容]
- [HH:MM] 在完成步骤2时发现了……
## 验证日志
[每个完成的条目都需要一个验证记录]
- [HH:MM] 步骤1:已验证 - 运行 `npm test`,全部42个测试通过
- [HH:MM] 步骤3:已验证 - 手动测试登录流程,OAuth和邮箱均正常工作
更新(/workplan update)
- 读取项目根目录下的活动
WORKPLAN-*.md文件。 - 更新“最后更新”时间戳。
- 勾选已完成的项目并添加验证时间戳。
- 添加任何新的发现或决策。
- 向用户报告当前状态。
关闭(/workplan close)
- 读取当前工作计划。
- 验证所有项目均已勾选并带有验证时间戳。
- 执行最终验证(构建、测试、手动检查)。
- 将状态改为
完成。 - 添加最终总结:
## 已完成
关闭时间:YYYY-MM-DD HH:MM
所有N个项目均已实现并验证。构建通过。测试通过。
恢复(压缩后)
当上下文已被压缩或您不确定上次进行到何处时:
- 查找活动工作计划:在项目根目录中寻找
WORKPLAN-*.md。 - 读取工作计划文件。
- 找到第一个未勾选的项目。
- 从那里继续。
规则
- “已验证”意味着已经过测试。 不是“我认为它有效”。运行它,看到它通过,然后标记为已验证。包括运行的内容和结果。
- 每次更改都更新时间戳。 未来的你(在压缩之后)依赖于此。
- 新发现立即记录。 不要仅保存在上下文中。
- 除非用户确认工作完成,否则绝不删除计划。
- 每个检查列表项目只关注一件事。 将大步骤拆分成可验证的小块。
- 如果某个步骤验证失败, 记录失败,保持未勾选,并补充出错的内容。