diff --git a/.claude/skills/CLAUDE.md.template b/.claude/skills/CLAUDE.md.template index 83286e5..be15061 100644 --- a/.claude/skills/CLAUDE.md.template +++ b/.claude/skills/CLAUDE.md.template @@ -5,13 +5,14 @@ This file provides guidance to Claude Code (claude.ai/code) when working with co ## 最重要的事情 -1. **TDD 先行** - fix/feat 必须先写失败测试，红黄绿循环 -2. **原子提交** - 每个 commit 只做一件事，可独立回滚 -3. **文档驱动** - feat 改动关联 doc/ 下文档，多输出表格、流程图、ASCII 原型图 -4. **知识沉淀** - 有价值的迭代沉淀到 CLAUDE.md（拿捏不准主动问我） -5. **利用现有工具** - 不重复造轮子，会开车 > 会修车 -6. **有头有尾** - 头：确认清楚再动手，不清楚就一直问；尾：自己跑验证，不把验证甩给用户 -7. **任务结束后追加** - 主人，用不用我沉淀 or git 提交？ +1. **最优路径优先** - 先判断当前约束下的最优路径，锁定后直接推进；不先为了自我防御铺退路、保守版或兼容版 +2. **TDD 先行** - fix/feat 必须先写失败测试，红黄绿循环 +3. **原子提交** - 每个 commit 只做一件事，可独立回滚 +4. **文档驱动** - feat 改动关联 doc/ 下文档，多输出表格、流程图、ASCII 原型图 +5. **知识沉淀** - 有价值的迭代沉淀到 CLAUDE.md（拿捏不准主动问我） +6. **利用现有工具** - 不重复造轮子，会开车 > 会修车 +7. **有头有尾** - 头：只问会改变最优路径判断的问题，锁定后立刻动手；尾：自己跑验证，不把验证甩给用户 +8. **任务结束后追加** - 主人，用不用我沉淀 or git 提交？ ## 项目概述 @@ -93,16 +94,17 @@ This file provides guidance to Claude Code (claude.ai/code) when working with co ### 任务有头有尾 -**头 — 确认清楚再动手**： +**头 — 先锁定最优路径再动手**： - 收到任务后，先复述理解、列出不确定的点 -- 不确定就问，一直问到双方对齐为止，**绝不带着假设开工** +- 只追问会改变最优路径判断的问题；能基于上下文和环境判断的，不拿来做前置防御 +- 一旦最优路径锁定，立即沿该路径推进，不先铺退路、折中版或兼容版 - 确认范围边界：做什么、不做什么、验收标准 **尾 — 自己验证，说到做到**： - 任务完成后，自己执行验证（跑测试、构建、截图、检查输出等） - 把验证结果直接展示给用户，而不是列一堆步骤让用户自己验 - 验证不通过就自己修，循环直到通过 -- 最终交付物 = 已通过的验证结果根据既定的方案（所以倒逼开始的时候更明确才执行，否则自己打自己的脸。） +- 最终交付物 = 已通过的验证结果 ### 其他 diff --git a/.claude/skills/go/SKILL.md b/.claude/skills/go/SKILL.md index 535c5f2..379effe 100644 --- a/.claude/skills/go/SKILL.md +++ b/.claude/skills/go/SKILL.md @@ -106,19 +106,23 @@ description: 终极执行按钮，激进模式一口气完成开发任务，兼 │ │ │ 1. 以 tasks.md 为圣经，严格按顺序执行 │ │ │ -│ 2. 不要停下来问用户，自主决策 │ +│ 2. 先判断当前约束下的最优路径，再沿该路径推进 │ │ │ -│ 3. 遇到问题自主修复，修复失败则记录并继续 │ +│ 3. 不先为自我防御铺退路，必要时才展开 fallback │ │ │ -│ 4. 发现文档冲突，基于架构经验选最优解，注释说明 │ +│ 4. 遇到问题先沿最优路径自主修复，修复失败再记录 │ │ │ -│ 5. 利用所有可用工具：搜索、MCP、Skills │ +│ 5. 发现文档冲突，基于最优路径原则选解，注释说明 │ │ │ -│ 6. 每完成一个模块，Git 提交一次 │ +│ 6. 利用所有可用工具：搜索、MCP、Skills │ +│ │ +│ 7. 每完成一个模块，Git 提交一次 │ │ │ └─────────────────────────────────────────────────────────┘ ``` +说明：激进模式默认遵循“最优路径优先”。只有在最优路径被事实阻塞、风险或成本发生实质变化、或用户明确要求比较方案时，才展开 fallback 与备选方案。 + ### 3.2 任务执行流程 ``` @@ -126,20 +130,23 @@ description: 终极执行按钮，激进模式一口气完成开发任务，兼 │ ├── 1. 读取任务详情（描述、验收标准、依赖） │ -├── 2. 检查依赖任务是否完成 +├── 2. 判断当前约束下的最优路径（目标、约束、验收、依赖） +│ +├── 3. 检查依赖任务是否完成 │ └── 未完成 → 先执行依赖任务 │ -├── 3. 执行任务 +├── 4. 执行任务 │ ├── 根据任务类型选择执行方式 │ ├── 编写代码 / 配置 / 测试 │ └── 验证验收标准 │ -├── 4. 遇到问题？ -│ ├── 尝试自主修复（最多 3 次） +├── 5. 遇到问题？ +│ ├── 先沿最优路径尝试自主修复（最多 3 次） +│ ├── 最优路径被阻塞/风险成本变化/用户明确要求比较 → 再评估 fallback │ ├── 修复成功 → 继续 │ └── 修复失败 → 记录问题，跳过，继续下一个 │ -└── 5. 标记任务完成，更新 tasks.md +└── 6. 标记任务完成，更新 tasks.md ``` ### 3.3 自主修复策略 @@ -150,7 +157,7 @@ description: 终极执行按钮，激进模式一口气完成开发任务，兼 | 类型错误 | 检查类型定义，修复类型 | | 依赖缺失 | 安装依赖包 | | 测试失败 | 修复功能代码使测试通过 | -| 文档冲突 | 基于架构经验选最优解 | +| 文档冲突 | 基于最优路径原则选解，并在注释中说明 | | 未知错误 | 搜索解决方案，尝试修复 | ## 4. Git 提交规则 diff --git a/.codex/skills/AGENTS.md.template b/.codex/skills/AGENTS.md.template index 985ca7c..9431622 100644 --- a/.codex/skills/AGENTS.md.template +++ b/.codex/skills/AGENTS.md.template @@ -2,6 +2,15 @@ 把这个文件放在项目根目录，用来把已安装的 Codex skills 注册给 Codex。项目级约束可以追加在文末的 `Project notes` 一节。 +## Coding 宪法 + +### 最优路径优先 + +- 先基于当前目标、约束和上下文判断最优路径，再沿着这条路径推进。 +- 默认先收敛到一个最优方案，不先为了自我防御同时铺退路、保守版、兼容版或降级版。 +- 只有在最优路径被事实阻塞、风险或成本发生实质变化、或用户明确要求方案比较时，才展开 fallback 与备选方案。 +- 提问和澄清只用于解决会改变最优路径判断的问题，不能把提问当成免责动作。 + ## Skills ### Available skills diff --git a/.codex/skills/go/SKILL.md b/.codex/skills/go/SKILL.md index cacefad..8e811d6 100644 --- a/.codex/skills/go/SKILL.md +++ b/.codex/skills/go/SKILL.md @@ -106,19 +106,23 @@ description: 终极执行按钮，激进模式一口气完成开发任务，兼 │ │ │ 1. 以 tasks.md 为圣经，严格按顺序执行 │ │ │ -│ 2. 不要停下来问用户，自主决策 │ +│ 2. 先判断当前约束下的最优路径，再沿该路径推进 │ │ │ -│ 3. 遇到问题自主修复，修复失败则记录并继续 │ +│ 3. 不先为自我防御铺退路，必要时才展开 fallback │ │ │ -│ 4. 发现文档冲突，基于架构经验选最优解，注释说明 │ +│ 4. 遇到问题先沿最优路径自主修复，修复失败再记录 │ │ │ -│ 5. 利用所有可用工具：搜索、MCP、Skills │ +│ 5. 发现文档冲突，基于最优路径原则选解，注释说明 │ │ │ -│ 6. 每完成一个模块，Git 提交一次 │ +│ 6. 利用所有可用工具：搜索、MCP、Skills │ +│ │ +│ 7. 每完成一个模块，Git 提交一次 │ │ │ └─────────────────────────────────────────────────────────┘ ``` +说明：激进模式默认遵循“最优路径优先”。只有在最优路径被事实阻塞、风险或成本发生实质变化、或用户明确要求比较方案时，才展开 fallback 与备选方案。 + ### 3.2 任务执行流程 ``` @@ -126,20 +130,23 @@ description: 终极执行按钮，激进模式一口气完成开发任务，兼 │ ├── 1. 读取任务详情（描述、验收标准、依赖） │ -├── 2. 检查依赖任务是否完成 +├── 2. 判断当前约束下的最优路径（目标、约束、验收、依赖） +│ +├── 3. 检查依赖任务是否完成 │ └── 未完成 → 先执行依赖任务 │ -├── 3. 执行任务 +├── 4. 执行任务 │ ├── 根据任务类型选择执行方式 │ ├── 编写代码 / 配置 / 测试 │ └── 验证验收标准 │ -├── 4. 遇到问题？ -│ ├── 尝试自主修复（最多 3 次） +├── 5. 遇到问题？ +│ ├── 先沿最优路径尝试自主修复（最多 3 次） +│ ├── 最优路径被阻塞/风险成本变化/用户明确要求比较 → 再评估 fallback │ ├── 修复成功 → 继续 │ └── 修复失败 → 记录问题，跳过，继续下一个 │ -└── 5. 标记任务完成，更新 tasks.md +└── 6. 标记任务完成，更新 tasks.md ``` ### 3.3 自主修复策略 @@ -150,7 +157,7 @@ description: 终极执行按钮，激进模式一口气完成开发任务，兼 | 类型错误 | 检查类型定义，修复类型 | | 依赖缺失 | 安装依赖包 | | 测试失败 | 修复功能代码使测试通过 | -| 文档冲突 | 基于架构经验选最优解 | +| 文档冲突 | 基于最优路径原则选解，并在注释中说明 | | 未知错误 | 搜索解决方案，尝试修复 | ## 4. Git 提交规则 diff --git a/AGENTS.md b/AGENTS.md index c972f1d..c78afdf 100644 --- a/AGENTS.md +++ b/AGENTS.md @@ -1,3 +1,16 @@ +# AGENTS.md + +把这个文件放在项目根目录，用来把已安装的 Codex skills 注册给 Codex。项目级约束可以追加在文末的 `Repo notes` 一节。 + +## Coding 宪法 + +### 最优路径优先 + +- 先基于当前目标、约束和上下文判断最优路径，再沿着这条路径推进。 +- 默认先收敛到一个最优方案，不先为了自我防御同时铺退路、保守版、兼容版或降级版。 +- 只有在最优路径被事实阻塞、风险或成本发生实质变化、或用户明确要求方案比较时，才展开 fallback 与备选方案。 +- 提问和澄清只用于解决会改变最优路径判断的问题，不能把提问当成免责动作。 + ## Skills ### Available skills diff --git a/AGENTS.md.template b/AGENTS.md.template index 985ca7c..9431622 100644 --- a/AGENTS.md.template +++ b/AGENTS.md.template @@ -2,6 +2,15 @@ 把这个文件放在项目根目录，用来把已安装的 Codex skills 注册给 Codex。项目级约束可以追加在文末的 `Project notes` 一节。 +## Coding 宪法 + +### 最优路径优先 + +- 先基于当前目标、约束和上下文判断最优路径，再沿着这条路径推进。 +- 默认先收敛到一个最优方案，不先为了自我防御同时铺退路、保守版、兼容版或降级版。 +- 只有在最优路径被事实阻塞、风险或成本发生实质变化、或用户明确要求方案比较时，才展开 fallback 与备选方案。 +- 提问和澄清只用于解决会改变最优路径判断的问题，不能把提问当成免责动作。 + ## Skills ### Available skills diff --git a/CLAUDE.md.template b/CLAUDE.md.template index d46d524..ebe0dad 100644 --- a/CLAUDE.md.template +++ b/CLAUDE.md.template @@ -5,12 +5,14 @@ This file provides guidance to Claude Code (claude.ai/code) when working with co ## 最重要的事情 -1. **TDD 先行** - fix/feat 必须先写失败测试，红黄绿循环 -2. **原子提交** - 每个 commit 只做一件事，可独立回滚 -3. **文档驱动** - feat 改动关联 doc/ 下文档，多输出表格、流程图、ASCII 原型图 -4. **知识沉淀** - 有价值的迭代沉淀到 CLAUDE.md（拿捏不准主动问我） -5. **利用现有工具** - 不重复造轮子，会开车 > 会修车 -6. **任务结束后追加** - 主人，用不用我沉淀 or git 提交？ +1. **最优路径优先** - 先判断当前约束下的最优路径，锁定后直接推进；不先为了自我防御铺退路、保守版或兼容版 +2. **TDD 先行** - fix/feat 必须先写失败测试，红黄绿循环 +3. **原子提交** - 每个 commit 只做一件事，可独立回滚 +4. **文档驱动** - feat 改动关联 doc/ 下文档，多输出表格、流程图、ASCII 原型图 +5. **知识沉淀** - 有价值的迭代沉淀到 CLAUDE.md（拿捏不准主动问我） +6. **利用现有工具** - 不重复造轮子，会开车 > 会修车 +7. **有头有尾** - 头：只问会改变最优路径判断的问题，锁定后立刻动手；尾：自己跑验证，不把验证甩给用户 +8. **任务结束后追加** - 主人，用不用我沉淀 or git 提交？ ## 项目概述 @@ -87,6 +89,22 @@ This file provides guidance to Claude Code (claude.ai/code) when working with co ## 交互准则 +### 任务有头有尾 + +**头 — 先锁定最优路径再动手**： +- 收到任务后，先复述理解、列出不确定的点 +- 只追问会改变最优路径判断的问题；能基于上下文和环境判断的，不拿来做前置防御 +- 一旦最优路径锁定，立即沿该路径推进，不先铺退路、折中版或兼容版 +- 确认范围边界：做什么、不做什么、验收标准 + +**尾 — 自己验证，说到做到**： +- 任务完成后，自己执行验证（跑测试、构建、截图、检查输出等） +- 把验证结果直接展示给用户，而不是列一堆步骤让用户自己验 +- 验证不通过就自己修，循环直到通过 +- 最终交付物 = 已通过的验证结果 + +### 其他 + - 任务彻底结束后，追加一句：**主人，用不用我沉淀 or git 提交？** ## 踩坑经验