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

01 · 解决什么问题
大多数 PPT Skill 的Agent 收到文字 → 选模板 → 逐页排版 → 输出 PPTX。核心隐含假设是"内容已经对了"。
现实不是这样的:
- 内容本身可能没有想清楚 —— 受众是谁?要推动什么决策?立场和矛盾是什么?
- 章节之间各自为战 —— 每页看起来都挺好看,合在一起没有主线
- 视觉风格随机 —— 默认字体、配色、图表样式不统一,每次跑出来不一样
- 反馈修改是灾难 —— 评论说"感觉不对",Agent 只能全页重画
Proposal Skill V2 的出发点是:策略系统决定作品上限,质量门禁守住交付下限。
02 · 它和普通 PPT Skill 的结构性差异
| 常见 PPT Skill | Proposal Skill V2 |
|---|---|
| 收到文字后开始排版 | 先确认受众、决策目标、立场和核心矛盾 |
| 一页一页独立生成 | 先建总策略、章节接口和页面论证链 |
| 用模板保证表面统一 | 用 DESIGN.md、视觉家族和页面路由保证表达统一 |
| AI 自行判断"看起来可以" | 每道批准绑定明确对象、状态、版本和评审证据 |
| 出现问题后重做整页 | 评论进入"定位 → 修改 → 复验 → 放行"回环 |
| 生成 PPT 就算完成 | PNG / PDF / PPTX / 讲稿和 QA 结果共同构成交付 |
四个它独有而其他模板做不到的能力:
- 理解内容:从资料中找到真正影响决策的矛盾,而不是平均分配信息
- 维持策略:让章节、页面和标题持续服务同一主张
- 选择表达:先判断用场景、关系、数据还是文字,再决定 Image2、HTML 或混合路线
- 控制质量:用可验证门禁阻止策略漂移、视觉漂移、裁切、孤儿元素和带病导出
03 · 一条从想法到成品的生产链
每个阶段都回答三个问题:
- 当前要做出什么可检查的对象?
- 谁可以确认它?
- 没有满足什么条件时,流程不能继续?
04 · 视觉方向:不是选模板,而是选设计语言
V2 不让你从 20 个模板里挑一个。它用真实的 Image2 资产生成 2–3 个有差异的视觉方向,由 Owner 选择后形成 DESIGN.md。
同一套内容不会直接套模板。三方向的视觉语言和排版哲学完全不同。
05 · 真实案例:跨四个领域的脱敏样章




以上四组截图来自近期真实提案的页面缩略图,覆盖营养健康、医美护肤、防晒策略和品牌视觉系统。
06 · 任务模式:按规模选治理强度
V2 不会要求一张内容模块也走完整 0→1 长提案流程:
| 模式 | 适用任务 | 保留的核心控制 |
|---|---|---|
full_deck | 0→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