用途:这是 alicloud-skills 仓库专用的技能工程流程,用于创建新技能、迁移外部技能、重构与优化技能,以及提升技能触发质量。主要能力:按仓库约定搭建技能目录结构;为技能生成 SKILL.md 与 agents/openai.yaml;添加或修复 tests 下的烟雾测试;库存变化时刷新 README 技能索引;按需运行脚本编译校验、make test/make build-cli 等更广检查;面向重要技能可复用 scripts/run_eval.py、scripts/aggregate_benchmark.py、eval-viewer/generate_review.py 做基准循环,产物建议放同级工作区并保留每次迭代输出。使用方式:先确认 domain/subdomain、目标技能名、任务属于新建/迁移/重构,以及预期产物与成功标准;新技能先脚手架再写 SKILL.md 与 agents/openai.yaml;外部迁移先复制完整源码树再最小化适配;适配时替换与本仓库不符的环境说明,加入仓库校验与输出规范,保留可复用脚本/参考资料/资产。随后创建或更新 tests/<domain>/<subdomain>/<skill-name>-test/SKILL.md,测试应最小、可复现、低风险,并写明通过标准与证据位置。校验命令: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 确认索引。限制与约束:技能须放在 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>/。不适用:仅执行已有产品技能、或只改 apps/ 应用代码而无技能变更时不要使用。完成标准:路径命名合规、frontmatter 完整、触发描述明确、测试有客观通过标准、校验产物存于 output/、库存变化后 README 索引已刷新。其他细节暂未提供。
alicloud-skill-creator
编程与开发
更新于 10-15 17:34