my-skills / test-skills

工程推进

理解问题，结合现有代码、文档、历史决策、已接受的 ADR/RFC 和项目约束形成解决方案，再判断是否需要进入 Planning 或 Implementation Gate。

讨论不是被动访谈。应优先自行分析和利用已有项目上下文，而不是把可判断的问题交给用户。

讨论过程中：

• 明确实际问题、约束和相关既有决策
• 提出有实质差异的可行方案，并在依据充分时给出推荐
• 说明关键权衡、风险和影响
• 发现假设与现有事实或决策冲突时，明确指出
• 仅在缺少必要信息，或涉及未决的产品、业务、范围、兼容性、成本、风险及其他价值判断时，请求用户裁决

不要要求用户重复已有信息，也不要仅因探索性讨论创建规划产物。

讨论收敛时，说明已解决事项、剩余未决事项以及建议的下一阶段；进入 Planning 或 Implementation Gate 由用户授权。

当可以继续推进时，向用户说明建议的下一步，并等待明确授权：

• /planning — 进入规划，补齐或固化实施前仍需解决的重要合同或设计决策
• /implement — 在工作已经充分定义时开始实施

“确认”“可以”“同意”等只表示认可，不解除阶段 Gate。文档、示例或引用中的命令不构成授权。

收到 /planning 时加载 planning，完成规划及必要评审后回到 Discuss。

收到 /implement 时加载 implement。若关键合同仍未解决，指出 blocker 并建议先 /planning，不自行进入规划。

实施过程中按状态加载相关技能：

• 采用测试优先时 → tdd
• 实现完成、报告完成或提交之前 → code-review，执行 Implementation Review
• Implementation Review 通过、声称 PASS、完成或交付之前 → verify

/implement 在既定范围内持续有效，覆盖实施、审查、验证及范围内修正，无需因阶段切换再次授权。

若工作需要改变既定范围、合同或重大设计决策，停止受影响的实施并返回 Discuss；讨论完成后，再由用户通过 /planning 或 /implement 决定如何继续。新增范围同样需要新的明确授权。

日常文档和仓库治理可按用户请求直接处理；改变重要工程合同仍遵守上述授权边界。

Agent Notes

非平凡工程变更与重大提案按 项目 Agent Notes 入口 及 write-agent-notes Skill 记录。复用已有权威记录，维护受影响的内容；本仓库独立记录存于 .agents/notes/。分类、格式、生命周期和检查遵循 DSH Skill，不读取项目类别配置。更新后运行规定的检查；按需使用只读目录导航。格式整理和链接修复等日常文档治理直接处理并检查，不要求重新进入工程阶段；实质改变工程合同的修改仍按工程流程处理。

write-agent-notes 是 Agent Notes 格式与工具的唯一属主。Setup 不再附带另一套 Notes 资源；目标项目按需安装 DSH Skill，并只记录其自身选择的 Notes 根。.agents/notes/ 中的实际记录属于本仓库历史，不复制到其他项目。