用途:为 FGDH 目录撰写新的 Agent Skill,或把已有 Skill 提升至目录契约。该 Skill 为纯约定,不依赖工具链,也不假设运行位置。
主要能力:判断所处环境——若仓库根存在 scripts/build_index.py 则使用机械校验并以退出码为准,否则改用人工检查清单,并须明确说明未安装或获取校验器;写作前先决定 tier(universal、domain、project,其中 project 不得写入 fgdh.tier);复制 templates/SKILL.md.template,目录名与 name 字段必须一致,替换全部占位符并删除说明性注释;最后写 description,应说明做什么与何时触发,使用用户会输入的措辞,并以排除相邻 Skill 的限定子句结尾,避免触发不足。
正文按序填写四个必备章节:## Preconditions、## Procedure、## Verification、## Scope and delimitation,尽量用带退出码的命令替代主观判断。对某类产物的规范性断言须在多个实例上测量,或在单实例上明确限定并记录样本;把对另一 Skill 的依赖写成被检测的前置条件并输出固定安装命令后停止,而非自行安装。元数据中 fgdh.tier、fgdh.domain、fgdh.owner 必填,fgdh.language、fgdh.status 默认为 en、stable,所有值均为字符串,fgdh.owner 需加引号并以 @ 开头。新建 Skill 设 fgdh.status: "experimental",并在正文开头加实验性提示条;描述中不得出现该警告。SKILL.md 保持在 500 行内、正文约 5000 token 内,表格与长流程移入 references/,仅一层深;禁止绝对路径和向上 .. 遍历。需在 references/triggers.md 写入 3 至 5 个应触发提示词及 2 个应触发相邻 Skill 的提示词。
验证命令(在目录仓库内):python scripts/build_index.py、python scripts/build_index.py --check、python scripts/check_descriptions.py;须在同一次变更中提交 skills/index.json 与 CATALOG.md。仓库外或校验器不可用时按清单人工核对。
限制:不涵盖 Skill 是否应存在、归属、评审、重验证与弃用等治理事项(见 docs/lifecycle.md),不涵盖发布机制(见 CONTRIBUTING.md),也不提供任何领域内容。若同名 Skill 同时由本目录和本地提供,本地优先。该资料标注为实验性,尚未针对真实任务验证,使用前应核验输出。