Slash Command Factory

一个全面的系统，用于通过简单的基于问题的工作流程生成生产就绪的 Claude Code 斜杠命令。

这个技能做什么

这个技能通过以下方式帮助您为 Claude Code 创建自定义斜杠命令：

询问 5-7 个关于您命令需求的直接问题
生成具有适当 YAML 前置内容的完整命令 .md 文件
为常见用例提供 10 个强大的预设命令
验证命令格式和语法
创建井井有条的文件夹结构
提供安装指导

输出：准备在 Claude Code 中使用的完整斜杠命令

官方命令结构模式

这个技能根据 Anthropic 文档中的三个官方模式生成命令：

模式 A：简单（上下文 → 任务）

最适合：具有清晰输入/输出的直接任务示例：代码审查，文件更新，简单分析 官方参考：code-review.md

结构：

---
allowed-tools: Bash(git diff:*), Bash(git log:*)
description: 目的描述
---

## 上下文
- 当前状态：!`bash 命令`
- 附加数据：!`另一个命令`

## 您的任务
[带有编号步骤的清晰指令]
[成功标准]

何时使用：

简单，专注的任务
快速分析或审查
直接的工作流程
1-3 个 bash 命令用于上下文

模式 B：多阶段（发现 → 分析 → 任务）

最适合：复杂的发现和文档任务示例：代码库分析，全面审计，系统映射 官方参考：codebase-analysis.md

结构：

---
allowed-tools: Bash(find:*), Bash(tree:*), Bash(ls:*), Bash(grep:*), Bash(wc:*), Bash(du:*)
description: 全面的目的
---

# 命令标题

## 第一阶段：项目发现
### 目录结构
!`find . -type d | sort`

### 文件计数分析
!`find . -type f | wc -l`

## 第二阶段：详细分析
[更多发现命令]
[带有 @ 的文件引用]

## 第三阶段：您的任务
根据所有发现的信息，创建：

1. **可交付成果 1**
   - 小节
   - 详细信息

2. **可交付成果 2**
   - 小节
   - 详细信息

最后，将输出写入 [filename].md

何时使用：

需要全面分析
多个发现阶段
收集大量上下文
10+ bash 命令用于数据收集
生成详细的文档文件

模式 C：代理风格（角色 → 流程 → 指南）

最适合：专业专家角色和协调示例：领域专家，协调员，专业顾问 官方参考：openapi-expert.md

结构：

---
name: 命令名称
description: |
  复杂目的的多行描述
  解释专业角色
color: yellow
---

您是专注于 [领域专业知识] 的 [专业角色]。

**核心职责：**

1. **责任区 1**
   - 特定任务
   - 预期输出

2. **责任区 2**
   - 特定任务
   - 预期输出

**工作流程：**

1. [工作流程中的第 1 步]
2. [工作流程中的第 2 步]
3. [工作流程中的第 3 步]

**重要考虑因素：**

- [指南 1]
- [指南 2]
- [约束或最佳实践]

当您遇到 [场景] 时，[采取的行动]。

何时使用：

需要专业领域知识
协调复杂工作流程
协调多个子流程
作为专家顾问
需要特定的程序指南

全面命名约定

命令文件命名规则

所有斜杠命令文件必须遵循 kebab-case 约定：

格式：[verb]-[noun].md, [noun]-[verb].md, 或 [domain]-[action].md

规则：

案例：仅小写，连字符作为分隔符
长度：最多 2-4 个单词
字符：只允许 [a-z0-9-]（字母，数字，连字符）
开始/结束：必须以字母或数字开始和结束（不是连字符）
无：空格，下划线，camelCase，TitleCase 或特殊字符

转换算法

用户输入 → 命令名称

输入：“分析客户反馈并生成洞察”
↓
1. 提取动作：“分析”
2. 提取目标：“反馈”
3. 组合：“分析-反馈”
4. 验证：匹配 [a-z0-9-]+ 模式 ✓
5. 输出：analyze-feedback.md

更多示例：

“审查拉取请求” → pr-review.md 或 review-pr.md
“生成 API 文档” → api-document.md 或 document-api.md
“更新 README 文件” → update-readme.md 或 readme-update.md
“审计安全合规性” → security-audit.md 或 compliance-audit.md
“研究市场趋势” → research-market.md 或 market-research.md
“分析代码质量” → code-analyze.md 或 analyze-code.md

官方示例（来自 Anthropic 文档）

正确：

✅ code-review.md（verb-noun）
✅ codebase-analysis.md（noun-noun 复合词）
✅ update-claude-md.md（verb-noun-限定词）
✅ openapi-expert.md（domain-role）

错误：

❌ code_review.md（snake_case - 错误）
❌ CodeReview.md（PascalCase - 错误）
❌ codeReview.md（camelCase - 错误）
❌ review.md（太模糊 - 需要目标）
❌ analyze-customer-feedback-data.md（太长 - >4 个单词）

Bash 权限模式

重要规则：没有通配符

❌ 绝对不允许：

allowed-tools: Bash

这种通配符权限根据官方 Anthropic 模式是禁止的。

✅ 始终需要：

allowed-tools: Bash(git status:*), Bash(git diff:*), Bash(git log:*)

必须指定确切的命令，子命令只能使用通配符。

官方权限模式

根据 Anthropic 的文档示例：

Git 操作（code-review, update-docs）：

allowed-tools: Bash(git status:*), Bash(git diff:*), Bash(git log:*), Bash(git branch:*), Bash(git add:*), Bash(git commit:*)

文件发现（codebase-analysis）：

allowed-tools: Bash(find:*), Bash(tree:*), Bash(ls:*), Bash(du:*)

内容分析（全面发现）：

allowed-tools: Bash(grep:*), Bash(wc:*), Bash(head:*), Bash(tail:*), Bash(cat:*)

数据处理（自定义分析）：

allowed-tools: Bash(awk:*), Bash(sed:*), Bash(sort:*), Bash(uniq:*)

组合模式（多阶段命令）：

allowed-tools: Bash(find:*), Bash(tree:*), Bash(ls:*), Bash(grep:*), Bash(wc:*), Bash(du:*), Bash(head:*), Bash(tail:*), Bash(cat:*), Bash(touch:*)

权限选择指南

命令类型	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
更新	`git diff, find, grep`	update-docs, sync-config
数据处理	`awk, sed, sort, uniq`	parse-data, format-output
全面	上述全部	full-audit, system-analyze

两条生成命令的路径

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

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

商业与研究：

/research-business - 全面市场研究和竞争分析
/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 - 启动和协调多个代理以完成复杂任务

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

为您的特定需求创建一个完全自定义的命令。

问题流程（自定义路径）

问题 1：命令目的

"这个斜杠命令应该做什么？

具体说明其目的和何时使用它。

示例：

‘分析客户反馈并生成可操作的洞察’
‘生成 HIPAA 兼容的 API 文档’
‘研究市场趋势并创建内容策略’
‘从研究论文中提取关键见解’

您的命令目的：___"

问题 2：参数（自动确定）

技能根据目的自动确定您的命令是否需要参数。

如果需要参数，它们将使用 $ARGUMENTS 格式：

用户输入：/your-command argument1 argument2
命令接收：$ARGUMENTS = “argument1 argument2”

示例：

/research-business "Tesla" "EV market" → $ARGUMENTS = “Tesla EV market”
/medical-translate "Myokardinfarkt" "de" → $ARGUMENTS = “Myokardinfarkt de”

不需要用户输入 - 技能智能决定。

问题 3：使用哪些工具？

"这个命令应该使用哪些 Claude Code 工具？

可用工具：

Read - 读取文件
Write - 创建文件
Edit - 修改文件
Bash - 执行 shell 命令（必须指定确切的命令）
Grep - 搜索代码
Glob - 按模式查找文件
Task - 启动代理

重要：对于 Bash，您必须指定确切的命令，而不是通配符。

Bash 示例：

✅ Bash(git status:), Bash(git diff:), Bash(git log:*)
✅ Bash(find:), Bash(tree:), Bash(ls:*)
✅ Bash(grep:), Bash(wc:), Bash(head:*)
❌ Bash （不允许通配符，根据官方模式）

工具组合示例：

Git 命令：Read, Bash(git status:), Bash(git diff:)
代码生成器：Read, Write, Edit
发现命令：Bash(find:), Bash(tree:), Bash(grep:*)
分析命令：Read, Grep, Task（启动代理）

您的工具（逗号分隔）：___"

问题 4：代理集成

"这个命令需要启动代理来处理专业任务吗？

使用代理的示例：

复杂分析（启动 rr-architect, rr-security）
实施任务（启动 rr-frontend, rr-backend）
质量检查（启动 rr-qa, rr-test-runner）

选项：

无代理 - 命令自行处理所有内容
启动代理 - 委托给专业代理

您的选择（1 或 2）：___"

如果选择 “2”，请询问：“它应该启动哪些代理？___”

问题 5：输出类型

"这个命令应该产生什么类型的输出？

分析 - 研究报告，洞察，建议
文件 - 生成的代码，文档，配置
操作 - 执行任务，运行工作流程，部署
报告 - 包含发现和后续步骤的结构化报告

您的选择（1, 2, 3, 或 4）：___"

问题 6：模型偏好（可选）

"这个命令应该使用哪个 Claude 模型？

默认 - 继承自主对话（推荐）
Sonnet - 最适合复杂任务
Haiku - 最快，最便宜（用于简单命令）
Opus - 最大能力（用于关键任务）

您的选择（1, 2, 3, 或 4）或按 Enter 为默认：___"

问题 7：附加功能（可选）

"有任何特殊功能吗？

可选功能：

Bash 执行 - 运行 shell 命令并包含输出（!command）
文件引用 - 包含文件内容（@file.txt）
上下文收集 - 读取项目文件以获取上下文

您需要的功能（逗号分隔）或按 Enter 跳过：___"

生成过程

收集答案后：

生成 YAML 前置内容：

---
description: [来自命令目的]
argument-hint: [如果需要 $ARGUMENTS]
allowed-tools: [来自工具选择]
model: [如果指定]
---

生成命令主体：

[特定于目的的指令]

[如果使用代理]：
1. **启动 [代理名称]** 进行 [特定任务]
2. 协调工作流程
3. 验证结果

[如果使用 bash]：
- 上下文：!`bash 命令`

[如果使用文件引用]：
- 审查：@file.txt

成功标准：[基于输出类型]

创建文件夹结构：

generated-commands/[command-name]/
├── [command-name].md    # 命令文件（ROOT 级别）
├── README.md            # 安装指南（ROOT 级别）
├── TEST_EXAMPLES.md     # 测试示例（ROOT 级别 - 如适用）
└── [如果需要的文件夹]  # standards/, examples/, scripts/

验证格式：

✅ YAML 前置内容有效
✅ $ARGUMENTS 语法正确（如果使用）
✅ allowed-tools 格式正确
✅ 文件夹组织清晰

提供安装说明：

您的命令已准备好！

输出位置：generated-commands/[command-name]/

要安装：
1. 复制命令文件：
   cp generated-commands/[command-name]/[command-name].md .claude/commands/

2. 重新启动 Claude Code（如果已运行）

3. 测试：
   /[command-name] [arguments]

预设命令详情

1. /research-business

目的：全面商业和市场研究

参数：$ARGUMENTS（要研究的公司或市场）

YAML：

---
description: 全面商业和市场研究，包括竞争分析
argument-hint: [公司/市场] [行业]
allowed-tools: Read, Bash, Grep
---

它的作用：

市场规模和趋势分析
竞争对手 SWOT 分析
机会识别
行业格局概述
战略建议

2. /research-content

目的：跨平台内容趋势分析

参数：$ARGUMENTS（要研究的主题）

YAML：

---
description: 跨平台内容趋势分析，用于数据驱动的内容策略
argument-hint: [主题] [平台]
allowed-tools: Read, Bash
---

它的作用：

分析 Google, Reddit, YouTube, Medium, LinkedIn, X 等平台的趋势
用户意图分析（信息性，商业性，交易性）
内容差距识别
SEO 优化大纲生成
平台特定的发布策略

3. /medical-translate

目的：将医学术语翻译成患者友好的语言

参数：$ARGUMENTS（医学术语和语言）

YAML：

---
description: 将医学术语翻译成 8-10 年级阅读水平（德语/英语）
argument-hint: [医学术语] [de|en]
allowed-tools: Read
---

它的作用：

翻译复杂的医学术语
简化为 8-10 年级阅读水平
使用 Flesch-Kincaid（EN）或 Wiener Sachtextformel（DE）进行验证
保持临床准确性
提供患者友好的解释

4. /compliance-audit

目的：检查代码是否符合监管合规性要求

参数：$ARGUMENTS（路径和合规性标准）

YAML：

---
description: 审计代码以符合 HIPAA/GDPR/DSGVO 合规性要求
argument-hint: [代码路径] [hipaa|gdpr|dsgvo|all]
allowed-tools: Read, Grep, Task
---

它的作用：

扫描 PHI/PII 处理
检查加密要求
验证审计日志
验证数据主体权利
生成合规报告

5. /api-build

目的：生成完整的 API 集成代码

参数：$ARGUMENTS（API 名称和端点）

YAML：

---
description: 生成完整的 API 客户端，包括错误处理和测试
argument-hint: [api-name] [endpoints]
allowed-tools: Read, Write, Edit, Bash, Task
---

它的作用：

生成 API 客户端类
添加错误处理和重试
创建认证逻辑
生成单元和集成测试
添加使用文档

6. /test-auto

目的：自动生成全面的测试套件

参数：$ARGUMENTS（文件路径和测试类型）

YAML：

---
description: 自动生成全面的测试套件，并进行覆盖率分析
argument-hint: [文件路径] [unit|integration|e2e]
allowed-tools: Read, Write, Bash
---

它的作用：

分析要测试的代码
生成测试用例（快乐路径，边缘情况，错误）
添加测试夹具和模拟
计算覆盖率
提供测试文档

7. /docs-generate

目的：自动生成文档

参数：$ARGUMENTS（代码路径和文档类型）

YAML：

---
description: 从代码自动生成文档（API 文档，README，架构）
argument-hint: [代码路径] [api|readme|architecture|all]
allowed-tools: Read, Write, Grep
---

它的作用：

提取代码结构和函数
生成 API 文档
创建带有使用示例的 README
构建架构图（Mermaid）
添加代码示例

8. /knowledge-mine

目的：从文档中提取结构化见解

参数：$ARGUMENTS（文档路径和输出格式）

YAML：

---
description: 从文档中提取并结构化知识，转化为可操作的见解
argument-hint: [文档路径] [faq|summary|kb|all]
allowed-tools: Read, Grep
---

它的作用：

阅读和分析文档
提取关键见解
生成 FAQs
创建知识库文章
总结发现

9. /workflow-analyze

目的：分析和优化业务流程

参数：$ARGUMENTS（工作流程描述）

YAML：

---
description: 分析工作流程并提供优化建议
argument-hint: [工作流程描述]
allowed-tools: Read, Task
---

它的作用：

映射当前工作流程
识别瓶颈
建议自动化机会
计算效率提升
创建实施路线图

10. /batch-agents

目的：启动多个协调代理

参数：$ARGUMENTS（代理名称和任务）

YAML：

---
description: 启动和协调多个代理以完成复杂任务
argument-hint: [代理名称] [任务描述]
allowed-tools: Task
---

它的作用：

解析代理列表
平行启动代理（如果安全）或顺序启动
协调输出
集成结果
提供综合总结

输出结构

命令在项目根目录中生成：

[your-project]/
└── generated-commands/
    └── [command-name]/
        ├── [command-name].md      # 命令文件（ROOT 级别）
        ├── README.md              # 安装指南（ROOT 级别）
        ├── TEST_EXAMPLES.md       # 测试指南（ROOT 级别 - 如适用）
        │
        ├── standards/             # 仅当命令有标准时
        ├── examples/              # 仅当命令有示例时
        └── scripts/               # 仅当命令有帮助脚本时

组织规则：

所有 .md 文件在 ROOT 目录
支持文件夹分开（standards/, examples/, scripts/）
不同类型不混在同一个文件夹
清晰，层次结构

安装

生成后：

查看输出：
```
ls generated-commands/[command-name]/
```

复制到 Claude Code（准备就绪时）：

# 项目级（仅此项目）
cp generated-commands/[command-name]/[command-name].md .claude/commands/

# 用户级（所有项目）
cp generated-commands/[command-name]/[command-name].md ~/.claude/commands/

重新启动 Claude Code（如果正在运行）
测试命令：
```
/[command-name] [arguments]
```

使用示例

生成预设命令

@slash-command-factory

使用 /research-business 预设

输出：准备安装的完整商业研究命令

生成自定义医疗保健命令

@slash-command-factory

创建一个生成德国 PTV 10 治疗应用的命令

技能询问：

目的？（生成 PTV 10 应用）
工具？（Read, Write, Task）
代理？（是 - 与 health-sdk-builder 相关的代理）
输出？（文件 - 治疗应用文档）
模型？（Sonnet - 质量）

结果：/generate-ptv10 命令准备使用

创建商业智能命令

@slash-command-factory

构建一个竞争 SWOT 分析命令

技能询问 5-7 个问题 → 生成 /swot-analysis 命令 → 验证 → 准备安装

与工厂代理集成

与以下配合使用：

factory-guide（可以通过 prompts-guide 模式委托给此技能）
现有斜杠命令（/build, /validate-output 等）

补充：

skills-guide（构建 Skills）
prompts-guide（构建 Prompts）
agents-guide（构建 Agents）
slash-command-factory（构建 Commands） ← 此技能

完整的生态系统，用于构建所有 Claude Code 增强功能！

输出验证

生成的命令自动验证：

YAML 前置内容：

有 description 字段
正确的 YAML 语法
仅有效的前置内容字段

参数：

如果需要使用 $ARGUMENTS
如果使用 $ARGUMENTS，则有 argument-hint
没有 $1, $2, $3 位置参数

工具：

有效的工具名称
适当的逗号分隔格式
适合命令目的

组织：

.md 文件在根目录
文件夹正确分开
没有散乱的文件

成功标准

生成的命令应该：

✅ 有有效的 YAML 前置内容
✅ 使用 $ARGUMENTS（从不使用位置参数）
✅ 复制到 .claude/commands/ 时可以工作
✅ 使用参数时正确执行
✅ 产生预期输出
✅ 遵循组织标准

版本：1.0.0 最后更新：2025 年 10 月 28 日兼容：支持斜杠命令的所有版本 Claude Code

在几分钟内构建功能强大的自定义斜杠命令！ ⚡