## 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)**:从冒烟测试到治理测试的标准化测试库。