● 社区
alirezarezvani
⚡ 即开即用
claude-code-skill-factory
作者 alirezarezvani · alirezarezvani/claude-code-skill-factory
超级技能工具包:用交互式构建器快速生成生产级 Claude Skills、智能体、斜杠命令和钩子。
Skill Factory 是一套引导式构建器——Factory Guide、Skills Guide、Prompts Guide、Agents Guide、Hooks Guide——加上 /build、/validate-output、/install-skill 等斜杠命令。你描述想要什么,它就生成 SKILL.md、示例、参考资源和可以直接放入 ~/.claude/skills/ 的 ZIP 包。开箱包含 9 个生产级技能,涵盖 AWS、M365、内容研究和 CLAUDE.md 增强。
为什么要用
核心特性
- 5 个交互式构建器,覆盖每种 Claude Code 扩展形态
- /build 斜杠命令——一站式向导,用于构建 skills、智能体、提示词、钩子
- /validate-output——检查 SKILL.md 前置数据、文件布局、打包成 ZIP
- 开箱即装 9 个生产级技能
- /sync-agents-md 生成 AGENTS.md,支持跨工具兼容(Cursor、Codex)
- 基于 69+ 个预设提示词框架的模板
实时演示
实际使用效果
claude-code-skill-factory-skill.replay
▶ 就绪
使用场景
实战用法: claude-code-skill-factory
何时使用: 你心里有一套可复用的工作流,想让 Claude 把它打包成可安装的 skill。
步骤
-
调用 /build
/build — 我要一个 skill,用来检查 Next.js 应用的 Core Web Vitals 问题,输出 Lighthouse 风格的报告。✓ 已复制
→ Factory 提出澄清问题:触发条件、工具分类、输出格式
-
回答脚手架问题
触发条件为 'audit CWV' 或检测到 Next.js 项目。输出包含截图的 markdown 报告。✓ 已复制
→ 生成带前置数据的 SKILL.md 草稿、示例用法、参考文件
-
验证并打包
→ 前置数据、目录结构、示例完整性都通过检查;生成 ZIP 包
结果: 一个工作正常、已安装的 skill,在下一个匹配的提示词出现时就能触发。
注意事项
- Skill 对无关的提示词触发过于积极 — 收紧前置数据中的 'description'——Claude 用它来决定何时加载 skill
- SKILL.md 中的示例偏离实际行为 — /validate-output 会重新运行示例,标出不匹配的地方
何时使用: 你想让某些操作在提示词提交、工具使用或会话停止时自动运行——而不是让 Claude 选择加载的 skill。
步骤
-
启动 Hooks Guide
/build hook — 在 Claude 保存机密信息前,对每次 Write 工具调用运行 gitleaks✓ 已复制
→ Guide 询问选择哪个事件:PreToolUse/PostToolUse/Stop
-
定义匹配器和命令
匹配 Write 工具调用,将文件内容通过 gitleaks detect 处理,检测到时阻止。✓ 已复制
→ 生成 settings.json 中的钩子块草稿,包含匹配器和命令
-
安装到用户设置
/install-hook — user scope✓ 已复制
→ ~/.claude/settings.json 已更新;下一次工具调用会受到门控
结果: 一个钩子,在机密泄露写入发生前阻止它。
注意事项
- 钩子运行太慢,导致每次工具调用都卡住 — 如果检查不需要阻止,就改到 PostToolUse
何时使用: 你想让每个队友都能使用 CO-STAR / RISEN 结构化的提示词,而不用记住这些框架。
步骤
-
调用 Prompts Guide
/build prompts — 5 个用于客户支持回复的预设,采用 CO-STAR 结构✓ 已复制
→ Guide 列出可用框架,询问选择哪种语气/角色偏差
结果: 可以通过一次 git clone 安装的团队共享提示词包。
组合
与其他 MCP 搭配,撬动十倍杠杆
Prompt Architect 调优单个提示词;Skill Factory 把一组提示词打包成可共享的 skill
让 prompt-architect 优化这 5 个提示词,然后 /build prompts 并导出为 skill 包。✓ 已复制
在构建你自己的 skill 时,用 Posit 的 skill 集合作为参考模板
给我看 Posit R-analysis skill 的结构,然后 /build 一个以它为模型的并行 Python-analysis skill。✓ 已复制
成本与限制
运行它的成本
- API 配额
- 无——完全在 Claude Code 内部运行
- 每次调用 Token 数
- 完整构建会话需要 5k-20k tokens
- 费用
- 免费。消耗你的 Claude 订阅额度。
- 提示
- 保持构建会话的专注——果断回答问题,避免对话扩展成返工。
安全
权限、密钥、影响范围
凭据存储: 无凭据。Skill Factory 仅写入 ~/.claude/skills 和 ~/.claude/settings.json。
数据出站: 除了 Claude Code 本身外,没有出站调用。
- /install-hook 修改 settings.json——在安装到用户作用域前,务必审阅生成的钩子。
故障排查
常见错误与修复
生成的 ZIP 在 /install-skill 时失败
通常是 SKILL.md 中的前置数据有拼写错误。先运行 /validate-output;它会显示确切缺失的字段。
安装后钩子没有输出
匹配器设置太严格。/factory-status 显示哪些事件在触发;在 settings.json 中扩宽匹配器。
验证: cat ~/.claude/settings.json | jq .hooks
替代方案
claude-code-skill-factory 对比其他方案
| 替代方案 | 何时用它替代 | 权衡 |
| skills-skill-2 (Posit skills) | 你只想要现成的 skill,不想要一个自己构建的工厂 | 没有脚手架,没有钩子构建器 |
| Hand-writing SKILL.md | 你已经构建过几个 skill 了,知道怎么建 | 更多控制,更慢,没有验证 |