mcpField
A
alicloud-skill-creator

alicloud-skill-creator

github.com/cinienceAgent 工作流396126 次安装11 周前更新
代码仓库

关于 alicloud-skill-creator

alicloud-skill-creator 是面向 `alicloud-skills` 仓库的技能工程工作流，指导贡献者创建、迁移和维护技能。它涵盖测试、验证及可选基准评估，并强调遵循仓库规范。

主要功能

  1. 01技能创建与迁移流程
  2. 02Frontmatter 与命名规范
  3. 03冒烟测试设置与验证
  4. 04技能索引更新指南
  5. 05可选基准评估流程

适用场景

  1. 01创建新的仓库技能
  2. 02改造外部技能
  3. 03改进技能触发信息和测试
  4. 04评估重大技能变更

安装

复制下面的命令，在终端中运行。

$npx skills add https://github.com/cinience/alicloud-skills --skill alicloud-skill-creator

安装后在 Claude Code 中输入/alicloud-skill-creator确认已加载。

包含的文件

除 SKILL.md 外，安装时一起下载的参考资料和脚本。

LICENSE.txt
agents/
analyzer.md
comparator.md
grader.md
openai.yaml
assets/
eval_review.html
eval-viewer/
generate_review.py
viewer.html
references/
schemas.md
sources.md
scripts/
__init__.py
aggregate_benchmark.py
generate_report.py
improve_description.py
package_skill.py
quick_validate.py
run_eval.py
run_loop.py
utils.py

详细介绍

类别：工具

Alibaba Cloud Skill Creator

针对 alicloud-skills 的仓库专属技能工程工作流。

在以下情况下使用此技能

  • 在 skills/** 下创建新技能。
  • 导入外部技能并使其适配此仓库。
  • 提升技能触发质量（frontmatter 中的 name 和 description）。
  • 在 tests/** 下添加或修复冒烟测试。
  • 合并前运行结构化基准测试循环。

在以下情况下不要使用此技能

  • 用户只需要执行现有产品技能。
  • 任务纯粹是对 apps/ 下的应用代码进行修改，不涉及技能变更。

仓库约束（必须遵守）

  • 技能存放在 skills/<domain>/<subdomain>/<skill-name>/ 下。
  • 技能文件夹名称使用 kebab-case，且应以 alicloud- 开头。
  • 每个技能都必须包含带有 name 和 description 的 SKILL.md frontmatter。
  • skills/**/SKILL.md 的内容必须仅使用英语。
  • 冒烟测试必须存放在 tests/<domain>/<subdomain>/<skill-name>-test/SKILL.md。
  • 生成的证据只能存放在 output/<skill-or-test-skill>/ 下。
skills/<domain>/<subdomain>/<skill-name>/
├── SKILL.md
├── agents/openai.yaml
├── references/
│   └── sources.md
└── scripts/ (optional)

tests/<domain>/<subdomain>/<skill-name>-test/
└── SKILL.md

工作流

  1. 收集需求
  • 确认领域/子领域和目标技能名称。
  • 确认这是新建、迁移还是重构。
  • 确认预期输出和成功标准。
  1. 实施技能变更
  • 新建技能时：搭建结构并起草 SKILL.md + agents/openai.yaml。
  • 从外部仓库迁移时：先复制完整源代码树，再进行适配。
  • 尽量减少适配，但要明确说明：
    • 替换与此仓库不匹配的环境专属说明。
    • 添加仓库验证和输出规范部分。
    • 保留可复用的随附资源（scripts/、references/、assets/）。
  1. 添加冒烟测试
  • 创建或更新 tests/**/<skill-name>-test/SKILL.md。
  • 保持简洁、可复现且风险较低。
  • 写明确切的通过标准和证据存放位置。
  1. 在本地验证

运行脚本编译验证以检查技能：

python3 tests/common/compile_skill_scripts.py \
  --skill-path skills/<domain>/<subdomain>/<skill-name> \
  --output output/<skill-name>-test/compile-check.json

当技能清单有变更时，刷新技能索引：

scripts/update_skill_index.sh

确认索引存在：

rg -n "<skill-name>" README.md README.zh-CN.md README.zh-TW.md

可选的更广泛检查：

make test
make build-cli
  1. 基准测试循环（可选，适用于重要技能）

如果用户要求进行定量技能评估，请复用随附工具：

  • scripts/run_eval.py
  • scripts/aggregate_benchmark.py
  • eval-viewer/generate_review.py

建议将基准测试产物放在同级工作区目录中，并保留每次迭代的输出。

完成标准

  • 技能路径和命名符合仓库规范。
  • Frontmatter 完整，触发说明明确。
  • 测试技能已创建，且具有客观的通过标准。
  • 验证产物已保存到 output/ 下。
  • 如果技能清单有变更，已刷新 README 技能索引。

参考资料

  • references/schemas.md
  • references/sources.md

评论

支持 Markdown