slash-command-factory

斜杠命令工厂

通过简单的问答式工作流，全面生成可用于生产环境的 Claude Code 斜杠命令。

自我进化技能：此技能会在使用过程中不断改进。如果说明有误、参数发生偏移，或需要采用变通方案，请立即修复此文件，不要拖延。仅针对真实且可复现的问题进行更新。

何时使用此技能

• 为 Claude Code 创建新的自定义斜杠命令
• 根据预设生成命令模板
• 验证斜杠命令 YAML 前置元数据的语法
• 将命令整理到合适的文件夹结构中
• 将工作流转换为可重复使用的斜杠命令

---

概述

此技能可通过以下方式帮助你为 Claude Code 创建自定义斜杠命令：

• 询问 5-7 个关于命令需求的简单问题
• 生成包含正确 YAML 前置元数据的完整命令 .md 文件
• 提供 10 个适用于常见用例的强大预设命令
• 验证命令格式和语法
• 创建组织良好的文件夹结构
• 提供安装指南

输出：可直接在 Claude Code 中使用的完整斜杠命令

---

命令结构模式

Anthropic 文档中的三种官方模式：

模式	名称	最适合的场景	结构
A	简单	简单任务（代码审查、文件更新）	上下文 -> 任务
B	多阶段	复杂探索（审计、系统映射）	探索 -> 分析 -> 任务
C	Agent 风格	专业角色（专家、协调者）	角色 -> 流程 -> 指南

完整模板及适用场景指南：命令模式

---

命名约定

所有斜杠命令文件必须遵循 kebab-case：[verb]-[noun].md

规则：仅使用小写字母，包含 2-4 个单词，使用 [a-z0-9-] 字符，不使用下划线或 camelCase

输入	输出
“审查拉取请求”	pr-review.md
“生成 API 文档”	api-document.md
“审计安全合规性”	security-audit.md

完整的转换算法和示例：命名约定

---

Bash 权限规则

重要：禁止授予不加限制的 Bash 权限。必须精确到子命令级别。

# WRONG - too broad
allowed-tools: Bash(git:*)

# CORRECT - subcommand-level
allowed-tools: Bash(git add:*), Bash(git commit:*), Bash(git push:*)

# OK - simple commands without subcommand hierarchies
allowed-tools: Bash(cp:*), Bash(mkdir -p:*), Bash(date:*)

命令类型	Bash 权限	示例命令
Git 命令	git status, git diff, git log, git branch	code-review, commit-assist
探索	find, tree, ls, du	codebase-analyze, structure-map
分析	grep, wc, head, tail, cat	search-code, count-lines
数据处理	awk, sed, sort, uniq	parse-data, format-output

完整模式及选择指南：Bash 权限

---

生成命令的两种途径

路径 1：快速启动预设（30 秒）

从 10 个强大的预设命令中选择：

#	命令	用途
1	/research-business	全面的市场调研和竞争分析
2	/research-content	多平台内容趋势分析和 SEO 策略
3	/medical-translate	将医学术语转换为适合 8 至 10 年级的表述（德语/英语）
4	/compliance-audit	HIPAA/GDPR/DSGVO 合规性验证
5	/api-build	包含测试的完整 API 集成代码
6	/test-auto	自动生成全面的测试套件
7	/docs-generate	自动创建文档
8	/knowledge-mine	从文档中提取并整理见解
9	/workflow-analyze	分析并优化业务流程
10	/batch-agents	启动并协调多个 Agent

完整的 YAML 配置和详细信息：预设命令

路径 2：自定义命令（5-7 个问题）

回答以下问题，即可创建完全自定义的命令：

1. 用途 - 命令应执行什么操作？
2. 参数 - 自动确定；所有标志都必须带有简短形式（-b|--branch）
3. 工具 - 使用哪些 Claude Code 工具（Read、Write、Bash、Grep、Task 等）
4. Agent - 是否需要启动专用 Agent？
5. 输出 - 分析、文件、操作还是报告？
6. 模型 - Default、Sonnet、Haiku 还是 Opus？（可选）
7. 功能 - Bash 执行、文件引用、上下文收集？（可选）

完整的问题脚本和参数约定：问题流程

---

生成与安装

收集完答案后，该技能将：

1. 生成包含适当 allowed-tools 的 YAML frontmatter
2. 根据用途生成带有相应指令的命令正文
3. 在 generated-commands/[command-name]/ 下创建文件夹结构
4. 验证格式（YAML、参数、工具、组织结构）
5. 提供安装说明

# Install to project
cp generated-commands/[command-name]/[command-name].md .claude/commands/

# Install globally
cp generated-commands/[command-name]/[command-name].md ~/.claude/commands/

插件调用：/plugin-name:command-name [arguments]

完整流程、文件夹结构和插件调用规则：生成流程

---

验证

每条生成的命令都会针对以下内容进行验证：

• 有效的 YAML frontmatter（语法正确，包含必填字段）
• 正确的参数格式（使用 $ARGUMENTS，而非 $1 $2 $3）
• 所有标志都有简短形式（必须提供 1-2 个字母的快捷形式）
• Bash 子命令级别的具体权限（不使用宽泛的 Bash）
• 清晰的文件夹组织结构

如果验证失败，你会收到具体的修复说明。

完整的验证清单、最佳实践和故障排除：验证参考

---

快速参考

用法

@slash-command-factory
Use the /research-business preset

@slash-command-factory
Create a custom command for analyzing customer feedback

关键规则

规则	详细信息
参数	始终使用 $ARGUMENTS（绝不使用 $1、$2）
标志简短形式	所有标志都必须提供（-b|--branch）
Bash 权限	仅限子命令级别（Bash(git add:*)）
文件命名	kebab-case，2-4 个单词
输出位置	./generated-commands/[command-name]/

生态系统集成

适用于：factory-guide、skills-guide、prompts-guide、agents-guide

更多示例和集成详情：使用示例

执行后反思

此技能执行完毕后，关闭前请检查：

1. 命令是否成功？ — 如果没有，修复导致失败的指令或错误表。
2. 参数或输出是否发生变化？ — 如果底层工具的接口发生偏移，请更新 Usage 示例和 Parameters 表以保持一致。
3. 是否需要变通方案？ — 如果你不得不临时调整（更换标志、增加步骤），请更新此 SKILL.md，以便下次调用时无需采用相同的变通方案。

只有问题确实存在且可复现时才进行更新，不要基于猜测更新。