القائمة
对 ppt:create 已生成的 PPT 做自然语言追加调整 (必须有 .ppt-workdir/slide-plan.yaml). 当用户提到"调整 PPT""修改 PPT""ppt:refine""PPT 微调"时触发.
التثبيت باستخدام Codex أو Claude انسخ هذا Prompt والصقه في Codex أو Claude أو مساعد آخر ليراجع صفحة Skill ويثبّتها لك.
استنادا إلى تصنيف SOC المهني
归档已完成的过程文件
一键启动全自主 agent 团队，自动完成从 PRD 到验证的完整 RPIV 开发流程。brainstorm 完成后使用此命令，无需人工介入。当用户提到"自动开发"、"团队开发"、"全自主"、"biubiubiu"时触发。
通过访谈对话澄清产品需求
对指定目录/模块/skill 进行全量代码审计（不依赖 git diff）。支持逻辑、安全、性能、架构、集成与环境、可迁移性 6 个维度的审查，特别适合审计 skills 是否绑定 Claude Code、Codex、opencode 或特定机器环境。
修复手动/AI 代码审查中发现的问题的流程
在提交前运行的技术代码审查，用于质量和错误检查
| name | ppt:refine |
| description | 对 ppt:create 已生成的 PPT 做自然语言追加调整 (必须有 .ppt-workdir/slide-plan.yaml). 当用户提到"调整 PPT""修改 PPT""ppt:refine""PPT 微调"时触发. |
| argument-hint | <pptx 路径> <调整指令> |
| allowed-tools | Read, Write, Edit, Bash, Glob, Grep, AskUserQuestion |
| version | 3.9.3 |
仅支持有 <pptx目录>/.ppt-workdir/slide-plan.yaml 的 deck (即 ppt:create 生成的). 外部 PPTX (没有 slide-plan.yaml 的) 不支持 — v3.3.x 文档承诺"用 python-pptx 逆向分析推断 visual_type"实际从未实现, LLM 现场写逆向解析逻辑也不可靠. 外部 PPTX 请用 /ppt:create 重新生成.
v3.4.0 同时删除 Agent-V 和 Agent-R LLM 自审 (无 ground truth, 增加 token 成本不增加质量), 改为 deterministic 校验 (validate_plan.py) + 可选 /ppt:taste 评审.
<plugin-root> = skills/refine/ 的两级父目录. 执行 bash 前替换实际路径.
从 $ARGUMENTS 中解析:
示例: /ppt:refine output/report.pptx 第3页换成左图右文布局, 标题改为行动标题
# 必须存在
test -f <pptx目录>/.ppt-workdir/slide-plan.yaml || { echo "未找到 slide-plan.yaml. ppt:refine 仅支持 ppt:create 生成的 deck. 外部 PPTX 请用 /ppt:create 重新生成"; exit 1; }
未通过此检查时, 立即 AskUserQuestion 给用户:
<plugin-root>/design-guide.md + <plugin-root>/anchors.yaml (审美锚点 metadata)如修改涉及 visual_type 变更或新加 slide, 先重装载主题决策框架:
uv run --script <plugin-root>/engine/prompt_assembler.py --theme <theme-from-plan-meta> --output <workdir>/.theme-prompt.md
Read .theme-prompt.md 确保 visual_type 选择遵循当前主题的硬约束 + 软引导, 避免破坏 huawei 应用率门禁.
仅文字 / 数据 / 字号微调 (不改 visual_type, 不加 slide) 时可跳过.
修改 slide-plan.yaml 中受影响的 slides, 写回原路径.
uv run python <plugin-root>/engine/render.py <workdir>/slide-plan.yaml \
--theme <theme> --output <output-path>
注意: refine 一律全量重渲染整份 PPT(render.py 输出确定性, 同输入同输出), 不做局部页替换. 早期 --base-pptx/--only-slides 局部替换路径因页号失真 + 追加到末尾不原位替换, 已于 2026-06-23 弃用移除, 全量重渲染是唯一可靠路径.
渲染后跑 deterministic 校验 (带 --theme 让应用率门禁不退化):
uv run --script <plugin-root>/engine/validate_plan.py <workdir>/slide-plan.yaml --theme <theme> --json
检查受影响 slides 的 FAIL / WARN (含反模式 / 连续相同 visual_type) 和 theme_application.status 不退化为 FAIL (exit 2). 退化时 → 回到 Step 2 按 .theme-prompt.md 软引导改回 huawei 专属版式.
输出:
PPT 已更新: <output-path>
修改了 N 页 (页码: x, y, z)
评审 (可选): /ppt:taste <output-path>
继续调整: /ppt:refine <output-path> <新指令>