用途:在向 OPC Skills 项目添加新技能时使用,按步骤确保技能满足全部发布要求。
前置条件:位于从 develop 拉出的 feature/skill/<skill-name> 特性分支上;技能名为 kebab-case(如 my-new-skill)。
主要步骤:
- 目录结构:创建 skills/<skill-name>/,包含必需文件 SKILL.md,可选 scripts/、examples/、references/。SKILL.md 需含 YAML frontmatter(name、description),可用 cp -r template skills/<skill-name> 起步。
- 技能 Logo:生成像素风 SVG 图标并放入 skill-logos/<skill-name>.svg,需与既有 Logo 风格一致。
- skills.json 条目:在 skills 数组中添加完整条目,字段含 name、version、description、logo、icon、color、triggers、dependencies、auth、install、commands、links;编辑后用 python3 -c "import json; json.load(open('skills.json')); print('valid')" 校验。
- README.md:在 Included Skills 表格中新增一行。
- worker.js:在 website/worker.js 的 fetchCompareData() 中硬编码的技能数组内添加条目。
- CHANGELOG.md:加入兼容性与依赖矩阵表格及 Unreleased 条目。
验证:依次检查 SKILL.md frontmatter、Logo SVG、skills.json 必填字段、README.md、worker.js、CHANGELOG.md 中是否包含该技能。
提交:git checkout develop && git pull;git checkout -b feature/skill/<skill-name>;git add 相关文件;git commit -m "feat(skill): add <skill-name> skill";推送到远程并向 develop 创建 PR。
限制:资料未提供技能的运行时环境、价格、平台支持范围及实际效果信息。