CLI 与 TUI 开发 SOP
前置条件
先阅读 模块说明,确认业务负责人、输入输出、失败条件和权限边界。
执行步骤
- 用 create 生成或接入项目。
- 用 doctor 检查本地环境。
- 用 run 或 chat 开发。
- 用 check 与 eval 验收。
- 人工阅读使用 TUI;文本管道使用
--print;自动化消费使用--json-events,两种参数不得同时传入。 - 自动化必须同时检查退出码和最后一条
run_result,并把 stderr 作为诊断保存。 - 分别注入权限拒绝、预算耗尽、超时与中止,验证
2/3/124/130。 - 对显式 Loop 注入验证失败、暂停恢复和耗尽;比较 TUI、readline 和 JSONL 的状态顺序。
- 确认恢复没有重复完整步骤或 committed 副作用,unknown 副作用会要求人工核对。
- 对比 TUI
/status、/artifacts、/context与最后一条 JSONLsnapshot,字段与真实文件状态必须一致。 - 运行模块列出的测试,并执行
npm run check:modules。 - 保存 Trace、评测和人工确认记录;未经明确授权不发布。
停止条件
遇到未确认业务规则、不可逆副作用、工作区外访问、真实密钥缺失或安全门禁失败时停止,向负责人请求决定。不要自行扩大业务范围。