名称: 项目规划助手 描述: “检测过时的项目计划并建议会话命令。触发条件:同步计划、更新计划、检查状态、计划过时、跟踪进度、项目规划。” 允许工具: “读取全局待办事项写入”
项目规划助手技能
针对 docs/PLAN.md 的轻量级感知层。检测计划何时需要关注,并指向 /save 和 /sync 命令。
目的
此技能不直接管理计划。它:
- 检测
docs/PLAN.md是否存在或缺失 - 识别过时的计划(与 Git 活动相比,近期无更新)
- 建议适当的会话命令
所有计划操作都通过 /save(持久化)和 /sync(恢复/状态)进行。
检测逻辑
计划缺失
未找到 docs/PLAN.md
-> 建议:使用 /save 从对话中创建初始计划
计划过时
docs/PLAN.md 最后修改时间:5天前
git log 显示:自那以后有12次提交
-> 建议:使用 /sync --git 从提交记录更新
未提交的工作
git status 显示:5个已修改文件
docs/PLAN.md 中的“进行中”部分已过时
-> 建议:使用 /sync --status 进行审查
会话开始
恢复处理包含 docs/PLAN.md 的项目
-> 建议:使用 /sync 恢复状态
快速参考
| 情况 | 建议 |
|---|---|
| 无计划存在 | 讨论目标后使用 /save |
| 计划过时 | /sync --git |
| 需要查看计划 | /sync --status |
| 更新进度 | /save "备注" |
| 重新开始 | /save --archive |
过时启发式规则
当满足以下条件时,计划被视为过时:
- 最后修改时间 > 3天前 且
- Git 显示自上次修改后有提交 且
- 提交与计划主题相关(feat:、fix:、refactor:)
当满足以下条件时,计划需要审查:
- 会话刚刚开始
- 存在大量未提交的更改
- 用户提及进度或完成情况
备注
- 此技能仅提供建议,从不修改
/sync读取状态,/save写入状态- 单一事实来源:
docs/PLAN.md