Repository Guidelines

项目用途与维护范围

• 本仓库用于维护和发布我们自己的 Agent Skills。
• 自 2026-10-26 起，发布渠道为 GitHub。将完整 Skill 提交并推送到本仓库即完成发布。
• 旧 Go CLI、交互式 TUI 和 npm 包停止维护。现有源码和文档保留作历史参考。
• Skill 收录和更新无需构建二进制、更新旧 registry、添加 CLI i18n、修改 npm 版本或创建发布标签。
• 不执行 npm 发布、scripts/release.sh 或旧工具发布流程。
• 本规范优先于仓库内历史文档和已安装贡献指南中的旧流程。

Skill 目录与内容

• 每个 Skill 存放在 skills/<skill-name>/。
• SKILL.md 必须包含 YAML 前置元数据 name 和 description。
• name 使用小写字母、数字和连字符，并与目录名一致。
• 收录现有 Skill 时复制完整目录，保留 references/、scripts/、assets/、agents/ 等配套资料。
• 保留来源、许可证、原始约束和验证边界。禁止上传密钥、令牌、订阅链接及完整敏感日志。
• 新增 Skill 时更新中英文 README 中的当前目录。
• 贡献流程以 skills/skills-x/SKILL.md 为准；同步仓库内 .codex/skills/skills-x/ 的贡献说明副本。

验证要求

1. 检查 SKILL.md 元数据、目录名和相对引用。
2. 检查配套文件完整性。直接收录时与来源逐个比较文件内容。
3. 根据修改内容执行适用验证。仅更新文档与 Skill 资料时，无需运行旧 Go 工具构建或测试。
4. 提交前执行 git diff --check，检查最终变更与敏感信息。
5. 推送后核对远程分支提交与本地提交一致。

提交与发布

• 使用 Conventional Commit 格式，例如 feat: add shadowrocket Claude routing skill。
• 只提交当前任务涉及的文件，保留其他未提交工作。
• 用户授权提交和推送后，将提交推送到约定的 GitHub 分支。
• 报告提交标识、远程分支、收录位置和验证结果。

历史目录