用途:把技能写成供另一个有能力智能体使用的紧凑操作准则。
主要能力:规范 frontmatter(name 用技能文件夹名,description 写触发面与使用时机);正文优先短祈使要点,省略冗长解释,按标题分组、先放最常用规则,保留精确命令、配置片段、schema、布局和常量;长内容移到引用文件并直接从 SKILL.md 链接,引用文件保持一层深;不改动原有行为要求与安全约束,不借重构编造新规则。
使用方式:重构后运行验证脚本:uv run --with pyyaml C:\Users\ctyja.codex\skills.system\skill-creator\scripts\quick_validate.py .\skills{skill-name};无 Python 或 PyYAML 时用 uv run --with pyyaml;检查 git diff 确认触发条件与需求未丢失,并重读 SKILL.md 确认可扫读性。
适用场景:整理或重写 Codex 技能文档,使其更易被智能体扫描与执行。
限制:不添加 README、变更日志、安装指南等辅助文件(除非是实际技能资源);不为凑长度编造功能。具体仓库额外字段与触发短语示例资料暂未提供。