docs: 整个系统不设默认值
用户 2026-10-02:"全部都不要默认值更好,甚至整个系统都不要默认值,因为默认值可能会掩盖错误";"在 CLAUDE.md'写代码的标准'里加一条可以,其他文档也要修改"。 CLAUDE.md 新增"不设默认值"一节,事实来源表与角色模型一句同步;方法.md 开头说明、6.11 末句、开发入口改为配置必须写明;结构.md config 一行和可替换点"方法参数"一行同步。 Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
This commit is contained in:
@@ -10,7 +10,7 @@
|
||||
|---|---|
|
||||
| 研究方法:流程、公式、信念本、记账含义 | `docs/方法.md` |
|
||||
| 代码结构与各模块的预期规模 | `docs/结构.md` |
|
||||
| 配置字段与默认值 | 配置的类型定义和校验代码;文档只解释含义,不抄数值 |
|
||||
| 配置字段 | 配置的类型定义和校验代码;文档只解释含义,不抄数值 |
|
||||
| 当前进度、下一步、运行中的任务 | `WORK_LOG.md` |
|
||||
| 同类系统和书籍的调研 | `docs/调研/` |
|
||||
| Pi 的接口与行为 | 本机安装的包、它的文档和实测 |
|
||||
@@ -62,6 +62,10 @@
|
||||
|
||||
以下不防:用户本人中途改配置、改提示词、同时开两个进程、随时终止;有人在同一账号下故意用 shell 绕开规则;出错后马上就能看出来的问题。
|
||||
|
||||
### 不设默认值
|
||||
|
||||
配置的每个字段都必填,函数参数不写默认值;可以没有的值写 null,不靠省略。缺了就报错,不替人补。默认值会掩盖错误:字段名拼错、文档改了代码没跟上,研究照样跑完,没人发现用的是哪个值。方法.md 6.11 标"固定"的常数是方法本身的一部分,不算默认值。
|
||||
|
||||
### 错误怎么处理
|
||||
|
||||
- **外部错误**,比如模型接口超时、网络断开、子进程被系统杀掉:只在调用外部服务的那一处做有限次重试,仍然失败就把这一步记为失败,写明状态。
|
||||
@@ -127,7 +131,7 @@
|
||||
|
||||
- 研究者、实验员、核验员都用 Pi 子会话、Pi 工具和 Pi 的模型服务配置,不自己写直接调用模型接口的 Agent。
|
||||
- Pi 固定用本机的 `@earendil-works/pi-coding-agent` 0.85.1,Node ≥ 22.19。只照这个版本的包和文档写代码,不升级全局 Pi。
|
||||
- 角色模型默认 glm-5.3。
|
||||
- 角色模型用 glm-5.3,在配置里写明。
|
||||
- 每个角色有一份自己的角色提示词,同一角色的所有任务共用;每类任务另有一份任务消息,写目标、要求和要交什么。
|
||||
- 实验员有完整的文件和 shell 权限,因为它的工作就是写代码、跑代码。研究者和核验员只有只读工具和提交工具。这是分工,不是安全边界。
|
||||
- 提示词只引导模型怎么想,不设必填栏目。逼模型填栏目,它会为了填而编。只有程序确实要读取的值,才做成提交字段。
|
||||
|
||||
Reference in New Issue
Block a user