[ PROMPT_NODE_24562 ]
Command Development 说明文档
[ SKILL_DOCUMENTATION ]
# 命令开发技能
关于创建 Claude Code 斜杠命令的综合指南,包括文件格式、前置元数据选项、动态参数及最佳实践。
## 概述
此技能提供以下方面的知识:
- 斜杠命令文件格式和结构
- YAML 前置元数据配置字段
- 动态参数 ($ARGUMENTS, $1, $2 等)
- 使用 @ 语法的文件引用
- 使用 !` 语法的 Bash 执行
- 命令组织和命名空间
- 命令开发的最佳实践
- 插件特定功能 (${CLAUDE_PLUGIN_ROOT}, 插件模式)
- 与插件组件(智能体、技能、钩子)的集成
- 验证模式和错误处理
## 技能结构
### SKILL.md (~2,470 字)
涵盖以下内容的核心技能内容:
**基础知识:**
- 命令基础和位置
- 文件格式(带可选前置元数据的 Markdown)
- YAML 前置元数据字段概述
- 动态参数($ARGUMENTS 和位置参数)
- 文件引用(@ 语法)
- Bash 执行(!` 语法)
- 命令组织模式
- 最佳实践和常见模式
- 故障排除
**插件特定:**
- ${CLAUDE_PLUGIN_ROOT} 环境变量
- 插件命令发现和组织
- 插件命令模式(配置、模板、多脚本)
- 与插件组件(智能体、技能、钩子)的集成
- 验证模式(参数、文件、资源、错误处理)
### 参考资料
详细文档:
- **frontmatter-reference.md**:完整的 YAML 前置元数据字段规范
- 所有字段描述(含类型和默认值)
- 每个字段的使用时机
- 示例和最佳实践
- 验证和常见错误
- **plugin-features-reference.md**:插件特定的命令功能
- 插件命令发现和组织
- ${CLAUDE_PLUGIN_ROOT} 环境变量的使用
- 插件命令模式(配置、模板、多脚本)
- 与插件智能体、技能和钩子的集成
- 验证模式和错误处理
### 示例
实用的命令示例:
- **simple-commands.md**:10 个完整的命令示例
- 代码审查命令
- 测试命令
- 部署命令
- 文档生成器
- Git 集成命令
- 分析和研究命令
- **plugin-commands.md**:10 个插件特定的命令示例
- 带脚本的简单插件命令
- 多脚本工作流
- 基于模板的生成
- 配置驱动的部署
- 智能体和技能集成
- 多组件工作流