Skills 管理说明

本目录是仓库内 skills 的唯一维护来源（single source of truth）。

新增 Skill 流程

1. 在 .agents/skills/<skill-name>/ 下创建新目录。
2. 添加 SKILL.md，包含：
   • YAML frontmatter 中的 name 和 description
   • 正文中的精简流程说明
3. （可选）如需 Codex UI 元数据，添加 agents/openai.yaml。
4. 若该 skill 需要作为仓库公共 skill 跟踪，请将 <skill-name> 追加到 .agents/skills/public-skills.txt。

命名规则

• 仅使用小写字母、数字和连字符（-）。
• 优先使用简短、动作导向的名称（例如：gh-create-pr）。

Claude 兼容

每个新增的公共 skill，请执行：

pnpm skills:sync

skills:sync 会自动创建/更新 .claude/skills/<skill-name> 为指向 ../../.agents/skills/<skill-name> 的符号链接。

Windows 兼容性

本项目使用符号链接同步 AGENTS.md、skills 等文件。Windows 开发者需要手动启用符号链接支持：

1. 启用开发者模式（设置 → 更新和安全 → 开发者选项），或
2. 通过本地安全策略（secpol.msc）授予 SeCreateSymbolicLinkPrivilege 权限。
3. 配置 Git 以创建符号链接：
   bashCopy

   git config --global core.symlinks true
   

4. 启用后重新克隆仓库（或执行 pnpm skills:sync）。

白名单跟踪规则

公共白名单由 .agents/skills/public-skills.txt 定义。

• 写入该文件的 skill 会同步到 .agents/skills/.gitignore 和 .claude/skills/.gitignore。
• 私有/仅本地使用的 skill 不应写入 public-skills.txt。
• 每行只写一个 skill 名称。注释行必须以 # 开头，不能写行尾注释。

更新 public-skills.txt 后，请执行：

pnpm skills:sync

然后校验：

pnpm skills:check

上述脚本会自动维护并校验：

• .agents/skills/.gitignore
• .claude/skills/.gitignore
• .claude/skills/<skill-name> 是指向 .agents/skills/<skill-name> 的有效符号链接