docs(constitution): 写入最优路径优先原则
- 为 Codex AGENTS live/template 增加 Coding 宪法\n- 为 Claude 模板与双端 go skill 同步最优路径优先\n- 收紧提问和 fallback 触发条件
This commit is contained in:
zfc
parent
e16da89569
commit
e51f523b8e
@ -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
|
||||
|
||||
### 任务有头有尾
|
||||
|
||||
**头 — 确认清楚再动手**：
|
||||
**头 — 先锁定最优路径再动手**：
|
||||
- 收到任务后，先复述理解、列出不确定的点
|
||||
- 不确定就问，一直问到双方对齐为止，**绝不带着假设开工**
|
||||
- 只追问会改变最优路径判断的问题；能基于上下文和环境判断的，不拿来做前置防御
|
||||
- 一旦最优路径锁定，立即沿该路径推进，不先铺退路、折中版或兼容版
|
||||
- 确认范围边界：做什么、不做什么、验收标准
|
||||
|
||||
**尾 — 自己验证，说到做到**：
|
||||
- 任务完成后，自己执行验证（跑测试、构建、截图、检查输出等）
|
||||
- 把验证结果直接展示给用户，而不是列一堆步骤让用户自己验
|
||||
- 验证不通过就自己修，循环直到通过
|
||||
- 最终交付物 = 已通过的验证结果根据既定的方案（所以倒逼开始的时候更明确才执行，否则自己打自己的脸。）
|
||||
- 最终交付物 = 已通过的验证结果
|
||||
|
||||
### 其他
|
||||
|
||||
|
||||
@ -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 提交规则
|
||||
|
||||
@ -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 提交规则
|
||||
|
||||
13
AGENTS.md
13
AGENTS.md
@ -1,3 +1,16 @@
|
||||
# AGENTS.md
|
||||
|
||||
把这个文件放在项目根目录，用来把已安装的 Codex skills 注册给 Codex。项目级约束可以追加在文末的 `Repo notes` 一节。
|
||||
|
||||
## Coding 宪法
|
||||
|
||||
### 最优路径优先
|
||||
|
||||
- 先基于当前目标、约束和上下文判断最优路径，再沿着这条路径推进。
|
||||
- 默认先收敛到一个最优方案，不先为了自我防御同时铺退路、保守版、兼容版或降级版。
|
||||
- 只有在最优路径被事实阻塞、风险或成本发生实质变化、或用户明确要求方案比较时，才展开 fallback 与备选方案。
|
||||
- 提问和澄清只用于解决会改变最优路径判断的问题，不能把提问当成免责动作。
|
||||
|
||||
## Skills
|
||||
|
||||
### Available skills
|
||||
|
||||
@ -2,6 +2,15 @@
|
||||
|
||||
把这个文件放在项目根目录，用来把已安装的 Codex skills 注册给 Codex。项目级约束可以追加在文末的 `Project notes` 一节。
|
||||
|
||||
## Coding 宪法
|
||||
|
||||
### 最优路径优先
|
||||
|
||||
- 先基于当前目标、约束和上下文判断最优路径，再沿着这条路径推进。
|
||||
- 默认先收敛到一个最优方案，不先为了自我防御同时铺退路、保守版、兼容版或降级版。
|
||||
- 只有在最优路径被事实阻塞、风险或成本发生实质变化、或用户明确要求方案比较时，才展开 fallback 与备选方案。
|
||||
- 提问和澄清只用于解决会改变最优路径判断的问题，不能把提问当成免责动作。
|
||||
|
||||
## Skills
|
||||
|
||||
### Available skills
|
||||
|
||||
@ -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 提交？**
|
||||
|
||||
## 踩坑经验
|
||||
|
||||
Loading…
x
Reference in New Issue
Block a user