实现计划打磨器
将以下提示词粘贴到你的 AI 对话框中:
请根据 https://skillhub.cn/install/skillhub.md,安装 @user_ac28eb50/refine-implementation-plan。
技能介绍
解决什么问题
基于文件的规划(planning-with-files)负责把长期任务拆解为任务清单与阶段状态,但“拆解完成”和“交给另一位 Implementer 能直接开写”之间往往隔着一个关键缺口:计划里写着要做什么,却没有把契约、失败行为、默认值、迁移与验收标准收敛清楚。结果可能是实现者按自己的理解补齐缺口,上线后再返工;也可能在代码已开始改动后才发现某个决策其实还没确认。
本技能要补的就是这段规划到可执行之间的设计收口:把仍模糊的设计问题问清楚,把答案落到同一套规划文件里,最终产出一份冻结的交接说明。
如何工作
技能自身不负责规划状态的持久化,而是作为 planning-with-files 之上的临时设计精修层运行:
- 保持边界清晰:要求
planning-with-files在当前入口同时激活,沿用它已选定的活动计划目录;只扩展task_plan.md、findings.md、progress.md三个文件。 - 以磁盘证据为准:先确认三个规划文件存在,完整读取并基于磁盘回答重启动问题;再检查仓库现状,摸清代码、测试、配置、文档与公开契约面,避免凭对话记忆做判断。
- 区分决策类型:把每个未决项分类为可调研事实、用户决策、推荐默认、实现自由裁量或超出范围;只询问会改变可观察行为、安全、数据持久性、兼容性或计划结构的问题。
- 即时回写并重建计划:每轮问答后更新阶段影响与决策 ID;随后细化受影响的阶段、依赖、公开契约、失败行为、默认值、迁移与恢复规则、测试和验收标准。
- 交接冻结:在通过
handoff-readiness.md的全部适用检查、阻塞决策均已确认或明确委托后,将阶段推进到implementation_ready并指明确切入口阶段,但不启动实现、也不标记整体任务完成。
适用边界
该技能只做只读的仓库检查与规划文件编辑,不会修改产品代码、配置、测试或生成产物;如果需要重开已冻结的契约,必须同时重新加载两个技能,把阶段退回 refining 并重置实现授权,相关历史以 superseded 标记保留。
使用场景
- 已有 planning-with-files 生成的计划草稿,但公开契约、失败行为和验收标准还模糊,需要把设计问题问清并冻结交接。
- 另一位 Implementer 即将接手编码,当前计划只列出阶段,未明确迁移规则、默认值和测试预期,需要补齐可执行细节。
- 仓库在实现过程中改动了接口或配置,原计划对应的事实已过时,需要基于磁盘证据重开受影响阶段。
- 已冻结的契约被新需求打破,需要安全回退到 refining 状态,保留 superseded 历史并更新验收标准。
适合人员
- 使用 planning-with-files 管理长期任务的开发者,需要在编码前把设计决策收敛为可执行的交接说明。
- 协调多位实现者接力交付的技术负责人,需要确保每次交接时契约、默认值和验收标准都已冻结。
- 参与规划但不直接写代码的架构或技术写作角色,需要在设计阶段把模糊问题转化为明确的决策记录。
- 在实现过程中发现计划与仓库现状不一致的工程师,需要基于磁盘证据重开受影响阶段而不是凭记忆修改。