2.6 KiB
2.6 KiB
Agentic Engineering Handbook (V1.0 Draft)
0. 守则定位与绝对边界
- 守则效力：低于 HiFi Agent Studio 纲领，高于具体项目 Runbook。
- 反向兜底：遇到具体平台（如 Codex、Claude Code）特性与本守则冲突时，必须暂停执行并向上请求架构裁决。
1. 任务入口与档位挂载 (Project Intake & Mode Selector)
- QPI 强制分诊：判定当前需求为 Q（查询）、P（路径求解）、还是 I（秩序治理）。
- 性质定性：划定本次作业为一次性内容提取、可复用能力沉淀，还是治理级系统建设。
- Lite 档（默认启动）：单模型闭环，用于低风险处理。
- Standard 档（证据驱动升级）：应对多源交叉，需局部追溯。
- Full 档（极限治理）：应对高法理风险，需多角色独立裁决与全量审计。
2. 资产隔离与防蔓延机制 (Cost Ledger & Scope Drift)
- 四重消耗账本：独立核算 Content Cost（内容产出）、System-Building Cost（系统建设）、Calibration Cost（校准修复）与 Exploration Cost（探索预演）。
- 漂移探测触发：监控一次性任务试图构建复用目录、成本暴增或中间态文档异常堆积等越界信号。
- 漂移处置协议：强制挂起当前进程，重新进行 QPI 定性并分拆成本账本。
3. 物理防伪与绝对制动 (Execution Authenticity & Stop Rule)
- 真实调用证据：正式产物必须绑定 Canonical Prompt、Thread ID、Input Context 与 Returned Output。
- 主控阻断纪律：严禁主会话（Main Session）模拟子节点或评审员输出。
- 模拟标记隔离：对无真实物理咬合的产物强制打上
simulation-only烙印，禁止流入正式合成（Synthesis）链。 - 停止前置设定：任务启动前必须清晰定义“最小可用产物”与“充分（Sufficient）条件”。
- 熔断执行机制：触及降熵阈值即锁死进程，拦截一切非必要中间态生成的无序扩展，并进入人类等待点。
4. 高阶扩展与资产池 (Expansion Materials)
- 权力矩阵 (Authority Matrix)：A0至A6级别的读写、执行与裁决权限标定。
- 产物合约 (Artifact Contract)：定义物料从草稿到生产可执行状态的硬性校验条件。
- 成熟度模型 (Runtime Maturity Model)：系统从 M0（概念态）至 M6（治理态）的阶段划分标准。
- 上下文编译 (Context Compiler)：原始材料转译与全局结构扫描的工程规范。
- 分层评测 (Evaluation Stack)：从冒烟测试到治理测试的标准化测试库。