CodeWhale pptx 技能解析Agent 处理 PPTX 幻灯片的标准工作流与仓库实现【免费下载链接】CodewhaleOpen-source coding agent for your terminal, built in Rust and on a journey of continuous community improvement. Issues and PRs welcome.项目地址: https://gitcode.com/GitHub_Trending/de/CodewhaleCodeWhale 通过内置技能Skills目录让 Agent 获得面向特定任务领域的结构化行为准则。本文聚焦其中用于处理 PowerPoint 与.pptx幻灯片文件的pptx技能讲解其触发场景、兼容别名、三层验证工作流并结合仓库源码说明该技能从纯文本指令被编译进 Agent 运行时、纳入分类目录并受测试约束的完整链路。读完本文你将理解如何在 CodeWhale 中引导 Agent 产出可被再次打开校验的幻灯片并掌握该技能在仓库中的实际承载方式。技能本体一份为 Agent 定制的极简行为契约pptx技能的定义文件位于 crates/tui/assets/skills/pptx/SKILL.md。与许多面向开发者阅读的长篇教程不同这份 SKILL.md 刻意保持短小——它是写给 CodeWhale Agent 的操作准则而非写给人类的产品说明书。文件由两部分构成YAML front matter 元数据 Markdown 指令正文。Front matter 元数据--- name: pptx description: Create/edit/inspect/verify slide decks and PPTX presentations. invocation: modeluser ---三个字段各司其职name: pptx技能的唯一标识名也是 Agent 在模型目录catalogue中索引该技能的键。description一段面向模型的能力描述用于技能推荐与匹配仓库中 recommend.rs 会利用描述做关键词排序且测试explicit_keywords_outrank_description_fallbacks表明精确关键词会优先于泛化的描述兜底。invocation: modeluser声明该技能的激活方式。它在加载层被解析为SkillInvocation::ModelAndUser见下文运行时接线意味着该技能既可以由模型在合适的时机自行激活进入 ambient 目录也可以由用户显式点名加载——与之相对的explicit-only技能则只能显式调用。指令正文的三要素正文部分覆盖了该技能的完整操作面任何 CodeWhale Agent 在收到与幻灯片相关的任务时都应遵循这份正文所确立的行为契约使用时机When to use面向 PowerPoint /.pptx幻灯片。兼容性Compatibilitypresentations是它的兼容别名。工作流Workflow三段式执行准则详见下文。触发时机什么任务该交给 pptx 技能该技能把适用范围圈定为PowerPoint /.pptx格式的演示文稿。这意味着当用户的请求涉及创建新演示文稿、编辑既有幻灯片、检查文档内部结构如逐页内容、标题体系或对生成结果做验证时Agent 都应当遵循本技能的工作流。仓库为办公文档类产物配置了成体系的技能矩阵pptx与其余格式技能互为参照docx 技能面向.docx/ Word 风格文档备忘录、报告、信函、模板其别名是documentspdf 技能面向 PDF 的读取、拆分、合并、旋转、水印、OCR 等操作xlsx/spreadsheets以及dataviz覆盖电子表格与数据可视化场景。需要说明的是pptx技能正文刻意不绑定具体生成工具——它没有像 pdf 技能 那样罗列pdftotext、pypdf、PyMuPDF等实现工具而是把重心放在用何种策略组织幻灯片、以及如何自证产物正确这一更高层的行为准则上。具体调用哪个本地命令或库留给 Agent 依据当前运行环境自行决策。这一点在把技能当作轻量可移植指令的定位下是合理的取舍。兼容别名presentations 的继承关系ppt 概念在社区与历史命名中常被写作 presentations。为兼容既有习惯仓库提供了presentations别名目录crates/tui/assets/skills/presentations/SKILL.md--- name: presentations description: Compatibility alias for the pptx skill. Prefer loading pptx. aliases-for: pptx ---这份别名文件的内容非常直白它声明自己是pptx的兼容别名并指示任何加载了它的调用方读取并遵循 pptx 技能正文来获得真正的工作流。也就是说别名只是一个路由跳板真正生效的行为准则仍然收敛到唯一的权威定义 pptx/SKILL.md从而避免两处维护同一份内容导致的行为漂移。三段式工作流从组织策略到产物自证pptx 技能 将幻灯片生产流程收敛为三条准则是全文最核心的实操内容Choose a simple layout system and stick to it.选定一套简单的布局体系并贯彻始终。不要在整套 Deck 中混用多种版式语言。统一的大标题位、统一的正文容器、统一的分隔方式会让演示文稿在视觉上一致、在实现上可被程序化处理。这既是设计约束也是工程约束固定版式意味着 Agent 在为多张幻灯片生成内容时可以复用同一套布局模板。Prefer fewer denser slides over slide spam.宁要更少、信息密度更高的幻灯片也不要幻灯片刷屏。控制页数是演示场景的黄金准则。技能明确要求 Agent 把相关内容聚合到尽量少的页面里避免把一次对话的产出拆成几十张互相重复的薄页——这也是对后续逐页校验标题与数量环节的间接保障页数越少可读性与可验证性越强。Verify by reopening the deck and checking slide count/titles.通过重新打开 Deck核对幻灯片数量与各页标题来完成验证。Agent 完成产出后不能仅凭生成成功就宣告任务结束必须把产物当作输入重新打开逐项核对两个最小可验证信号幻灯片总数是否符合预期、每页标题是否落在计划范围内。这一重开验证的姿态与仓库中 pdf/docx 等姊妹技能重新打开并抽取代表性文本以验证的思路一脉相承体现的是产物质量自证self-verification的通用原则。这套工作流覆盖了组织策略 → 密度控制 → 结果自证的完整闭环任何一个环节在纯文本生成场景中都容易被 Agent 跳过因此被显式写入技能正文予以约束。运行时接线SKILL.md 如何进入 Agent 的模型目录仓库中技能正文并非运行时动态读取散落文件而是在编译期就被烘焙进二进制。查看 crates/tui/src/skills/system.rsconst PPTX_BODY: str include_str!(../../assets/skills/pptx/SKILL.md); const PRESENTATIONS_ALIAS_BODY: str include_str!(../../assets/skills/presentations/SKILL.md);include_str!把 pptx/SKILL.md 的全文在编译期嵌入常量随后在BUNDLED_SKILLS数组中注册为名为pptx的内置技能system.rsintroduced_in: 5别名presentations则以introduced_in: 3注册system.rs。从这些版本号可以推断presentations这类pre-v5 产物命名的兼容别名是先于 v5 技能体系规范化而存在的v5 统一了命名后以别名形式保留了对旧名称的兼容。技能注册后还会被打上产品级分组。系统将内置技能划分为CoreAgenticcore与FormatToolingtools两档而pptx、pdf、docx、xlsx及其别名documents、presentations、spreadsheets均被归入FormatToolingtools档system.rs与skill-creator、dataviz等同列表示它们属于面向特定文件格式的工具型能力而非 Agent 自主编排的核心推理能力。invocation: modeluser 的运行时语义invocation字段的解析链路值得单独说明。加载层在 crates/tui/src/skills/mod.rs 依据 front matter 中的invocation字符串构造SkillInvocation取值modeluser映射为SkillInvocation::ModelAndUserexplicit-only/explicit_only则映射为SkillInvocation::ExplicitOnlycrates/tui/src/skills/mod.rs。这一枚举决定了技能以何种方式暴露给模型ModelAndUser即 pptx 的取值技能可进入 ambient 目录即在模型上下文中的常驻目录页出现允许模型根据任务描述自主加载同时用户也可显式请求。目录矩阵测试明确断言ambient 页只允许包含 modeluser 技能crates/tui/src/skills/catalog_matrix.rs且 mod.rs 在构建目录时也会过滤掉ExplicitOnly技能。ExplicitOnly仅能通过显式点名加载绝不进入 ambient 上下文对应测试explicit_only_skills_are_absent_from_the_ambient_catalogue。对pptx而言modeluser意味着当用户请求与幻灯片相关时模型可以在目录中自主发现并遵循该技能无需用户手动指定技能名。目录矩阵夹具用测试锁死目录声明pptx技能与目录的对应关系并非运行时推导的软约束而是被一份名为 crates/tui/assets/skills-catalog-matrix.json 的检查清单所锚定{ name: pptx, tier: tools, invocation: modeluser, aliases: [], in_model_catalogue: true, shadowed_aliases: [] }同文件中的presentations条目则记录aliases: [pptx]与shadowed_aliases: [pptx]skills-catalog-matrix.json把别名指向 pptx这一关系固化为机器可读声明。这份夹具与真实内置技能清单存在双射约束测试bundled_skill_names()暴露真实 bundle 的技能名单system.rs而 catalog_matrix.rs 会逐一比对每个技能在夹具中登记的tier、invocation等字段——一旦字段漂移例如pptx的 invocation 从modeluser被误改构建期测试便会失败。正如源码注释issue #4698所写a skill added or removed without updating the fixture fails the build rather than silently changing what every user gets installed。换句话说任何关于 pptx 技能元数据的改动都必须同时更新这份 JSON 夹具否则无法合入。小结一份短文档背后的完整工程约束回顾 crates/tui/assets/skills/pptx/SKILL.md它在字面上只有十几行却承载了 CodeWhale 技能体系的多个关键设计面向模型而非面向人的指令写作范式正文短小、可执行、不绑定具体工具单一权威定义 兼容别名presentations别名收敛指向pptx避免双份维护产物自证闭环最后的重开验证页数与标题准则是保证幻灯片交付质量的最后一道关卡编译期烘焙与双射夹具include_str!将技能打进运行时skills-catalog-matrix.json与catalog_matrix测试共同锁定技能名、层级、invocation 与别名关系不漂移。理解了这条从纯文本准则到运行时常量、再到测试夹具的完整链路你就知道该如何审视 CodeWhale 中任何一份内置技能文档它的字面内容只是水面真正的行为约束还隐含在目录矩阵、版本标记与单测断言之中。若要在本地查看或调试这套体系可以沿 pptx/SKILL.md → system.rs → skills-catalog-matrix.json → catalog_matrix.rs 的路径逐层深入。参考文件索引技能正文crates/tui/assets/skills/pptx/SKILL.md兼容别名crates/tui/assets/skills/presentations/SKILL.md编译期注册crates/tui/src/skills/system.rs目录矩阵夹具crates/tui/assets/skills-catalog-matrix.jsoninvocation/目录解析与测试crates/tui/src/skills/mod.rs、crates/tui/src/skills/catalog_matrix.rs姊妹格式技能crates/tui/assets/skills/pdf/SKILL.md、crates/tui/assets/skills/docx/SKILL.md【免费下载链接】CodewhaleOpen-source coding agent for your terminal, built in Rust and on a journey of continuous community improvement. Issues and PRs welcome.项目地址: https://gitcode.com/GitHub_Trending/de/Codewhale创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考