docs(constitution): 写入最优路径优先原则

- 为 Codex AGENTS live/template 增加 Coding 宪法\n- 为 Claude 模板与双端 go skill 同步最优路径优先\n- 收紧提问和 fallback 触发条件
2026-03-14 15:01:12 +08:00
parent e16da89569
commit e51f523b8e
7 changed files with 103 additions and 38 deletions
@@ -2,6 +2,15 @@

 把这个文件放在项目根目录，用来把已安装的 Codex skills 注册给 Codex。项目级约束可以追加在文末的 `Project notes` 一节。

+## Coding 宪法
+
+### 最优路径优先
+
+- 先基于当前目标、约束和上下文判断最优路径，再沿着这条路径推进。
+- 默认先收敛到一个最优方案，不先为了自我防御同时铺退路、保守版、兼容版或降级版。
+- 只有在最优路径被事实阻塞、风险或成本发生实质变化、或用户明确要求方案比较时，才展开 fallback 与备选方案。
+- 提问和澄清只用于解决会改变最优路径判断的问题，不能把提问当成免责动作。
+
 ## Skills

 ### Available skills
@@ -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 提交规则