用途:帮助智能体创建或维护 AgentSkills(技能包)及 SKILL.md 文件,覆盖创建、编辑、改进、整理、审阅、审计与重构等任务。技能被视为扩展 Codex 能力的模块化自包含包,用专门知识、工作流和工具把通用智能体转为特定领域智能体。
主要能力与结构:技能由一个必需的 SKILL.md 和可选资源组成。SKILL.md 含 YAML frontmatter,仅 name 与 description 两字段,是唯一用于判定何时触发的元数据;正文为 Markdown 指令,仅在触发后加载。可选资源包括 scripts/(可执行代码,如 scripts/rotate_pdf.py)、references/(按需载入的文档,如财务模式、公司政策、API 说明)和 assets/(用于输出,如图标、模板、字体、样板代码)。
设计原则:强调简洁,只补充 Codex 尚不具备的上下文;按任务脆弱性设定自由度(高:文本指令;中:带参数伪代码或脚本;低:固定脚本与具体步骤)。采用三级渐进式披露:元数据常驻、正文触发后加载(建议 500 行以内、小于 5k 词)、其余资源按需加载。避免深度嵌套引用,引用文件应直接从 SKILL.md 链接;超过 100 行的引用文件加目录。不要在技能中附加 README、安装指南、更新日志等多余文档。
使用方式:按“理解具体示例→规划可复用内容→初始化技能→编辑技能→打包技能→按真实使用迭代”的流程进行。初始化运行 scripts/init_skill.py <skill-name> --path <output-directory> [--resources scripts,references,assets] [--examples]。命名只用小写字母、数字和连字符,长度小于 64 字符,优先动词开头,文件夹名与技能名一致。
适用场景与限制:适用于编写、审阅或重构 Codex 技能包及 SKILL.md。资料未提供具体安装命令以外的版本、平台、收费或价格信息,均暂未提供;正文写作需使用祈使或不定式形式。