Proposal Skill V2:让 Agent 治理提案生产,而不只是排版幻灯片

Proposal Skill V2 深度拆解 —— 一套让 AI Agent 从想法到成品全链路治理提案/报告的受控生产系统,而非模板填充器。含安装实践与架构分析。

一句话总结:coderxupeng1990-eng/qifei-proposal-skill 是一套 提案治理与 HTML-first 演示生产系统,v0.2.0-rc.2,36 Stars / 2 Forks,PolyForm Noncommercial 1.0.0 许可。它不优化"把字放进模板的最后一步",而是管理"从资料碎片到可交付作品"的整条链路。

Proposal Skill V2 系统概览:从碎片资料到完整演示作品的受控生产系统


01 · 解决什么问题

大多数 PPT Skill 的Agent 收到文字 → 选模板 → 逐页排版 → 输出 PPTX。核心隐含假设是"内容已经对了"。

现实不是这样的:

  • 内容本身可能没有想清楚 —— 受众是谁?要推动什么决策?立场和矛盾是什么?
  • 章节之间各自为战 —— 每页看起来都挺好看,合在一起没有主线
  • 视觉风格随机 —— 默认字体、配色、图表样式不统一,每次跑出来不一样
  • 反馈修改是灾难 —— 评论说"感觉不对",Agent 只能全页重画

Proposal Skill V2 的出发点是:策略系统决定作品上限,质量门禁守住交付下限。


02 · 它和普通 PPT Skill 的结构性差异

常见 PPT SkillProposal Skill V2
收到文字后开始排版先确认受众、决策目标、立场和核心矛盾
一页一页独立生成先建总策略、章节接口和页面论证链
用模板保证表面统一用 DESIGN.md、视觉家族和页面路由保证表达统一
AI 自行判断"看起来可以"每道批准绑定明确对象、状态、版本和评审证据
出现问题后重做整页评论进入"定位 → 修改 → 复验 → 放行"回环
生成 PPT 就算完成PNG / PDF / PPTX / 讲稿和 QA 结果共同构成交付

四个它独有而其他模板做不到的能力:

  1. 理解内容:从资料中找到真正影响决策的矛盾,而不是平均分配信息
  2. 维持策略:让章节、页面和标题持续服务同一主张
  3. 选择表达:先判断用场景、关系、数据还是文字,再决定 Image2、HTML 或混合路线
  4. 控制质量:用可验证门禁阻止策略漂移、视觉漂移、裁切、孤儿元素和带病导出

03 · 一条从想法到成品的生产链

每个阶段都回答三个问题:

  • 当前要做出什么可检查的对象?
  • 谁可以确认它?
  • 没有满足什么条件时,流程不能继续?

04 · 视觉方向:不是选模板,而是选设计语言

V2 不让你从 20 个模板里挑一个。它用真实的 Image2 资产生成 2–3 个有差异的视觉方向,由 Owner 选择后形成 DESIGN.md。

同一套内容不会直接套模板。三方向的视觉语言和排版哲学完全不同。


05 · 真实案例:跨四个领域的脱敏样章

营养健康提案案例

医美护肤品牌提案案例

防晒市场策略提案案例

品牌视觉系统提案案例

以上四组截图来自近期真实提案的页面缩略图,覆盖营养健康、医美护肤、防晒策略和品牌视觉系统。


06 · 任务模式:按规模选治理强度

V2 不会要求一张内容模块也走完整 0→1 长提案流程:

模式适用任务保留的核心控制
full_deck0→1 完整提案、报告或演示完整策略、全稿审查、内容冻结、视觉方向、讲稿与导出
inherited_module向已有受控 PPT 增加或替换模块继承父项目策略与设计,只验证模块接口和页面 QA
standalone_module独立单页或 2–8 页内容模块轻量简报、模块判断、视觉基线、页面回环与导出

07 · 质量门禁:三道核心闸门

策略与证据门禁

V2 要求"正确但没有观点的页面必须退回"。每一页都必须有明确的内容任务、载体判断、视觉论点和质量检查记录。

内容冻结门禁

全部内容确认后只做一次全稿审查,关注逻辑、表达、衔接、拆页和视觉载体,不重新审判用户已确认的场外决策。

设计与越界门禁

策略主张页

问题推导页

策略系统与质量门禁页

正式视觉前必须有真实图像资产参与视觉方向校准。方向说明不能替代方向样图。


08 · 并行生产:设计定稿后的加速策略

内容、飞书母稿、设计系统和生成门禁全部确认后,主 Agent 可以启动页面生产波次:

  • 默认 3 个、最多 6 个 Agent 并行
  • 每个生产 Agent 只负责不重叠的页面任务
  • 共享文件(策略主轴、设计令牌)由主 Agent 持有
  • 每波结束后由主 Agent 统一复验

并行只发生在页面生产阶段。策略和权威状态(策略主轴、内容冻结)不被拆分。


09 · 运行时兼容:不绑定 Codex 订阅

V2 不按 Agent 品牌判断能力,而是运行 Doctor 检测真实环境并选择适配器:

运行档位能力范围
codex_full内置图像、视觉理解、本地渲染与评论齐全
api_full其他 Agent 具备文件、命令、图像 API、视觉理解
local_production可渲染和导出,但缺图像能力时不能过视觉门禁
content_only可完成策略、成稿和页面路由,不冒充正式交付

可替换的适配器包括:

  • 图像生成:Codex 内置图像 / OpenAI 兼容 API / 自定义命令
  • 内容权威:飞书 / 继承父项目 / 本地 Markdown
  • 评论评审:原生评论 / 本地 Review Bundle / 外部哈希绑定

API Key 和令牌不会写入项目状态、提示词记录或日志。


10 · 安装实践:Windows 环境实录

仓库注意点

⚠️ 默认分支是 codex/qifei-proposal-base,不是 main。直接 clone 后需要 checkout 到此分支,否则你看到的是一个空骨架。

git clone https://github.com/chenxupeng1990-eng/qifei-proposal-skill.git
cd qifei-proposal-skill
# 已自动在 codex/qifei-proposal-base 分支上

Bootstrap 环境检查

python scripts/bootstrap.py --suite v2

本机实测结果:

检查项状态
Node.js 22.22.2 (≥18)✅ PASS
Python 3.14.3✅ PASS
playwright-core✅ PASS
pdf-lib (PDF 导出)✅ PASS
pptxgenjs (PPTX 生成)✅ PASS
jszip✅ PASS
Chromium launch (via Edge)✅ PASS
npm (WorkBuddy 内置路径)⚠️ 路径检测失败,但包安装正常

安装 Skill 套件

python scripts/install_skills.py --suite v2

默认安装到 ~/.codex/skills。本机复制一份到 WorkBuddy skills 目录后共 4 个 Skill 可用:

  • qifei-proposal-v2 —— 总控入口、策略连续性、状态与门禁
  • grill-me-lite —— 一次一个问题的关键决策访谈
  • proposal-ppt-production —— 页面载体选择、视觉生产、QA 与组装
  • ppt-html-calibration-editor —— 16:9 HTML 页面与浏览器内精细校准

11 · 核心治理规则速查

  • 总策略先编译为章节策略接口,再编译为页面论证链;上一章输出必须成为下一章输入
  • 页面论证链确认后一次性生成整章正文,再逐页评论和确认;不逐页串行写正文
  • 全部内容确认后只做一次全稿审查,不重新审判已确认决策
  • HTML 负责精确文字、数据、表格和严密关系;Image2 负责主视觉和场景
  • 并行只发生在页面生产,不拆分策略和权威状态
  • 讲稿等待全部页面和最终页序确认后,按最终页码一次性生成

12 · 当前版本与仓库结构

v0.2.0-rc.2(2026-10-25 最新 push)。仓库总大小 12.6 MB。

skills/qifei-proposal-v2/        总控 Skill、阶段包、模板、脚本与测试
skills/grill-me-lite/            关键决策访谈
skills/proposal-ppt-production/   页面生产与组装
skills/ppt-html-calibration-editor/  HTML 校准编辑器
demo/visual-sample/              脱敏视觉 Demo(营养健康主题)
scripts/                         安装、Bootstrap 与发布自检
tests/                           套件安装测试

13 · 最后判断

Proposal Skill V2 不是一个"PPT 模板库",而是一套生产治理框架。它明确区分了"策略"和"生产"、“内容"和"视觉”、“批准"和"检查"这几组大多数 PPT Skill 混在一起的概念。

它的适用边界也很清楚:PolyForm Noncommercial 1.0.0 许可 —— 个人学习、研究和非商业内部评估免费使用,商业项目需要作者书面许可。

对于需要反复产出有说服力的提案/报告、且对策略一致性和视觉质量有要求的场景,这套系统值得认真评估。

仓库:https://github.com/chenxupeng1990-eng/qifei-proposal-skill 安装后调用:$qifei-proposal-v2