用途:Skill Factory 充当 Claude Code 的技能架构师,负责按 Anthropic 最新 Agent Skills 规范与 Ogmios PAI 约定创建新技能、升级既有技能,并随规范变化持续更新参考清单。
主要能力:提供两种模式。模式 A 创建新技能:收集需求(功能与范围、触发短语与关键词、语言、与现有技能的 NOT 边界、是否需要渐进式披露、工具限制),检查 ~/.claude/skills/SKILLS-INDEX.md 是否已有覆盖该领域的技能,若有则建议升级;随后创建目录与 SKILL.md,更新 ~/.claude/semantic-triggers.json 与 SKILLS-INDEX.md,并执行校验。模式 B 升级:完整读取目标 SKILL.md 及前置元数据,按规范逐项测量(description ≤1024 字符、正文 ≤500 行、name 正则 ^[a-z0-9-]+$、PAI [WHAT]/[WHEN]/[EXPERTISE] 结构、NOT 边界、是否含已废弃字段),给出具体诊断与差异建议,先用 cp SKILL.md SKILL.md.backup-$(date +%Y%m%d) 备份再修改,必要时同步触发与索引,最后校验。
规范与约定:内置 Anthropic 规范参考表(含 name 正则与长度、description 长度、正文行数建议、disable-model-invocation、allowed-tools、渐进式披露 references/workflows/templates、references 目录在超过 100 行时建议加 TOC)。PAI 约定要求 description 包含 [WHAT]、[WHEN]、[EXPERTISE]、[LANGUAGE] 与 NOT 边界;技能末尾需有 🎯 与 🗣️ 两条声音标记;不得出现已废弃字段 tier、voice_id、voice_name、priority。
使用方式:按模式 A/B 流程操作,并运行校验协议:YAML 解析 python3 -c "import yaml; yaml.safe_load(open('SKILL.md').read().split('---')[1])"、name 正则、description 字符数、正文行数、PAI 格式检查、JSON 校验及路由测试(3-5 条正例、2-3 条反例)。可使用 !command 动态注入上下文,建议加 2>/dev/null 与 | head -N。
适用场景:维护个人或团队的 Claude Code 技能库、批量升级旧技能以符合新规范、保证触发词与索引同步。
限制:资料未提供收费、价格、平台支持范围与效果保证信息;部分命令与路径依赖本地 ~/.claude 环境。