sn-ppt-standard

1# sn-ppt-standard
2 
3把本文件当作**路线图**，不要当作需要一次背完的规范全集。只读取已准备任务的 Entry/Story 交接、该路径要求的 reference 和职责卡。
4 
5## Box-Agent 兼容入口
6 
7当当前 harness 暴露 `sub_agent`、`inspect_images`、`generate_image`、`bash` 等 Box-Agent 原生工具时，开始任何制作动作前必须完整读取 `references/box-agent-tool-contract.md`。该契约只覆盖工具名称、参数、脚本路径、委派方式和权限边界；本文件及各职责卡的事实、设计、质量和交付标准仍然有效。委派任何角色时，都要在 `task` 中显式要求其先读取同一契约与自己的 `subagents/<role>.md`。
8 
9## Hermes 环境等效工具
10 
11Hermes 不暴露 Box-Agent 工具名，但提供等价能力。在 Hermes 宿主中，正文下文中出现的
12`bash` / `inspect_images` / `generate_image` / `sub_agent` 调用一律按下表翻译后执行，
13且无须读取 `references/box-agent-tool-contract.md`（该契约仅用于 Box-Agent harness）：
14 
15| Box-Agent 写法（正文） | Hermes 等效工具 | 翻译要点 |
16| --- | --- | --- |
17| `bash(command, timeout)` | `terminal(command, timeout)` | 参数直接对应；Hermes 专属参数（workdir/pty）按需使用 |
18| `inspect_images(image_paths=[...], instruction=..., strategy="native")` | `vision_analyze(image_url=<单张路径>, question=<instruction>)` | 每张图一次调用；`strategy` 参数 Hermes 无，忽略 |
19| `generate_image(prompt, output_path, size, watermark=false)` | `image_generate(prompt, aspect_ratio=<按尺寸取>)` | 无 `output_path`，生成后回读返回路径验证落盘 |
20| `sub_agent(title, task, required_tools, write_scope, budget)` | `delegate_task(goal=<task>, context=<背景>)` | 用 Hermes 参数形态；自包含 task、语言合同、绝对路径与产物双读验证的要求不变 |
21 
22委派仍要求子任务自包含、携带语言合同与职责卡绝对路径，并用 `read_file` / `search_files`
23验证声明的产物；正文的阶段划分、质量标准与交付要求不因宿主变化而放宽。
24 
25## Entry / Story 输入契约（最高优先级）
26本 Skill 不接收裸 query，不自行创建任务目录。只接受绝对 `DECK_DIR`，且必须存在 `task_pack.json`、`info_pack.json` 和 `outline.md`。
27…