summary
Installation
SKILL.md
summary
这个 skill 用来在需求、plan 和实现闭环后,把已经落地的业务行为沉淀到 docs/spec/。重点不是复述源码,而是帮助后续维护者理解最终规范:需求落成了什么行为、代码怎么支撑这个行为、改它会影响哪些契约,以及当前还有哪些真实边界。
适用场景
当用户要求根据某个需求、plan、diff、文件、tool、service、接口链路或模块实现生成 docs/spec/ 规范文档时,优先使用这个 skill。
当用户明确要求总结核心逻辑、详细代码逻辑、影响范围、当前边界、TODO 注释、文件名、方法名、行号,或把本轮实现沉淀到文档时,也使用这个 skill。
如果用户只是问一句代码做什么,可以直接简短回答,不需要生成完整规格文档。只有用户要求沉淀文档、写入 docs、生成总结、更新 spec、整理模块说明时,才进入完整流程。
非目标
这个 skill 只负责把已明确的需求、plan 和实现沉淀为规格文档,不负责顺手改业务代码,不负责重新设计方案,也不负责做完整 code review。
如果阅读过程中发现明显 bug、风险、实现与需求不一致、旧文档与当前实现冲突,需要在规格沉淀前客观指出。不要把不符合需求的实现强行写成新规范,也不要把规格文档写成问题清单或重构计划,除非用户明确要求。