プロトタイプ · プレビュー版:公式レジストリのすべてのサーバーを掲載し、30分ごとに同期しています。Google でログインするとレビューを書けます。プロトタイプ · 30分ごとに更新
PopNx MCPAIを使う人のためのMCPサーバー · やさしい言葉で解説

ppt-agent-skills Skill

リポジトリ ↗

作者:sunbigfly★ 9251 個の skill

インストール

What it does

A code-driven presentation generation framework. 像构建软件工程一样生成演示文稿。

  • Connects Instruction files the AI reads
  • Account or key No key found in README or SKILL.md
  • Category デザインと Web
作者向け:README にバッジを付ける

作者の方は、このコードを README に貼れます。バッジはこのページにリンクします。

[![Featured on PopNx MCP](https://mcp.popnx.com/badge/skill/sunbigfly-ppt-agent-skills.svg)](https://mcp.popnx.com/en/skills/sunbigfly-ppt-agent-skills)

一緒に使える

同じ作業で AI をサービスにつなぐ MCP

Pascal 3D Editor

Create, inspect, validate, and save editable 3D building scenes with Pascal's MCP server.

作者:pascalorg広く使われている↓ 1037/週★ 2.6万 リポジトリ全体のスター今日更新

MCP · サービスにつなぐパソコンでもクラウドでも✓ 提供元 · pascal.app

Semiotic

Verified React chart generation: select, validate, repair, render, and inspect charts through MCP.

作者:nteract広く使われている↓ 8456/週★ 271719 日前更新

MCP · サービスにつなぐパソコンでもクラウドでも

似た Skill

同じ種類の作業。Skill 一覧と同じ並び

似たものと比べる
これ
ppt-agent-skills
impeccablediagram-designfrontend-slidesguizang-ppt-skill
作者sunbigflypbakauscathrynlaveryzarazhangruiop7418
Skill 数11111
GitHub スター925112,54468,06932,51430,030
最終コード更新2026年6月8日2026年11月18日2026年11月13日2026年6月24日2026年10月30日
ライセンス–Apache-2.0MITMITAGPL-3.0

sunbigfly による 1 個の Skill(指示セット)。AI が読んでそのとおりに作業します · MCP server ではありません

Skill と MCP の違い

MCP = 手

AI を外部のサービスやデータにつなぎます(例:Notion を読む、請求書を作る)。プログラムやサーバーが動いている必要があります。

Skill = 手順書

作業のやり方を AI に教えるテキストファイル。どのサービスにもつながりません。

重なる部分もあります。ツールを呼ぶスクリプト付きの Skill や、知識だけを渡す MCP もあります。やりたい作業から選んでください。

使えるアプリ

提供元の記載なし · SKILL.md 形式の Skill は Claude Code、Codex、Cursor など Agent Skills 対応アプリで使えます

インストール

Is it safe?

  • Who made it

    GitHub account sunbigfly (person), 6 years old

  • Use and upkeep

    ★ 925 stars · code last changed 2026年6月8日

  • Any scripts?

    15 scripts that can run on a computer: scripts/check_skill.py, scripts/contract_validator.py, scripts/html2png.py, scripts/html2svg.py and 11 more

  • Uses the internet?

    No internet calls found in the scripts

  • Changes machine-wide settings?

    No hooks or writes to machine settings found

Checked automatically from the repo files at commit 13e3537 (read only, nothing was run). Not a safety guarantee: read it and decide for yourself

まず:どの AI を使っていますか

使っているアプリを選ぶと、そのアプリでのインストール方法だけが表示されます

Option 1Upload to claude.ai (web and app)

  1. Download from GitHub

    This skill has no license, so we do not hand out a ZIP from our site. Download it from GitHub and arrange the folder yourself, or use "Let the AI install it" above, which is easier

    Download from GitHub (whole repo) ↗

    Unzip it, then zip only the ppt-agent-skills folder again. The ZIP must have a ppt-agent folder with SKILL.md at the top level, no loose files

  2. Open Skills on claude.ai and upload

    +Create skillUpload a skillpick ppt-agent.zip

    Open claude.ai/customize/skills ↗

  3. No Upload button? Turn on file creation first

    SettingsCapabilitiesCode execution and file creation

    Turn on Code execution and file creation first (newer menus: Create and edit files) · personal plans: Settings → Capabilities · Team/Enterprise: an admin turns it on under Organization settings → Plugins & skills · every plan, including Free

Upload once; it works in claude.ai and Claude Desktop, and in recent Claude Code signed in with a Claude account (not with an API key)

Cowork and cloud sessions use the skills turned on in your claude.ai account, not ~/.claude/skills on your computer (Claude Desktop scheduled tasks run locally and still load it)

Checked against official docs 2026年11月12日 · Source: support.claude.com, support.claude.com, code.claude.com

Option 1Claude Code にインストールしてもらう

この文をコピーして Claude Code のチャットに貼り付けます

Where to install
Please install the skill ppt-agent from https://github.com/sunbigfly/ppt-agent-skills (commit 13e3537) for all my projects, at ~/.claude/skills/ppt-agent. First show me every file and tell me whether it has scripts or changes machine settings, then tell me the full path you will install to and wait for me to agree.
Please install the skill ppt-agent from https://github.com/sunbigfly/ppt-agent-skills (commit 13e3537) into the project this chat is open in (at .claude/skills/ppt-agent). First show me every file and tell me whether it has scripts or changes machine settings, then tell me the project name and the full path you will install to and wait for me to agree.

For one project, paste it into a chat that is open in that project’s folder · The AI always shows you the path before installing

The AI tells you what it will do first and asks your permission at every step

Claude Code を開き直し、/ppt-agent-skills と入力するか関連する作業を頼むと Claude が自動で使います

Checked against official docs 2026年11月12日 · Source: code.claude.com

For Terminal users

Skill は AI が従う指示です。入れる前にファイルを読み、信頼できる提供元のものだけを入れてください。

提供元のおすすめの方法

Node.js を入れる(まだなければ)

もう入っていますか?先に確認 · ターミナルを開き、このコマンドを入力して Enter

node -v
  • バージョン番号(例 v26.13.1)が出る = 入っています。この手順は飛ばせます
  • "command not found"(Windows では "is not recognized")が出る = まだ入っていないか、入れた直後でターミナルを開き直す必要があります
ターミナルの開き方

Mac:⌘ + Space を押し、Terminal と入力して Enter

Windows:スタートメニューを開き、Windows PowerShell と入力して「開く」

まだ入っていない場合: 公式ダウンロードページで LTS 版と、クリックで進むインストーラーを選びます:Mac は .pkg、Windows は .msi。ダブルクリックして最後まで進めるだけで、curl コマンドは不要です

Node.js のダウンロードページを開く ↗

入れ終わったらターミナルを閉じて開き直し、同じコマンドをもう一度実行します。バージョン番号が出れば完了です: node -v

一度入れれば、Node.js を使うすべてのツールで使えます

npx skills add sunbigfly/ppt-agent-skills

提供元の README から引用。提供元のコードをダウンロードして実行します

  1. ターミナルを開く

    Mac:Command+スペースで Terminal と入力 · Windows:下のコマンドは PowerShell では動きません。上の「AI にインストールしてもらう」を使ってください

  2. skill フォルダを ~/.claude/skills にコピー

    repo を一時フォルダにダウンロードし、SKILL.md のあるフォルダだけをコピーします

    git clone --depth 1 https://github.com/sunbigfly/ppt-agent-skills.git /tmp/popnx-skill-sunbigfly-ppt-agent-skills-13e3537 && mkdir -p ~/.claude/skills && cp -R '/tmp/popnx-skill-sunbigfly-ppt-agent-skills-13e3537/.' ~/.claude/skills/ppt-agent-skills
  3. Claude Code を開き直し、/ppt-agent-skills と入力するか関連する作業を頼むと Claude が自動で使います

自分でインストールした Skill は ChatGPT デスクトップアプリ、Codex CLI、IDE の Codex 拡張機能で使えます · Web 版とモバイル版の ChatGPT では自分でインストールした Skill は使えず、ディレクトリのプラグインに含まれる Skill だけが使えます

ChatGPT デスクトップアプリ

ChatGPT デスクトップアプリには Codex が組み込まれていて、Codex は ~/.agents/skills フォルダから Skill を読み込みます

Option 1ChatGPT にインストールしてもらう

ChatGPT デスクトップアプリで Codex を開き、この文をチャットに貼り付けます

Where to install
Please install the skill ppt-agent from https://github.com/sunbigfly/ppt-agent-skills (commit 13e3537) for all my projects, at ~/.agents/skills/ppt-agent. First show me every file and tell me whether it has scripts or changes machine settings, then tell me the full path you will install to and wait for me to agree.
Please install the skill ppt-agent from https://github.com/sunbigfly/ppt-agent-skills (commit 13e3537) into the project this chat is open in (at .agents/skills/ppt-agent). First show me every file and tell me whether it has scripts or changes machine settings, then tell me the project name and the full path you will install to and wait for me to agree.

The AI always shows you the path before installing

The AI tells you what it will do first and asks your permission at every step

Option 2自分でフォルダを置く

ppt-agent フォルダを ~/.agents/skills/ppt-agent に置きます

~ はホームフォルダ($HOME)です

For Terminal users

Skill は AI が従う指示です。入れる前にファイルを読み、信頼できる提供元のものだけを入れてください。

  1. ターミナルを開く

    Mac:Command+スペースで Terminal と入力 · Windows:下のコマンドは PowerShell では動きません。上の「AI にインストールしてもらう」を使ってください

  2. skill フォルダを ~/.agents/skills にコピー

    repo を一時フォルダにダウンロードし、SKILL.md のあるフォルダだけをコピーします

    git clone --depth 1 https://github.com/sunbigfly/ppt-agent-skills.git /tmp/popnx-skill-sunbigfly-ppt-agent-skills-13e3537 && mkdir -p ~/.agents/skills && cp -R '/tmp/popnx-skill-sunbigfly-ppt-agent-skills-13e3537/.' ~/.agents/skills/ppt-agent-skills

インストールしたあと

  • ChatGPT デスクトップアプリ:サイドバーの Skills を開いて Skill があるか確認します
  • 使い方:ChatGPT では @ を入力して Skill を選びます · Codex CLI や IDE 拡張機能では /skills を実行するか、$ に続けて Skill 名を入力します
  • Codex は新しくインストールした Skill を自動で見つけます。表示されない場合は Codex を再起動してください

Checked against official docs 2026年11月15日 · Source: learn.chatgpt.com

Web 版とモバイル版の ChatGPT

自分でインストールした Skill は使えません。ディレクトリのプラグインに含まれる Skill だけが使えます

この Skill を ChatGPT で使うには、上の方法で ChatGPT デスクトップアプリを使ってください

Checked against official docs 2026年11月15日 · Source: learn.chatgpt.com

Option 1Codex にインストールしてもらう

この文をコピーして Codex のチャットに貼り付けます · ChatGPT デスクトップアプリ内の Codex、Codex CLI、IDE 拡張機能で使えます

Where to install
Please install the skill ppt-agent from https://github.com/sunbigfly/ppt-agent-skills (commit 13e3537) for all my projects, at ~/.agents/skills/ppt-agent. First show me every file and tell me whether it has scripts or changes machine settings, then tell me the full path you will install to and wait for me to agree.
Please install the skill ppt-agent from https://github.com/sunbigfly/ppt-agent-skills (commit 13e3537) into the project this chat is open in (at .agents/skills/ppt-agent). First show me every file and tell me whether it has scripts or changes machine settings, then tell me the project name and the full path you will install to and wait for me to agree.

For one project, paste it into a chat that is open in that project’s folder · The AI always shows you the path before installing

The AI tells you what it will do first and asks your permission at every step

Codex は新しくインストールした Skill を自動で見つけます。表示されない場合は Codex を再起動してください · 使い方:ChatGPT では @ を入力して Skill を選びます · Codex CLI や IDE 拡張機能では /skills を実行するか、$ に続けて Skill 名を入力します

Checked against official docs 2026年11月15日 · Source: learn.chatgpt.com

For Terminal users

Skill は AI が従う指示です。入れる前にファイルを読み、信頼できる提供元のものだけを入れてください。

  1. ターミナルを開く

    Mac:Command+スペースで Terminal と入力 · Windows:下のコマンドは PowerShell では動きません。上の「AI にインストールしてもらう」を使ってください

  2. skill フォルダを ~/.agents/skills にコピー

    repo を一時フォルダにダウンロードし、SKILL.md のあるフォルダだけをコピーします

    git clone --depth 1 https://github.com/sunbigfly/ppt-agent-skills.git /tmp/popnx-skill-sunbigfly-ppt-agent-skills-13e3537 && mkdir -p ~/.agents/skills && cp -R '/tmp/popnx-skill-sunbigfly-ppt-agent-skills-13e3537/.' ~/.agents/skills/ppt-agent-skills
  3. Codex を開き直して関連する作業を頼むと、Codex が skill を一覧に出します

Option 1Cursor にインストールしてもらう

この文をコピーして Cursor のチャットに貼り付けます

Where to install
Please install the skill ppt-agent from https://github.com/sunbigfly/ppt-agent-skills (commit 13e3537) for all my projects, at ~/.cursor/skills/ppt-agent. First show me every file and tell me whether it has scripts or changes machine settings, then tell me the full path you will install to and wait for me to agree.
Please install the skill ppt-agent from https://github.com/sunbigfly/ppt-agent-skills (commit 13e3537) into the project this chat is open in (at .cursor/skills/ppt-agent). First show me every file and tell me whether it has scripts or changes machine settings, then tell me the project name and the full path you will install to and wait for me to agree.

For one project, paste it into a chat that is open in that project’s folder · The AI always shows you the path before installing

The AI tells you what it will do first and asks your permission at every step

Cursor の Agent チャットで / を入力し ppt-agent-skills を選ぶ

Checked against official docs 2026年11月12日 · Source: cursor.com

For Terminal users

Skill は AI が従う指示です。入れる前にファイルを読み、信頼できる提供元のものだけを入れてください。

  1. ターミナルを開く

    Mac:Command+スペースで Terminal と入力 · Windows:下のコマンドは PowerShell では動きません。上の「AI にインストールしてもらう」を使ってください

  2. skill フォルダを ~/.cursor/skills にコピー

    repo を一時フォルダにダウンロードし、SKILL.md のあるフォルダだけをコピーします

    git clone --depth 1 https://github.com/sunbigfly/ppt-agent-skills.git /tmp/popnx-skill-sunbigfly-ppt-agent-skills-13e3537 && mkdir -p ~/.cursor/skills && cp -R '/tmp/popnx-skill-sunbigfly-ppt-agent-skills-13e3537/.' ~/.cursor/skills/ppt-agent-skills
  3. Cursor の Agent チャットで / を入力し ppt-agent-skills を選ぶ

Option 1Let the AI install it

Skill を読めるほかのアプリ向けです。この文には Claude Code、Codex、Cursor のパスが入っていて、AI が使っているアプリに合わせて選びます · Copy this sentence into the app’s chat

Where to install
Please install the skill ppt-agent from https://github.com/sunbigfly/ppt-agent-skills (commit 13e3537) for all my projects, at ~/.claude/skills/ppt-agent (in Codex use ~/.agents/skills/ppt-agent, in Cursor ~/.cursor/skills/ppt-agent). First show me every file and tell me whether it has scripts or changes machine settings, then tell me the full path you will install to and wait for me to agree.
Please install the skill ppt-agent from https://github.com/sunbigfly/ppt-agent-skills (commit 13e3537) into the project this chat is open in (at .claude/skills/ppt-agent; in Codex use .agents/skills/ppt-agent, in Cursor .cursor/skills/ppt-agent). First show me every file and tell me whether it has scripts or changes machine settings, then tell me the project name and the full path you will install to and wait for me to agree.

For one project, paste it into a chat that is open in that project’s folder · The AI always shows you the path before installing

The AI tells you what it will do first and asks your permission at every step

Checked against official docs 2026年11月12日 · Source: code.claude.com, learn.chatgpt.com, cursor.com

For Terminal users

Gemini CLI や GitHub Copilot など Agent Skills 対応の他のアプリはフォルダが違います。そのアプリのガイドを見て、SKILL.md のあるフォルダをコピーしてください。

GitHub で見る ↗

2026年11月11日 に Claude Code、Codex、Cursor の公式ガイドで skill フォルダを確認

✓ コマンド確認済み 2026年11月18日

元の SKILL.md を見る

以下は提供元の repo の文章で、PopNx MCP の指示ではありません

最初の 8,000 文字を表示 · GitHub で全文を開く

---
name: ppt-agent
description: 专业 PPT 演示文稿全流程 AI 生成助手。模拟顶级 PPT 设计公司的完整工作流(需求调研到资料搜集到大纲策划到策划稿到设计稿),输出高质量 HTML 格式演示文稿。当用户提到制作 PPT、做演示文稿、做 slides、做幻灯片、做汇报材料、做培训课件、做路演 deck、做产品介绍页面时触发此技能。即使用户只说"帮我做个关于 X 的介绍"或"我要给老板汇报 Y",只要暗示需要结构化的多页演示内容,都应该触发。也适用于用户说"帮我把这篇文档做成 PPT"、"把这个主题做成演示"等需要将内容转化为演示格式的场景。英文场景同样适用:"make a presentation about..."、"create slides for..."、"build a pitch deck"、"I need a keynote for..."。隐式意图也应触发:"帮我把这个数据可视化一下给老板看"、"我需要一份能拿去路演的东西"、"把这个报告做得好看点能展示"、"beautify my existing PPT"、"redesign these slides"。改善或美化现有 PPT 也属于此技能范畴。
---

# 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)**:

| Step | Subagent 类型 | 职责 | 产物 | 主 agent 行为边界 |
|------|--------------|------|------|------------------|
| P2A | ResearchSynth | 联网检索 + 素材整理 | search.txt, search-brief.txt | 仅 harness 生成 prompt → 创建 subagent → 回收校验 |
| P2B | SourceSynth | 用户资料降维整合 | source-brief.txt | 同上 |
| P3 | Outline | 大纲构建(含内部自审闭环) | outline.txt | 同上,禁止介入 subagent 内部自审 |
| P3.5 | Style | 全局风格锁定 | style.json | 同上 |
| P4 | PageAgent-N(每页一个) | 页面规划 + HTML + 审查 | planningN.json, slide-N.html, slide-N.png | 同上,orchestrator 渐进式编排三阶段 |

**红线**:
- 上表中每个 Step 的产物**只允许对应 subagent 生成**,主 agent 内联生产任何产物 = 合同违规
- 即使 subagent 失败,主 agent 也只能重建 subagent 重跑,不能自己"补写"产物
- 图片模式 `generate` 且用户需要文生图时,额外创建 `ImageGen` 子代理;PageAgent 不承担文生图
- 若用户在人工审计断点提出改单,尤其是在 `review` 后强制放行点给出“不通过”,主 agent 也**必须**通过阶段型 PageAgent 或 `PagePatchAgent-N` 返工;默认从 `review` 重开,让 subagent 继续图审 + HTML 修复;严禁主 agent 直接手改正式产物

**自适应调用协议(每个业务节点强制执行)**:

主 agent 到达上表任意 Step 时,必须按以下流程显式组装 subagent 调用命令:
1. **回查** Section 3.1.1 输出的《Subagent 操作手册》,取出其中的**调用模板**(模型槽位使用 `SUBAGENT_MODEL`)
2. **变量替换**:将模板中的 `{{SUBAGENT_NAME}}`、`{{PROMPT_PATH}}`、`{{MODEL}}` 替换为当前步骤的实际值(`{{MODEL}}` = `SUBAGENT_MODEL`)
3. **显式输出**:将组装后的完整命令输出到对话中(不是脑内执行,是显式写出来)
4. **执行**:按输出的命令执行 subagent 创建、RUN、轮询、回收

禁止“依据操作手册创建”这种含糊引用;必须显式展示组装结果。

### 2.3 Prompt 生成

- 所有 subagent prompt 必须通过 `prompt_harness.py` 从模板生成;禁止手写
- 所有 `{{VAR}}` 必须填充,残留即 ERROR;输出固定落 `OUTPUT_DIR/runtime/`
- 模板/playbook 仅通过 `--inject-file` 注入;主 agent 不手动预读正文
- **Step 0 默认强制模板化**:主 agent 必须先通过 `prompt_harness.py` 生成 `OUTPUT_DIR/runtime/prompt-interview.md`,再依据渲染结果向用户发问;采访运行时模板必须按能力在 `tpl-interview-structured-ui.md` 与 `tpl-interview-text-fallback.md` 之间二选一,不得退化成随手写的一小段简陋问题。
- **Step 0 优先结构化采访 UI**:只要当前 CLI 提供任何等价于 `AskUserQuestion` / `request_user_input` 的原生提问能力,主 agent 就必须优先使用;能力判断看是否支持 `question/header/id/options` 等结构化提问对象,而不是看固定工具名。
- **Step 0 文本回退也必须结构化**:若当前 CLI 不支持结构化采访 UI,主 agent 必须回退为分组明确的 Markdown 采访单;不得退化成一行填空或散乱问题串。
- **Step 0 唯一例外**:仅当 `prompt_harness.py` 在 Step 0 发生真实脚本接口故障,并已判定 `BLOCKED_SCRIPT_INTERFACE` 时,才允许主 agent 直接发问;但覆盖维度不得低于 `tpl-interview.md` 的最终要求。

### 2.4 通信协议

| 指令 | 方向 | 内容 |
|------|------|------|
| **RUN** | 主→子 | prompt 文件路径(一行,不发正文)|
| **STATUS** | 子→主 | 进度、阻塞项、下一动作 |
| **FINALIZE** | 子→主 | 完成信号 + 产物路径列表 |

仅里程碑通信;任何修复直接改文件并回传路径。

**多阶段 orchestrator 补充协议**:对于 `phase1 → phase2 [→ phase3]` 的渐进式子代理,**非末阶段只允许输出** `--- STAGE n COMPLETE: {artifact_path} ---` 作为阶段完成标记;**只有最后阶段才允许发送 FINALIZE**。

### 2.5 校验双保险

subagent FINALIZE 前自审;主 agent 回收后再跑同一 validator 复检。自审通过不等于主链放行。

### 2.6 执行纪律

- **执行优先策略**:到达某一步后,直接执行该步的 harness/CLI 命令,不要擅自做无关探索。
- **采访前置锁定**:完成 3.1 环境感知、`update_plan` 与 `cli-cheatsheet` 读取后,第一条**面向用户的业务交互**必须是 Step 0 的采访问题;允许把 `## 模型感知结果` / `## Subagent 操作手册` / `## 采访 UI 能力` 压缩为同一条消息里的前置状态块,但**不得先做调研、资料探索或报告读取**。
- **阅读隔离边界**:未到对应步骤时禁止读对应阶段文件;主 agent **可读内容仅限**:`OUTPUT_DIR/**`、用户输入资料、以及 `cli-cheatsheet.md`。
- **把脚本当做黑盒工具**:`scripts/*.py` 是执行对象,不是阅读对象!**仅允许 `python3 ...` 执行**;严禁对脚本跑 `--help` 摸索参数,严禁 `cat` 脚本源码!所需的参数全都在 `cli-cheatsheet.md` 里面。
- 如果命令失败:首先对照 cheatsheet 核对参数形式;解决不了则立刻标记 `BLOCKED_SCRIPT_INTERFACE` 并呼叫用户裁决。
- **汇报纪律**:只汇报"目标动作、执行结果、Gate反馈";严禁长篇大论的 "Explored files..." 预读清单。

### 2.7 资源双层消费

资源文件结构:`# 标题` + `> 一句话定位(引用层)` + 正文层。消费规则:

- planning 阶段:`resource_loader.py menu` 加载标题+引用层组成菜单
- planning 阶段主链需先把 menu 结果落一份 `runtime/page-planning-menu-N.md` 备份,再让 PageAgent 读取这份快照
- html 阶段:`resource_loader.py resolve` 按 planning JSON 字段动态加载正文层
- 字段路由:`layout_hint→layouts/`、`page_type→page-templates/`、`card_type→blocks/`、`chart_type→charts/`

命令见 cheatsheet 资源路由节。

## 3. 环境、路径与产物合同

### 3.1 环境感知(至关重要,Step 0 前强制完成)

进入任何业务步骤前,主 agent 必须按照以下顺序执行环境感知,并将结果**显式分类记录到对话或计划日志**中。这决定了整个任务的工具下限。若当前界面会直接暴露给用户,允许把这些结果压缩成采访消息中的前置状态块;禁止在 Step 0 前展开长篇说明。

**前置操作:**
1. 先调用 `update_plan` 创建 canonical plan。
2. 必须读取 `references/cli-cheatsheet.md` 建立对所有 CLI 接口的精确记忆。

#### 3.1.0 模型与思考深度感知(Model & Thinking Effort Perception)
为了绝对保证内容质量不滑坡,主 agent 必须在开局时确认自己是谁,并在采访阶段确认 subagent 使用的模型及思考等级:
1. **强行识别当前主 agent 正在使用的大模型版本**(例如 Claude-3.5、Gemini-1.5 等,如果无法确认直接问用户)。
2. 将其在心中显性固化为 `MAIN_MODEL` 全局变量,并在对话中输出 `## 模型感知结果`。同时也需探测当前环境 API/工具是否支持给模型传递"思考深度/推理努力(reasoning effort)"这一级选项。
3. **`SUBAGENT_MODEL` 与 `SUBAGENT_THINKING_EFFORT` 绑定**:Step 0 采访阶段不仅会向用户确认 subagent 使用的模型,还会询问需要的**思考深度等级**(详见 6.2)。用户回答后,将其显性固化为 `SUBAGENT_MODEL` 和 `SUBAGENT_THINKING_EFFORT` 全局变量,并在 `## 模型感知结果` 中同步输出。
4. **全局防降格红线**:一旦确认这两个变量,在后续流程中创建任何 Subagent 时,必须强制将其带入构建参数中(绝对禁止走默认回退配置)。

#### 3.1.1 Subagent 操作手册生成
环境中有多种执行工具,主 agent 必须为自己梳理规矩:
1. 自检环境中用于创建管理 agent/subagent 的技能或 API。
2. 检查这些工具是否支持模型重载参数(对应 3.1.0)。
3. 整理出支持情况并输出到对话,标题固定为 `## Subagent 操作手册`,必须包含以下内容:
   - **工具名称**:当前环境可用的 subagent 创建工具
   - **调用模板(必须含变量槽)**:一个可参数化的命令模板,包含 `{{SUBAGENT_NAME}}`、`{{PROMPT_PATH}}`、`{{MODEL}}` 以及支持深度思考情况下的 `{{THINKING_EFFORT}}` 等四个槽位。
   - **示例调用**:用具体值填充槽位的实例

   调用模板示例(主 agent 必须根据实际环境生成类似格式,`{{MODEL}}` = `SUBAGENT_MODEL`,`{{THINKING_EFFORT}}` = `SUBAGENT_THINKING_EFFORT`):
   ```
   # 模板(槽位用 {{}} 标记,MODEL 取自 SUBAGENT_MODEL,THINKING_EFFORT 取自 SUBAGENT_THINKING_EFFORT)
   <tool> --model {{MODEL}} --reasoning-effort {{THINKING_EFFORT}} --message "Read {{PROMPT_PATH}} and execute all instructions" --name {{SUBAGENT_NAME}}
   ```

4. 此后每个业务节点调用 subagent 时,必须回查此模板、替换变量、**显式输出组装后的完整命令到对话中**,然后执行。禁止“依据操作手册”这种含糊引用。

#### 3.1.2 采访 UI 能力探测

由于 Step 0 直接决定用户交互体验:
1. 主 agent 必须自检当前 CLI 是否提供原生结构化提问 UI。
2. 判断标准:是否存在可提交 `question/header/id/options` 一类结构化字段,并让用户直接点选/填写的能力;名称不限,可表现为 `AskUserQuestion`、`request_user_input`、`ask_user_question`、`ui.form` 等。
3. 将结论以 `## 采访 UI 能力` 输出到对话中,至少包含:
   - 是否支持结构化采访 UI
   - 工具名称或能力形态
   - 是否支持单选 / 多选 / 自由补充
   - Step 0 实际执行策略:`structured-ui` / `text-fallback`
4. Step 0 发问前,必须先回查这一结论;支持则使用 `tpl-interview-structured-ui.md`,不支持则使用 `tpl-interview-text-fallback.md`。

#### 3.1.3 Search 工具清单探测
由于 Research 分支极度依赖网络检索能力:
1. 主 agent 自

話し合い

質問、コツの共有、使えないことの報告ができます。「役に立った」の多い順です。

まだ投稿はありません。最初の質問や共有をどうぞ。

ここの投稿は利用者によるもので、PopNx チームのものではありません。

ログインして投稿

GitHub の情報

GitHub スター
925
提供元
sunbigfly
ライセンス
ライセンス記載なし この repo にはライセンスの記載がありません。既定では作者が全権利を持つため、配布や商用利用の前に確認してください。
最終コード更新
2026年6月8日
repo 内の SKILL.md(翻訳版とテンプレートを含む)
1
トピック
ai-agents, html-to-pptx, multi-agent, pitch-deck, powerpoint, ppt, pptx, presentation-generator, slide-generator, visual-qa