SuperAPI AI 工具集

new-skill

智能体与模型

查看项目

更新于 10-16 03:17

技能介绍

用途:/new-skill 用于按本仓库的规范脚手架式创建一个新技能。用户给出模糊意图后,它先访谈成明确规格,再写出 .claude/skills/<name>/SKILL.md,使 frontmatter 与正文互相一致,从而通过 check-skill-integrity.py 与 check-surface-sync.sh 检查。

主要能力:Phase 0 解析 kebab-case 名称并检查与现有技能或内置命令冲突,读取 templates/skill-template.md 并参考邻近技能;Phase 1 一次性收集用途、触发场景、参数、工具、输出、范围边界、副作用与是否需要新上下文复核;Phase 2 按模板写出含 When to use、目标与交付物、约束、验证方式、输出格式、退出行为、交叉引用、不做什么等章节的 SKILL.md;Phase 3 强制 flag 与 allowed-tools 双向一致、锚点可解析;Phase 4 提醒在 README 技能表加行、更新指南附录并同步各处技能计数。

使用方式:以 /new-skill 调用,可带 --from-learn 从 /learn 式存根升级,或 --dry-run 仅在对话中输出草稿不写盘。完成后运行 python3 scripts/check-skill-integrity.py --verbose 与 ./scripts/check-surface-sync.sh,两者需退出 0。

适用场景:反复向 Claude 解释同一套 3 步以上工作流、需要领域特定检查或输出格式、希望新技能与 .claude/skills/ 下 40 多个同类保持一致时。

限制:不捕获会话发现(那是 /learn);不代为编辑 README 技能表或 CLAUDE.md 快速参考;不写 agents、rules 或 hooks;不提交任何内容。名称冲突或非 kebab-case 时在 Phase 0 停止且不写文件;完整性检查报 P0/P1 时须就地修复后重跑。