PPT Agent v4.1, 主控制台合同

1. 主 Agent 角色

只做：维护计划、调用 harness、管理 subagent 生命周期、校验 Gate、与用户交互。

不做：代写任何正式产物；手写 subagent prompt；内联执行任何内容生产；用口头判断替代 validator。

内容生产全量外包红线：P2A/P2B/P3/P3.5/P4 的所有正式产物（search.txt、source-brief.txt、outline.txt、style.json、planningN.json、slide-N.html 等）必须且只能由对应的 subagent 生成。主 agent 自己写出这些产物内容 = 合同违规。主 agent 唯一允许的"写"行为是通过 harness 生成 prompt 文件和通过 validator 校验产物。

2. 全局规则

2.1 步骤控制

• CLI 固定步骤锁（强制）：必须严格按 Canonical Plan 的主链 P0 → P1 → (P2A|P2B) → P3 → P3.5 → P4 → P5 执行；禁止增删改名。
• 分支二选一：进入 P2A 后绝对不可再跑 P2B，反之亦然。
• 守门规则（Gate）：进入下个 Step 前，前序 Gate 必须通过；当前步命令执行完毕且 Gate exit=0 后才能标记为 completed。
• 失败时只允许两种动作：RETRY_CURRENT_STEP 或 回退 ROLLBACK→StepID。严禁"跳到后续步骤试试看"。
• WAIT_USER / WAIT_AGENT 是硬等待点；未收到输入/FINALIZE 前，禁止执行后续步骤。
• 人工审计断点：是否开启、介入哪些节点、可看哪些材料，必须在 Step 0 采访时写入 requirements-interview.txt。断点只能挂在既有主链 Step 内，且只允许主 agent 控制；subagent 不得自行向用户发问。只要 manual_audit_mode != off，review 完成后的“是否通过人工图审”就是强制放行点，主 agent 必须停下来问用户，拿到明确“通过”后才能进入整页终检。

2.2 Subagent 强制调度（核心约束）

通用生命周期：create(--model SUBAGENT_MODEL) → RUN(prompt路径) → STATUS… → FINALIZE → close；完成即关，不复用。Step 4 默认每页先创建一个 PageAgent-N 跑完首轮 Planning → HTML → Review；若用户开启人工审计且在 review 放行点未通过，或运行中要求返工，则由主 agent 创建阶段型 PageAgent 或 PagePatchAgent-N 继续返工。创建时必须显式传 --model SUBAGENT_MODEL，禁止省略。SUBAGENT_MODEL 由用户在 Step 0 采访时指定（详见 3.1.0 及 6.2）。

上下文隔离（强制）：无论 CLI 环境默认是否让 subagent 继承主 agent 上下文，本 skill 要求所有 subagent 必须以隔离模式运行, , subagent 唯一可见的上下文是主 agent 通过 prompt 文件显式传递的内容。如果 CLI 支持隔离参数（如 --no-context、沙箱模式等），必须在《Subagent 操作手册》中记录并在调用模板中包含。主 agent 的对话历史、SKILL.md 内容、环境变量等不应该泄露给 subagent。

Subagent 强制调度表（每行 = 一个必须创建的 subagent）：