SuperAPI AI 工具集

write-a-skill

通用与其它

查看项目

更新于 10-15 17:28

技能介绍

用途:帮助作者按技能库编写标准创建、审查和修复技能包。把 standards/skill-authoring-standard.md 从文档变成可执行的检查门禁,覆盖脚手架、描述激活、内容归位与 11 项模式校验。

主要能力:

  1. 脚手架:依据 spec JSON 生成合规包骨架,含必填章节占位,description 超 240 字符或缺 Use when 子句会拒绝生成。
  2. 描述审计:按预算与触发质量打分,并报告相邻技能描述冲突;重叠超过阈值提示助手难以区分。
  3. Lint:按 11 项模式检查技能目录,--strict 下警告也失败;区分工具与辅助库,同目录相对导入允许,跨技能导入报错。

使用方式: python3 engineering/write-a-skill/scripts/skill_scaffold.py --input engineering/write-a-skill/assets/sample_skill_spec.json --out engineering --dry-run --format text python3 engineering/write-a-skill/scripts/description_audit.py --input engineering/write-a-skill/assets/sample_descriptions.json --min-score 70 --collision-threshold 0.5 --format text python3 engineering/write-a-skill/scripts/skill_lint.py --skill engineering/write-a-skill --rules engineering/write-a-skill/assets/sample_lint_rules.json --strict --format json

适用场景:新建技能、审查技能 PR、修复不激活的技能、拆分过大的 SKILL.md、新增相邻技能后审计描述冲突、向新作者教学。

限制:脚本不会自动判断领域内容的正确性,判断部分仍需人工,使用 assets/skill-review-checklist.md 辅助。除 standards/ 外不得引用其他技能文件;标准与阈值以实际规则文件为准。其余具体平台、收费与效果信息暂未提供。