AI 插件开发工具插件系统【免费下载链接】claude-plugins-officialOfficial, Anthropic-managed directory of high quality Claude Code Plugins.项目地址https://gitcode.com/GitHub_Trending/cl/claude-plugins-official点击查看免费下载本文以plugins/plugin-dev工具包中的command-development技能为核心系统讲解 Claude Code 斜杠命令Slash Command的完整开发方法Markdown 文件格式、YAML frontmatter 配置、动态参数与文件引用、Bash 内联执行、命令组织与命名空间以及插件特有的${CLAUDE_PLUGIN_ROOT}、组件集成、输入校验与测试发布流程。读完本文你将能够从零创建可复用的个人/团队命令并写出达到插件分发质量标准的专业命令。该技能位于 plugins/plugin-dev/skills/command-development/README.md由核心 SKILL.md、7 篇参考文档与 2 个示例文件组成是 Claude Code 插件开发工具包见 plugin-dev 总览中专门负责斜杠命令的子技能。什么是斜杠命令斜杠命令Slash Command是定义为 Markdown 文件的一段高频复用提示词prompt用户输入/command-name即可触发Claude Code 会把文件内容作为指令执行。它带来的核心价值包括可复用性定义一次反复使用一致性将常见工作流标准化共享性可在团队或项目间分发效率快速访问复杂提示词。关键认知命令是写给 Claude 的指令命令是供 Agent 消费的不是供人阅读的。当用户调用/command-name时命令内容会变成 Claude 的指令因此必须写成告诉 Claude 去做什么的祈使句而不是向用户介绍会发生什么的说明文字。正确写法给 Claude 的指令Review this code for security vulnerabilities including: - SQL injection - XSS attacks - Authentication issues Provide specific line numbers and severity ratings.错误写法写给用户的消息This command will review your code for security issues. Youll receive a report with vulnerability details.第一段例子告诉 Claude 要做什么第二段只是向用户描述功能并没有给 Claude 下达指令。始终采用第一种写法examples/simple-commands.md中也反复强调这一点。命令存放位置类型位置作用域/help中的标注适用场景项目命令.claude/commands/仅在特定项目可用(project)团队工作流、项目专属任务个人命令~/.claude/commands/所有项目可用(user)个人工作流、跨项目工具插件命令plugin-name/commands/插件安装后可用(plugin-name)插件专属功能文件格式与 YAML Frontmatter命令是以.md为扩展名的 Markdown 文件.claude/commands/ ├── review.md # /review 命令 ├── test.md # /test 命令 └── deploy.md # /deploy 命令最基本的命令可以完全不需要 frontmatter直接写提示词即可。需要配置时在文件顶部用 YAML frontmatter 声明元数据--- description: Review code for security issues allowed-tools: Read, Grep, Bash(git:*) model: sonnet --- Review this code for security vulnerabilities...注意README.md与 SKILL.md 均指出.claude/commands/目录属于旧版格式对于新建技能优先使用.claude/skills/name/SKILL.md目录格式。两种格式加载方式完全相同差异仅在文件布局上。Frontmatter 字段速查字段用途示例description/help中显示的简短描述Review code for issuesallowed-tools限制可用的工具Read, Bash(git:*)model指定执行模型sonnet、opus、haikuargument-hint文档化参数提示自动补全[pr-number] [priority]disable-model-invocation仅允许手动调用的命令true所有字段均可选命令没有 frontmatter 也能正常工作。完整的字段规格参见 frontmatter-reference.md下面逐一深入。description类型String默认值命令提示词的第一行显示在/help输出中建议60 字符以内frontmatter 参考文档推荐上限测试脚本中 80 字符为告警线最佳实践以动词开头Review、Deploy、Generate具体说明命令做什么避免冗余的command/slash command字样反例This command reviews PRs多余的This command、Review过于笼统allowed-tools类型String 或字符串数组默认值继承会话权限作用限制命令可使用的工具集是命令安全性的关键控制点支持多种写法allowed-tools: Read # 单一工具 allowed-tools: Read, Write, Edit # 逗号分隔 allowed-tools: # 数组形式 - Read - Write - Bash(git:*)Bash 命令过滤器是重点Bash(git:*)只允许 git 命令、Bash(npm:*)只允许 npm 命令、Bash(docker:*)只允许 docker 命令。参考文档明确反对不加过滤的allowed-tools: *全放行几乎用不到并给出了更精细的写法如allowed-tools: Bash(git status:*), Bash(git diff:*)。最佳实践尽可能限制least privilegeBash 必须加命令过滤器而不是裸*仅在与会话权限不同时才显式指定model类型String可选值sonnet、opus、haiku默认值继承会话用途与取舍haiku简单、公式化任务追求速度如格式化代码sonnet标准工作流速度与质量均衡默认opus复杂分析、架构决策、深度代码理解最佳实践无特殊需求可省略能用haiku就用把opus留给真正复杂的任务通过实测不同模型找到平衡点argument-hint类型String默认值无作用为自动补全与用户文档化期望参数提升命令可发现性argument-hint: [pr-number] [priority] [assignee] argument-hint: [source-branch] [target-branch] [commit-message]最佳实践每个参数用方括号[]包裹使用描述性名称而非arg1在描述中区分必选/可选顺序必须与命令中$1、$2的位置对应disable-model-invocation类型Boolean默认值false作用禁止 SlashCommand 工具以编程方式调用该命令适用场景详见 frontmatter-reference.md仅手动命令需要人类判断如生产环境审批破坏性操作不可逆操作如删除全部测试数据交互式工作流需要用户输入的引导流程。注意该字段应谨慎使用会限制 Claude 的自主性并在命令注释中说明原因。一个完整的复杂命令示例--- description: Deploy application to environment argument-hint: [app-name] [environment] [version] allowed-tools: Bash(kubectl:*), Bash(helm:*), Read model: sonnet --- Deploy $1 to $2 environment using version $3 Pre-deployment checks: - Verify $2 configuration - Check cluster status: !kubectl cluster-info - Validate version $3 exists Proceed with deployment following deployment runbook.动态参数$ARGUMENTS 与位置参数$ARGUMENTS捕获全部参数$ARGUMENTS将用户输入的所有参数作为单个字符串注入--- description: Fix issue by number argument-hint: [issue-number] --- Fix issue #$ARGUMENTS following our coding standards and best practices.输入/fix-issue 123展开为Fix issue #123 following our coding standards...。位置参数$1、$2、$3逐个捕获参数--- description: Review PR with priority and assignee argument-hint: [pr-number] [priority] [assignee] --- Review pull request #$1 with priority level $2. After review, assign to $3 for follow-up.输入/review-pr 123 high alice展开为Review pull request #123 with priority level high. After review, assign to alice for follow-up.组合使用可以混合位置参数与剩余参数Deploy $1 to $2 environment with options: $3输入/deploy api staging --force --skip-tests展开为Deploy api to staging environment with options: --force --skip-tests。高级参数处理advanced-workflows.md 提供了更高级的参数模式带默认值的可选参数使用 Bash 参数展开语法Environment: ${1:-staging} Version: ${2:-latest} Deploying ${2:-latest} to ${1:-staging}...参数缩写展开case映射case $1 in d|dev) ENVdevelopment;; s|stg) ENVstaging;; p|prod) ENVproduction;; *) ENV$1;; esac文件引用 语法在命令中写path/to/fileClaude 会在处理命令前先读取该文件内容--- description: Review specific file argument-hint: [file-path] --- Review $1 for: - Code quality - Best practices - Potential bugs输入/review-file src/api/users.tsClaude 会先读取src/api/users.ts再执行命令。多个文件引用Compare src/old-version.js with src/new-version.js Identify: - Breaking changes - New features - Bug fixes静态文件引用不依赖参数Review package.json and tsconfig.json for consistency Ensure: - TypeScript version matches - Dependencies are aligned - Build configuration is correct文件引用最佳实践使用清晰明确的路径对缺失文件做优雅处理使用项目相对路径需要模式匹配时考虑 Glob 工具。Bash 执行! 语法命令可以在提示词中内联执行 Bash 命令动态收集上下文仓库状态、环境信息等再交给 Claude 处理。语法为反引号包裹的命令--- description: Show Git status allowed-tools: Bash(git:*) --- Current status: !git status Recent commits: !git log --oneline -5使用时机注入动态上下文git 状态、环境变量等收集项目/仓库当前状态构建上下文感知的工作流注意事项完整语法与示例见 plugin-features-reference.md限制 Bash 作用域用Bash(git:*)而非Bash(*)避免破坏性操作处理命令失败情况保持命令快速长时间运行会拖慢调用命令组织与命名空间扁平结构适合 5-15 个命令、无明确分类的小型命令集.claude/commands/ ├── build.md ├── test.md ├── deploy.md ├── review.md └── docs.md命名空间结构适合 15 个命令、有明确分类的场景子目录名会成为命名空间并显示在/help中.claude/commands/ ├── ci/ │ ├── build.md # /build (project:ci) │ ├── test.md # /test (project:ci) │ └── lint.md # /lint (project:ci) ├── git/ │ ├── commit.md # /commit (project:git) │ └── pr.md # /pr (project:git) └── docs/ ├── generate.md # /generate (project:docs) └── publish.md # /publish (project:docs)命名空间带来逻辑分组、/help可读性、避免名称冲突等收益。插件专属特性${CLAUDE_PLUGIN_ROOT}插件命令可以访问环境变量${CLAUDE_PLUGIN_ROOT}它在运行时解析为插件目录的绝对路径。这解决了插件命令跨安装、跨系统移植的问题——不需要硬编码任何路径。主要用途详见 plugin-features-reference.md可移植地引用插件文件执行插件脚本加载插件配置访问插件模板常见模式# 执行插件脚本 !bash ${CLAUDE_PLUGIN_ROOT}/scripts/script.sh # 加载插件配置 ${CLAUDE_PLUGIN_ROOT}/config/settings.json # 使用插件模板 ${CLAUDE_PLUGIN_ROOT}/templates/report.md # 访问插件资源 ${CLAUDE_PLUGIN_ROOT}/docs/reference.md展开示例!node ${CLAUDE_PLUGIN_ROOT}/scripts/analyze.js展开为 !node /path/to/plugins/plugin-name/scripts/analyze.js。使用规范所有插件内部路径一律使用${CLAUDE_PLUGIN_ROOT}例如${CLAUDE_PLUGIN_ROOT}/templates/foo.md是正确写法而./templates/foo.md相对于当前目录而非插件是错误写法。参考文档还强调验证文件存在test -f、在注释中记录插件文件结构、与参数组合使用!${CLAUDE_PLUGIN_ROOT}/bin/process.sh $1 $2。排查要点变量不展开时检查命令是否确实从插件加载、Bash 执行是否被允许、语法是否为精确的${CLAUDE_PLUGIN_ROOT}文件找不到时核对路径相对于插件根目录是否正确、权限是否允许读取/执行。插件命令的自动发现与命名空间插件命令在加载时从commands/目录自动发现无需手动注册plugin-name/ ├── commands/ │ ├── foo.md # /foo (plugin:plugin-name) │ ├── bar.md # /bar (plugin:plugin-name) │ └── utils/ │ └── helper.md # /helper (plugin:plugin-name:utils) └── plugin.json子目录即命名空间/security (plugin:plugin-name:review)、/staging (plugin:plugin-name:deploy)等。插件有 5 个命令时建议使用子目录分组。命名约定使用描述性动作名称避免通用名称test、run考虑加插件名前缀保证唯一性多词名称用连字符。好例子/mylyn-sync、/analyze-performance、/docker-compose-up坏例子/test、/run、/do-stuff。插件命令模式plugin-features-reference.md 归纳了五类插件命令模式1. 配置驱动命令——每次调用都加载一致的插件配置--- description: Deploy using plugin settings allowed-tools: Read, Bash(*) --- Load configuration: ${CLAUDE_PLUGIN_ROOT}/deploy-config.json Deploy to $1 environment using: 1. Configuration settings above 2. Current git branch: !git branch --show-current 3. Application version: !cat package.json | grep version Execute deployment and monitor progress.2. 模板生成命令——用插件模板产出标准化文档--- description: Generate documentation from template argument-hint: [component-name] --- Template: ${CLAUDE_PLUGIN_ROOT}/templates/component-docs.md Generate documentation for $1 component following the template structure.3. 多脚本工作流——编排多个插件脚本--- description: Complete build and test workflow allowed-tools: Bash(*) --- Build: !bash ${CLAUDE_PLUGIN_ROOT}/scripts/build.sh Validate: !bash ${CLAUDE_PLUGIN_ROOT}/scripts/validate.sh Test: !bash ${CLAUDE_PLUGIN_ROOT}/scripts/test.sh Review all outputs and report: 1. Build status 2. Validation results 3. Test results 4. Recommended next steps4. 环境感知命令——按环境加载不同配置Environment config: ${CLAUDE_PLUGIN_ROOT}/config/$1.json5. 插件数据管理——在插件缓存目录持久化数据Cache directory: ${CLAUDE_PLUGIN_ROOT}/cache/ Analyze $1 and save results to cache: !mkdir -p ${CLAUDE_PLUGIN_ROOT}/cache date ${CLAUDE_PLUGIN_ROOT}/cache/last-run.txt与插件组件集成命令可以与插件的其他组件agents、skills、hooks协同构建强大工作流。集成 Agent在提示词中指名启动插件 agentClaude 会通过 Task 工具启动--- description: Deep code review argument-hint: [file-path] --- Initiate comprehensive review of $1 using the code-reviewer agent. Agent uses plugin resources: - ${CLAUDE_PLUGIN_ROOT}/config/rules.json - ${CLAUDE_PLUGIN_ROOT}/checklists/review.md要点agent 必须存在于plugin/agents/目录文档化 agent 能力引用 agent 使用的插件资源。集成 Skill通过指名技能名称触发插件技能--- description: Document API with standards argument-hint: [api-file] --- Document API in $1 following plugin standards. Use the api-docs-standards skill to ensure: - Complete endpoint documentation - Consistent formatting - Example quality - Error documentation要点技能必须存在于plugin/skills/目录说明技能提供的价值。协调 Hook命令可以准备状态供 hook 处理hook 在工具事件上自动执行命令应文档化预期的 hook 行为引导 Claude 解读 hook 输出多组件工作流结合脚本、agent、技能、模板的四阶段审查--- description: Comprehensive review workflow argument-hint: [file] allowed-tools: Bash(node:*), Read --- Target: $1 Phase 1 - Static Analysis: !node ${CLAUDE_PLUGIN_ROOT}/scripts/lint.js $1 Phase 2 - Deep Review: Launch code-reviewer agent for detailed analysis. Phase 3 - Standards Check: Use coding-standards skill for validation. Phase 4 - Report: Template: ${CLAUDE_PLUGIN_ROOT}/templates/review.md Compile findings into report following template.完整的实战示例10 个插件命令脚本分析、模板生成、多脚本发布流程、配置驱动部署、agent/技能集成、多组件审查、输入校验、环境感知等见 examples/plugin-commands.md。校验模式与错误处理命令应在处理前校验输入与资源详见 SKILL.md 的 Validation Patterns 与 plugin-features-reference.md。参数校验用 Bash 校验参数格式--- description: Deploy with validation argument-hint: [environment] --- Validate environment: !echo $1 | grep -E ^(dev|staging|prod)$ || echo INVALID If $1 is valid environment: Deploy to $1 Otherwise: Explain valid environments: dev, staging, prod Show usage: /deploy [environment]更细的写法还会使用$IF(...)条件结构在plugin-features-reference.md中展示$IF($1 in [dev, staging, prod], Deploy to $1 environment using validated configuration, ERROR: Invalid environment $1. Must be one of: dev, staging, prod )文件存在性检查Check file exists: !test -f $1 echo EXISTS || echo MISSING If file exists: Process configuration: $1 Otherwise: Explain where to place config file Show expected format Provide example configuration插件资源校验Validate plugin setup: - Script: !test -x ${CLAUDE_PLUGIN_ROOT}/bin/analyze echo ✓ || echo ✗ - Config: !test -f ${CLAUDE_PLUGIN_ROOT}/config.json echo ✓ || echo ✗ If all checks pass, run analysis. Otherwise, report missing components.错误处理Execute build: !bash ${CLAUDE_PLUGIN_ROOT}/scripts/build.sh 21 || echo BUILD_FAILED If build succeeded: Report success and output location If build failed: Analyze error output Suggest likely causes Provide troubleshooting steps最佳实践尽早校验提供有帮助的错误消息建议纠正动作优雅处理边界情况。常用命令模式速览examples/simple-commands.md提供了 10 个可直接使用的命令示例代码审查、安全审查、测试、文档生成、Git 状态、部署、文件对比、快速修复、调研、代码讲解并归纳了核心模式只读分析模式allowed-tools: Read, Grep——用于代码审查、文档、分析Git 操作模式allowed-tools: Bash(git:*)单参数模式argument-hint: [target]Process $1...多参数模式argument-hint: [source] [target] [options]快速执行模式model: haiku文件对比模式Compare $1 with $2...上下文收集模式Context: !git status Files: file1 file2交互式命令AskUserQuestion部分命令需要参数无法表达的输入多选项权衡、多选、需解释的决策、偏好收集。此时应在命令执行中使用AskUserQuestion 工具而不是依赖命令参数。完整指南见 interactive-commands.md。何时用 AskUserQuestion需要解释的多选决策、复杂选项、多选场景、偏好收集、根据回答自适应的工作流。何时用命令参数简单值文件路径、数字、名称、用户已知的输入、需要自动化的可脚本化工作流、快速调用提问会拖慢速度。工具参数结构{ questions: [ { question: Which authentication method should we use?, header: Auth method, // 短标签最多 12 字符 multiSelect: false, // true 表示多选 options: [ { label: OAuth 2.0, description: Industry standard, supports multiple providers }, { label: JWT, description: Stateless, good for APIs } ] } ] }要点用户始终可以选 Other 自定义输入自动提供multiSelect: true允许多选每个问题 2-4 个选项每次调用可问 1-4 个问题。基础交互命令骨架--- description: Interactive setup command allowed-tools: AskUserQuestion, Write --- # Interactive Plugin Setup ## Step 1: Gather Configuration Use the AskUserQuestion tool to ask: **Question 1 - Deployment target:** - header: Deploy to - question: Which deployment platform will you use? - options: - AWS (Amazon Web Services with ECS/EKS) - GCP (Google Cloud with GKE) - Azure (Microsoft Azure with AKS) - Local (Docker on local machine) ## Step 2: Process Answers [解析回答生成配置] ## Step 3: Generate Configuration [创建 .claude/plugin-name.local.md] ## Step 4: Confirm and Next Steps问题设计原则问题具体明确header 不超过 12 字符选项描述说明取舍1-2 句每问 2-4 个选项多选仅用于任意组合语义功能选择互斥选择如数据库引擎绝不能用 multiSelect问题逻辑顺序自然后面问题可基于前面回答条件流、渐进式披露。参考文档还给出了完整的多 Agent 启动、校验循环、增量配置构建、上下文感知提问等高级模式。高级工作流与状态管理advanced-workflows.md 覆盖多步命令序列与组合模式顺序工作流编号步骤 决策点如 PR 审查四步流程状态携带工作流用.claude/deployment-state.local.md之类文件在多次调用间维持状态初始化 → 测试 → 构建 → 部署 → 清理条件分支根据分支类型、测试结果、环境动态决定流程命令组合元命令编排简单子命令/format-code→/lint-code→/test-all管道模式命令消费前序命令输出并行执行同时运行多项校验并汇总工作流协调标志文件跨命令通信、锁文件防止并发部署错误处理优雅失败、自动回滚、检查点恢复状态文件的典型形态YAML frontmatter Markdown 正文--- workflow: deployment stage: testing started: 2025-01-15T10:30:00Z environment: staging branch: feature/new-api commit: abc123def tests_passed: false build_complete: false --- # Deployment Workflow State Current stage: Testing Completed steps: - ✅ Validation - ✅ Branch check - ⏳ Testing (in progress)设计原则明确编号步骤并显示当前位置显式状态而非隐式依赖提供决策点优雅处理失败命令单一职责、可组合、接口标准、松耦合。命令测试策略testing-strategies.md 定义了分层测试体系Level 1 - 语法与结构校验检查 YAML frontmatter 语法---标记应为 2 个、.md扩展名、文件位置。参考文档提供了可复用的validate-command.sh脚本。Level 2 - Frontmatter 字段校验model必须是 sonnet/opus/haiku、description长度告警80 字符、allowed-tools格式。Level 3 - 手动调用claude --debug启动 →/help确认命令出现 → 无参数调用检查行为 → 带参数调用 → 查看~/.claude/debug-logs/latest。Level 4 - 参数测试矩阵无参、单参、多参、多余参数、带引号空格、空参数六种用例。Level 5 - 文件引用测试单文件、不存在文件、多文件、大文件100MB。Level 6 - Bash 执行测试正常输出、禁止命令被拦截Bash(echo:*)下执行ls -la /应被拒绝。Level 7 - 集成测试命令 hook 联动、多命令序列、命令 MCP 工具。自动化手段测试套件脚本、pre-commit 钩子git diff --cached检查.claude/commands/*.md、CI 工作流validate-command.shvalidate-frontmatter.sh TODO 检查。边界与性能空参数、特殊字符、长参数10000 字符、特殊路径、失败命令exit 1、false、响应时间快速命令建议 3 秒、资源占用监控。参考文档还提供了完整的发布前测试清单结构/功能/边界/集成/质量/分发六类以及常见失败命令不出现、参数不替换、Bash 不执行、文件引用失效的调试步骤。文档化与市场分发documentation-patterns.md 强调命令应自文档化——把文档嵌入命令本身完整模板frontmatter 注释块COMMAND/VERSION/AUTHOR/PURPOSE/USAGE/ARGUMENTS/EXAMPLES/REQUIREMENTS/RELATED COMMANDS/TROUBLESHOOTING/CHANGELOG 命令实现内联注释段落!-- SECTION 1: VALIDATION --标记复杂逻辑决策点文档!-- DECISION POINT: 需要用户确认 --说明风险内置 help 子命令/command help返回用法与子命令列表有帮助的错误消息说明发生了什么、常见原因、建议操作维护文档版本与变更日志、依赖、性能、安全考量、测试、未来改进配套 README安装、用法、参数、示例、配置、排错marketplace-considerations.md 面向市场分发场景跨平台兼容用uname检测平台避免平台特定命令如 macOS 的pbcopy应做多平台降级最少依赖命令启动时检查 git/jq/node 是否可用并给出安装指引优雅降级检测 gh/docker 等可选功能缺失时提示受限功能面向陌生用户首次运行引导、防呆错误处理hlep → Did you mean: help?、诊断信息命名空间避免冲突插件前缀命名 记录命名决策可配置性读取.claude/plugin-name.local.md中的用户偏好提供合理默认值版本兼容命令版本声明、插件版本检查、弃用警告幂等与原子性标志文件防重复执行、临时目录 mv原子应用发布前检查清单三平台验证、无硬编码路径、无 TODO、README 完整、反馈机制开发工作流与最佳实践总结五步开发流程来自 README.md设计命令定义目的与范围确定必需参数识别所需工具创建文件选择合适位置以命令名创建.md文件编写基础提示词添加 frontmatter从最小仅 description开始按需添加字段allowed-tools 等用 argument-hint 文档化参数测试命令以/command-name调用验证参数检查 Bash 执行测试文件引用打磨提升提示词清晰度处理边界情况在注释中添加示例文档化依赖最佳实践清单单一职责一个命令、一个清晰目的清晰描述保证在/help中可发现文档化参数始终使用 argument-hint最小工具权限使用最受限的 allowed-tools充分测试验证所有特性可用添加注释解释复杂逻辑处理错误考虑缺失参数/文件的情形命令命名推荐动词-名词模式review-pr、fix-issue、gen-api-docs。参数处理上要校验必需参数、提供默认值、说明期望格式、处理缺失/无效参数的边界情况。技能体系定位与触发在 plugin-dev 工具包 中command-development 与 hook-development、mcp-integration、plugin-structure、plugin-settings、agent-development、skill-development 并列为七大技能采用三层渐进式披露元数据始终加载的强触发描述→ 核心 SKILL.md触发时加载约 1,500-2,000 词→ 参考文档/示例按需加载。Claude Code 会在用户提出以下诉求时自动加载本技能要求创建斜杠命令/添加命令/编写自定义命令、需要定义命令参数、询问命令 frontmatter 或 YAML 配置、需要组织命令或使用命名空间、创建带文件引用的命令、询问命令中的 Bash 执行、需要命令开发最佳实践等。参考文档按主题组织frontmatter 规格、插件特性、交互命令、高级工作流、测试策略、文档模式、市场考量示例文件simple-commands.md 与 plugin-commands.md提供了共 20 个可直接套用的完整命令。安装插件可通过/plugin install plugin-devclaude-code-marketplace或开发模式cc --plugin-dir /path/to/plugin-dev完成。常见故障排查速查症状检查项命令不出现文件是否在正确目录.md扩展名Markdown 格式有效重启 Claude Code参数不生效$1/$2语法正确argument-hint 与用法匹配无多余空格Bash 执行失败allowed-tools 包含 Bash反引号语法正确先在终端测试命令检查权限文件引用失效语法正确路径有效允许 Read 工具使用绝对或项目相对路径${CLAUDE_PLUGIN_ROOT}不展开命令确实从插件加载允许 Bash 执行语法精确为${CLAUDE_PLUGIN_ROOT}从单文件的基础命令到插件级的多组件工作流本文覆盖了斜杠命令开发的完整路径。要深入学习每个主题可继续阅读上述各参考文档与示例文件——它们本身就是按渐进式披露原则组织的可复用知识资产。赞分享AI 插件开发工具插件系统【免费下载链接】claude-plugins-officialOfficial, Anthropic-managed directory of high quality Claude Code Plugins.项目地址https://gitcode.com/GitHub_Trending/cl/claude-plugins-official点击查看免费下载相关推荐Claude Code 斜杠命令Slash Command开发完全指南文件格式、Frontmatter 配置与插件集成实战Claude Code 斜杠命令Slash Command开发完全指南文件格式、Frontmatter 配置与插件集成实战 本文基于 Claude CodAI 应用AI 技能/插件开发工具Claude Code 插件命令实战指南十种插件斜杠命令模式与 CLAUDE_PLUGIN_ROOT 工程实践Claude Code 插件命令实战指南十种插件斜杠命令模式与 CLAUDE_PLUGIN_ROOT 工程实践 本篇技术指南以 claude pluginsAI 插件开发工具插件系统Claude Code 插件斜杠命令开发完全指南frontmatter、动态参数、Bash 执行与插件集成实战Claude Code 插件斜杠命令开发完全指南frontmatter、动态参数、Bash 执行与插件集成实战 本文基于 plugins/plugin devAI 插件开发工具插件系统创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
Claude Code 插件斜杠命令开发完全指南：从 Markdown 文件格式到插件级工作流
AI 插件开发工具插件系统【免费下载链接】claude-plugins-officialOfficial, Anthropic-managed directory of high quality Claude Code Plugins.项目地址https://gitcode.com/GitHub_Trending/cl/claude-plugins-official点击查看免费下载本文以plugins/plugin-dev工具包中的command-development技能为核心系统讲解 Claude Code 斜杠命令Slash Command的完整开发方法Markdown 文件格式、YAML frontmatter 配置、动态参数与文件引用、Bash 内联执行、命令组织与命名空间以及插件特有的${CLAUDE_PLUGIN_ROOT}、组件集成、输入校验与测试发布流程。读完本文你将能够从零创建可复用的个人/团队命令并写出达到插件分发质量标准的专业命令。该技能位于 plugins/plugin-dev/skills/command-development/README.md由核心 SKILL.md、7 篇参考文档与 2 个示例文件组成是 Claude Code 插件开发工具包见 plugin-dev 总览中专门负责斜杠命令的子技能。什么是斜杠命令斜杠命令Slash Command是定义为 Markdown 文件的一段高频复用提示词prompt用户输入/command-name即可触发Claude Code 会把文件内容作为指令执行。它带来的核心价值包括可复用性定义一次反复使用一致性将常见工作流标准化共享性可在团队或项目间分发效率快速访问复杂提示词。关键认知命令是写给 Claude 的指令命令是供 Agent 消费的不是供人阅读的。当用户调用/command-name时命令内容会变成 Claude 的指令因此必须写成告诉 Claude 去做什么的祈使句而不是向用户介绍会发生什么的说明文字。正确写法给 Claude 的指令Review this code for security vulnerabilities including: - SQL injection - XSS attacks - Authentication issues Provide specific line numbers and severity ratings.错误写法写给用户的消息This command will review your code for security issues. Youll receive a report with vulnerability details.第一段例子告诉 Claude 要做什么第二段只是向用户描述功能并没有给 Claude 下达指令。始终采用第一种写法examples/simple-commands.md中也反复强调这一点。命令存放位置类型位置作用域/help中的标注适用场景项目命令.claude/commands/仅在特定项目可用(project)团队工作流、项目专属任务个人命令~/.claude/commands/所有项目可用(user)个人工作流、跨项目工具插件命令plugin-name/commands/插件安装后可用(plugin-name)插件专属功能文件格式与 YAML Frontmatter命令是以.md为扩展名的 Markdown 文件.claude/commands/ ├── review.md # /review 命令 ├── test.md # /test 命令 └── deploy.md # /deploy 命令最基本的命令可以完全不需要 frontmatter直接写提示词即可。需要配置时在文件顶部用 YAML frontmatter 声明元数据--- description: Review code for security issues allowed-tools: Read, Grep, Bash(git:*) model: sonnet --- Review this code for security vulnerabilities...注意README.md与 SKILL.md 均指出.claude/commands/目录属于旧版格式对于新建技能优先使用.claude/skills/name/SKILL.md目录格式。两种格式加载方式完全相同差异仅在文件布局上。Frontmatter 字段速查字段用途示例description/help中显示的简短描述Review code for issuesallowed-tools限制可用的工具Read, Bash(git:*)model指定执行模型sonnet、opus、haikuargument-hint文档化参数提示自动补全[pr-number] [priority]disable-model-invocation仅允许手动调用的命令true所有字段均可选命令没有 frontmatter 也能正常工作。完整的字段规格参见 frontmatter-reference.md下面逐一深入。description类型String默认值命令提示词的第一行显示在/help输出中建议60 字符以内frontmatter 参考文档推荐上限测试脚本中 80 字符为告警线最佳实践以动词开头Review、Deploy、Generate具体说明命令做什么避免冗余的command/slash command字样反例This command reviews PRs多余的This command、Review过于笼统allowed-tools类型String 或字符串数组默认值继承会话权限作用限制命令可使用的工具集是命令安全性的关键控制点支持多种写法allowed-tools: Read # 单一工具 allowed-tools: Read, Write, Edit # 逗号分隔 allowed-tools: # 数组形式 - Read - Write - Bash(git:*)Bash 命令过滤器是重点Bash(git:*)只允许 git 命令、Bash(npm:*)只允许 npm 命令、Bash(docker:*)只允许 docker 命令。参考文档明确反对不加过滤的allowed-tools: *全放行几乎用不到并给出了更精细的写法如allowed-tools: Bash(git status:*), Bash(git diff:*)。最佳实践尽可能限制least privilegeBash 必须加命令过滤器而不是裸*仅在与会话权限不同时才显式指定model类型String可选值sonnet、opus、haiku默认值继承会话用途与取舍haiku简单、公式化任务追求速度如格式化代码sonnet标准工作流速度与质量均衡默认opus复杂分析、架构决策、深度代码理解最佳实践无特殊需求可省略能用haiku就用把opus留给真正复杂的任务通过实测不同模型找到平衡点argument-hint类型String默认值无作用为自动补全与用户文档化期望参数提升命令可发现性argument-hint: [pr-number] [priority] [assignee] argument-hint: [source-branch] [target-branch] [commit-message]最佳实践每个参数用方括号[]包裹使用描述性名称而非arg1在描述中区分必选/可选顺序必须与命令中$1、$2的位置对应disable-model-invocation类型Boolean默认值false作用禁止 SlashCommand 工具以编程方式调用该命令适用场景详见 frontmatter-reference.md仅手动命令需要人类判断如生产环境审批破坏性操作不可逆操作如删除全部测试数据交互式工作流需要用户输入的引导流程。注意该字段应谨慎使用会限制 Claude 的自主性并在命令注释中说明原因。一个完整的复杂命令示例--- description: Deploy application to environment argument-hint: [app-name] [environment] [version] allowed-tools: Bash(kubectl:*), Bash(helm:*), Read model: sonnet --- Deploy $1 to $2 environment using version $3 Pre-deployment checks: - Verify $2 configuration - Check cluster status: !kubectl cluster-info - Validate version $3 exists Proceed with deployment following deployment runbook.动态参数$ARGUMENTS 与位置参数$ARGUMENTS捕获全部参数$ARGUMENTS将用户输入的所有参数作为单个字符串注入--- description: Fix issue by number argument-hint: [issue-number] --- Fix issue #$ARGUMENTS following our coding standards and best practices.输入/fix-issue 123展开为Fix issue #123 following our coding standards...。位置参数$1、$2、$3逐个捕获参数--- description: Review PR with priority and assignee argument-hint: [pr-number] [priority] [assignee] --- Review pull request #$1 with priority level $2. After review, assign to $3 for follow-up.输入/review-pr 123 high alice展开为Review pull request #123 with priority level high. After review, assign to alice for follow-up.组合使用可以混合位置参数与剩余参数Deploy $1 to $2 environment with options: $3输入/deploy api staging --force --skip-tests展开为Deploy api to staging environment with options: --force --skip-tests。高级参数处理advanced-workflows.md 提供了更高级的参数模式带默认值的可选参数使用 Bash 参数展开语法Environment: ${1:-staging} Version: ${2:-latest} Deploying ${2:-latest} to ${1:-staging}...参数缩写展开case映射case $1 in d|dev) ENVdevelopment;; s|stg) ENVstaging;; p|prod) ENVproduction;; *) ENV$1;; esac文件引用 语法在命令中写path/to/fileClaude 会在处理命令前先读取该文件内容--- description: Review specific file argument-hint: [file-path] --- Review $1 for: - Code quality - Best practices - Potential bugs输入/review-file src/api/users.tsClaude 会先读取src/api/users.ts再执行命令。多个文件引用Compare src/old-version.js with src/new-version.js Identify: - Breaking changes - New features - Bug fixes静态文件引用不依赖参数Review package.json and tsconfig.json for consistency Ensure: - TypeScript version matches - Dependencies are aligned - Build configuration is correct文件引用最佳实践使用清晰明确的路径对缺失文件做优雅处理使用项目相对路径需要模式匹配时考虑 Glob 工具。Bash 执行! 语法命令可以在提示词中内联执行 Bash 命令动态收集上下文仓库状态、环境信息等再交给 Claude 处理。语法为反引号包裹的命令--- description: Show Git status allowed-tools: Bash(git:*) --- Current status: !git status Recent commits: !git log --oneline -5使用时机注入动态上下文git 状态、环境变量等收集项目/仓库当前状态构建上下文感知的工作流注意事项完整语法与示例见 plugin-features-reference.md限制 Bash 作用域用Bash(git:*)而非Bash(*)避免破坏性操作处理命令失败情况保持命令快速长时间运行会拖慢调用命令组织与命名空间扁平结构适合 5-15 个命令、无明确分类的小型命令集.claude/commands/ ├── build.md ├── test.md ├── deploy.md ├── review.md └── docs.md命名空间结构适合 15 个命令、有明确分类的场景子目录名会成为命名空间并显示在/help中.claude/commands/ ├── ci/ │ ├── build.md # /build (project:ci) │ ├── test.md # /test (project:ci) │ └── lint.md # /lint (project:ci) ├── git/ │ ├── commit.md # /commit (project:git) │ └── pr.md # /pr (project:git) └── docs/ ├── generate.md # /generate (project:docs) └── publish.md # /publish (project:docs)命名空间带来逻辑分组、/help可读性、避免名称冲突等收益。插件专属特性${CLAUDE_PLUGIN_ROOT}插件命令可以访问环境变量${CLAUDE_PLUGIN_ROOT}它在运行时解析为插件目录的绝对路径。这解决了插件命令跨安装、跨系统移植的问题——不需要硬编码任何路径。主要用途详见 plugin-features-reference.md可移植地引用插件文件执行插件脚本加载插件配置访问插件模板常见模式# 执行插件脚本 !bash ${CLAUDE_PLUGIN_ROOT}/scripts/script.sh # 加载插件配置 ${CLAUDE_PLUGIN_ROOT}/config/settings.json # 使用插件模板 ${CLAUDE_PLUGIN_ROOT}/templates/report.md # 访问插件资源 ${CLAUDE_PLUGIN_ROOT}/docs/reference.md展开示例!node ${CLAUDE_PLUGIN_ROOT}/scripts/analyze.js展开为 !node /path/to/plugins/plugin-name/scripts/analyze.js。使用规范所有插件内部路径一律使用${CLAUDE_PLUGIN_ROOT}例如${CLAUDE_PLUGIN_ROOT}/templates/foo.md是正确写法而./templates/foo.md相对于当前目录而非插件是错误写法。参考文档还强调验证文件存在test -f、在注释中记录插件文件结构、与参数组合使用!${CLAUDE_PLUGIN_ROOT}/bin/process.sh $1 $2。排查要点变量不展开时检查命令是否确实从插件加载、Bash 执行是否被允许、语法是否为精确的${CLAUDE_PLUGIN_ROOT}文件找不到时核对路径相对于插件根目录是否正确、权限是否允许读取/执行。插件命令的自动发现与命名空间插件命令在加载时从commands/目录自动发现无需手动注册plugin-name/ ├── commands/ │ ├── foo.md # /foo (plugin:plugin-name) │ ├── bar.md # /bar (plugin:plugin-name) │ └── utils/ │ └── helper.md # /helper (plugin:plugin-name:utils) └── plugin.json子目录即命名空间/security (plugin:plugin-name:review)、/staging (plugin:plugin-name:deploy)等。插件有 5 个命令时建议使用子目录分组。命名约定使用描述性动作名称避免通用名称test、run考虑加插件名前缀保证唯一性多词名称用连字符。好例子/mylyn-sync、/analyze-performance、/docker-compose-up坏例子/test、/run、/do-stuff。插件命令模式plugin-features-reference.md 归纳了五类插件命令模式1. 配置驱动命令——每次调用都加载一致的插件配置--- description: Deploy using plugin settings allowed-tools: Read, Bash(*) --- Load configuration: ${CLAUDE_PLUGIN_ROOT}/deploy-config.json Deploy to $1 environment using: 1. Configuration settings above 2. Current git branch: !git branch --show-current 3. Application version: !cat package.json | grep version Execute deployment and monitor progress.2. 模板生成命令——用插件模板产出标准化文档--- description: Generate documentation from template argument-hint: [component-name] --- Template: ${CLAUDE_PLUGIN_ROOT}/templates/component-docs.md Generate documentation for $1 component following the template structure.3. 多脚本工作流——编排多个插件脚本--- description: Complete build and test workflow allowed-tools: Bash(*) --- Build: !bash ${CLAUDE_PLUGIN_ROOT}/scripts/build.sh Validate: !bash ${CLAUDE_PLUGIN_ROOT}/scripts/validate.sh Test: !bash ${CLAUDE_PLUGIN_ROOT}/scripts/test.sh Review all outputs and report: 1. Build status 2. Validation results 3. Test results 4. Recommended next steps4. 环境感知命令——按环境加载不同配置Environment config: ${CLAUDE_PLUGIN_ROOT}/config/$1.json5. 插件数据管理——在插件缓存目录持久化数据Cache directory: ${CLAUDE_PLUGIN_ROOT}/cache/ Analyze $1 and save results to cache: !mkdir -p ${CLAUDE_PLUGIN_ROOT}/cache date ${CLAUDE_PLUGIN_ROOT}/cache/last-run.txt与插件组件集成命令可以与插件的其他组件agents、skills、hooks协同构建强大工作流。集成 Agent在提示词中指名启动插件 agentClaude 会通过 Task 工具启动--- description: Deep code review argument-hint: [file-path] --- Initiate comprehensive review of $1 using the code-reviewer agent. Agent uses plugin resources: - ${CLAUDE_PLUGIN_ROOT}/config/rules.json - ${CLAUDE_PLUGIN_ROOT}/checklists/review.md要点agent 必须存在于plugin/agents/目录文档化 agent 能力引用 agent 使用的插件资源。集成 Skill通过指名技能名称触发插件技能--- description: Document API with standards argument-hint: [api-file] --- Document API in $1 following plugin standards. Use the api-docs-standards skill to ensure: - Complete endpoint documentation - Consistent formatting - Example quality - Error documentation要点技能必须存在于plugin/skills/目录说明技能提供的价值。协调 Hook命令可以准备状态供 hook 处理hook 在工具事件上自动执行命令应文档化预期的 hook 行为引导 Claude 解读 hook 输出多组件工作流结合脚本、agent、技能、模板的四阶段审查--- description: Comprehensive review workflow argument-hint: [file] allowed-tools: Bash(node:*), Read --- Target: $1 Phase 1 - Static Analysis: !node ${CLAUDE_PLUGIN_ROOT}/scripts/lint.js $1 Phase 2 - Deep Review: Launch code-reviewer agent for detailed analysis. Phase 3 - Standards Check: Use coding-standards skill for validation. Phase 4 - Report: Template: ${CLAUDE_PLUGIN_ROOT}/templates/review.md Compile findings into report following template.完整的实战示例10 个插件命令脚本分析、模板生成、多脚本发布流程、配置驱动部署、agent/技能集成、多组件审查、输入校验、环境感知等见 examples/plugin-commands.md。校验模式与错误处理命令应在处理前校验输入与资源详见 SKILL.md 的 Validation Patterns 与 plugin-features-reference.md。参数校验用 Bash 校验参数格式--- description: Deploy with validation argument-hint: [environment] --- Validate environment: !echo $1 | grep -E ^(dev|staging|prod)$ || echo INVALID If $1 is valid environment: Deploy to $1 Otherwise: Explain valid environments: dev, staging, prod Show usage: /deploy [environment]更细的写法还会使用$IF(...)条件结构在plugin-features-reference.md中展示$IF($1 in [dev, staging, prod], Deploy to $1 environment using validated configuration, ERROR: Invalid environment $1. Must be one of: dev, staging, prod )文件存在性检查Check file exists: !test -f $1 echo EXISTS || echo MISSING If file exists: Process configuration: $1 Otherwise: Explain where to place config file Show expected format Provide example configuration插件资源校验Validate plugin setup: - Script: !test -x ${CLAUDE_PLUGIN_ROOT}/bin/analyze echo ✓ || echo ✗ - Config: !test -f ${CLAUDE_PLUGIN_ROOT}/config.json echo ✓ || echo ✗ If all checks pass, run analysis. Otherwise, report missing components.错误处理Execute build: !bash ${CLAUDE_PLUGIN_ROOT}/scripts/build.sh 21 || echo BUILD_FAILED If build succeeded: Report success and output location If build failed: Analyze error output Suggest likely causes Provide troubleshooting steps最佳实践尽早校验提供有帮助的错误消息建议纠正动作优雅处理边界情况。常用命令模式速览examples/simple-commands.md提供了 10 个可直接使用的命令示例代码审查、安全审查、测试、文档生成、Git 状态、部署、文件对比、快速修复、调研、代码讲解并归纳了核心模式只读分析模式allowed-tools: Read, Grep——用于代码审查、文档、分析Git 操作模式allowed-tools: Bash(git:*)单参数模式argument-hint: [target]Process $1...多参数模式argument-hint: [source] [target] [options]快速执行模式model: haiku文件对比模式Compare $1 with $2...上下文收集模式Context: !git status Files: file1 file2交互式命令AskUserQuestion部分命令需要参数无法表达的输入多选项权衡、多选、需解释的决策、偏好收集。此时应在命令执行中使用AskUserQuestion 工具而不是依赖命令参数。完整指南见 interactive-commands.md。何时用 AskUserQuestion需要解释的多选决策、复杂选项、多选场景、偏好收集、根据回答自适应的工作流。何时用命令参数简单值文件路径、数字、名称、用户已知的输入、需要自动化的可脚本化工作流、快速调用提问会拖慢速度。工具参数结构{ questions: [ { question: Which authentication method should we use?, header: Auth method, // 短标签最多 12 字符 multiSelect: false, // true 表示多选 options: [ { label: OAuth 2.0, description: Industry standard, supports multiple providers }, { label: JWT, description: Stateless, good for APIs } ] } ] }要点用户始终可以选 Other 自定义输入自动提供multiSelect: true允许多选每个问题 2-4 个选项每次调用可问 1-4 个问题。基础交互命令骨架--- description: Interactive setup command allowed-tools: AskUserQuestion, Write --- # Interactive Plugin Setup ## Step 1: Gather Configuration Use the AskUserQuestion tool to ask: **Question 1 - Deployment target:** - header: Deploy to - question: Which deployment platform will you use? - options: - AWS (Amazon Web Services with ECS/EKS) - GCP (Google Cloud with GKE) - Azure (Microsoft Azure with AKS) - Local (Docker on local machine) ## Step 2: Process Answers [解析回答生成配置] ## Step 3: Generate Configuration [创建 .claude/plugin-name.local.md] ## Step 4: Confirm and Next Steps问题设计原则问题具体明确header 不超过 12 字符选项描述说明取舍1-2 句每问 2-4 个选项多选仅用于任意组合语义功能选择互斥选择如数据库引擎绝不能用 multiSelect问题逻辑顺序自然后面问题可基于前面回答条件流、渐进式披露。参考文档还给出了完整的多 Agent 启动、校验循环、增量配置构建、上下文感知提问等高级模式。高级工作流与状态管理advanced-workflows.md 覆盖多步命令序列与组合模式顺序工作流编号步骤 决策点如 PR 审查四步流程状态携带工作流用.claude/deployment-state.local.md之类文件在多次调用间维持状态初始化 → 测试 → 构建 → 部署 → 清理条件分支根据分支类型、测试结果、环境动态决定流程命令组合元命令编排简单子命令/format-code→/lint-code→/test-all管道模式命令消费前序命令输出并行执行同时运行多项校验并汇总工作流协调标志文件跨命令通信、锁文件防止并发部署错误处理优雅失败、自动回滚、检查点恢复状态文件的典型形态YAML frontmatter Markdown 正文--- workflow: deployment stage: testing started: 2025-01-15T10:30:00Z environment: staging branch: feature/new-api commit: abc123def tests_passed: false build_complete: false --- # Deployment Workflow State Current stage: Testing Completed steps: - ✅ Validation - ✅ Branch check - ⏳ Testing (in progress)设计原则明确编号步骤并显示当前位置显式状态而非隐式依赖提供决策点优雅处理失败命令单一职责、可组合、接口标准、松耦合。命令测试策略testing-strategies.md 定义了分层测试体系Level 1 - 语法与结构校验检查 YAML frontmatter 语法---标记应为 2 个、.md扩展名、文件位置。参考文档提供了可复用的validate-command.sh脚本。Level 2 - Frontmatter 字段校验model必须是 sonnet/opus/haiku、description长度告警80 字符、allowed-tools格式。Level 3 - 手动调用claude --debug启动 →/help确认命令出现 → 无参数调用检查行为 → 带参数调用 → 查看~/.claude/debug-logs/latest。Level 4 - 参数测试矩阵无参、单参、多参、多余参数、带引号空格、空参数六种用例。Level 5 - 文件引用测试单文件、不存在文件、多文件、大文件100MB。Level 6 - Bash 执行测试正常输出、禁止命令被拦截Bash(echo:*)下执行ls -la /应被拒绝。Level 7 - 集成测试命令 hook 联动、多命令序列、命令 MCP 工具。自动化手段测试套件脚本、pre-commit 钩子git diff --cached检查.claude/commands/*.md、CI 工作流validate-command.shvalidate-frontmatter.sh TODO 检查。边界与性能空参数、特殊字符、长参数10000 字符、特殊路径、失败命令exit 1、false、响应时间快速命令建议 3 秒、资源占用监控。参考文档还提供了完整的发布前测试清单结构/功能/边界/集成/质量/分发六类以及常见失败命令不出现、参数不替换、Bash 不执行、文件引用失效的调试步骤。文档化与市场分发documentation-patterns.md 强调命令应自文档化——把文档嵌入命令本身完整模板frontmatter 注释块COMMAND/VERSION/AUTHOR/PURPOSE/USAGE/ARGUMENTS/EXAMPLES/REQUIREMENTS/RELATED COMMANDS/TROUBLESHOOTING/CHANGELOG 命令实现内联注释段落!-- SECTION 1: VALIDATION --标记复杂逻辑决策点文档!-- DECISION POINT: 需要用户确认 --说明风险内置 help 子命令/command help返回用法与子命令列表有帮助的错误消息说明发生了什么、常见原因、建议操作维护文档版本与变更日志、依赖、性能、安全考量、测试、未来改进配套 README安装、用法、参数、示例、配置、排错marketplace-considerations.md 面向市场分发场景跨平台兼容用uname检测平台避免平台特定命令如 macOS 的pbcopy应做多平台降级最少依赖命令启动时检查 git/jq/node 是否可用并给出安装指引优雅降级检测 gh/docker 等可选功能缺失时提示受限功能面向陌生用户首次运行引导、防呆错误处理hlep → Did you mean: help?、诊断信息命名空间避免冲突插件前缀命名 记录命名决策可配置性读取.claude/plugin-name.local.md中的用户偏好提供合理默认值版本兼容命令版本声明、插件版本检查、弃用警告幂等与原子性标志文件防重复执行、临时目录 mv原子应用发布前检查清单三平台验证、无硬编码路径、无 TODO、README 完整、反馈机制开发工作流与最佳实践总结五步开发流程来自 README.md设计命令定义目的与范围确定必需参数识别所需工具创建文件选择合适位置以命令名创建.md文件编写基础提示词添加 frontmatter从最小仅 description开始按需添加字段allowed-tools 等用 argument-hint 文档化参数测试命令以/command-name调用验证参数检查 Bash 执行测试文件引用打磨提升提示词清晰度处理边界情况在注释中添加示例文档化依赖最佳实践清单单一职责一个命令、一个清晰目的清晰描述保证在/help中可发现文档化参数始终使用 argument-hint最小工具权限使用最受限的 allowed-tools充分测试验证所有特性可用添加注释解释复杂逻辑处理错误考虑缺失参数/文件的情形命令命名推荐动词-名词模式review-pr、fix-issue、gen-api-docs。参数处理上要校验必需参数、提供默认值、说明期望格式、处理缺失/无效参数的边界情况。技能体系定位与触发在 plugin-dev 工具包 中command-development 与 hook-development、mcp-integration、plugin-structure、plugin-settings、agent-development、skill-development 并列为七大技能采用三层渐进式披露元数据始终加载的强触发描述→ 核心 SKILL.md触发时加载约 1,500-2,000 词→ 参考文档/示例按需加载。Claude Code 会在用户提出以下诉求时自动加载本技能要求创建斜杠命令/添加命令/编写自定义命令、需要定义命令参数、询问命令 frontmatter 或 YAML 配置、需要组织命令或使用命名空间、创建带文件引用的命令、询问命令中的 Bash 执行、需要命令开发最佳实践等。参考文档按主题组织frontmatter 规格、插件特性、交互命令、高级工作流、测试策略、文档模式、市场考量示例文件simple-commands.md 与 plugin-commands.md提供了共 20 个可直接套用的完整命令。安装插件可通过/plugin install plugin-devclaude-code-marketplace或开发模式cc --plugin-dir /path/to/plugin-dev完成。常见故障排查速查症状检查项命令不出现文件是否在正确目录.md扩展名Markdown 格式有效重启 Claude Code参数不生效$1/$2语法正确argument-hint 与用法匹配无多余空格Bash 执行失败allowed-tools 包含 Bash反引号语法正确先在终端测试命令检查权限文件引用失效语法正确路径有效允许 Read 工具使用绝对或项目相对路径${CLAUDE_PLUGIN_ROOT}不展开命令确实从插件加载允许 Bash 执行语法精确为${CLAUDE_PLUGIN_ROOT}从单文件的基础命令到插件级的多组件工作流本文覆盖了斜杠命令开发的完整路径。要深入学习每个主题可继续阅读上述各参考文档与示例文件——它们本身就是按渐进式披露原则组织的可复用知识资产。赞分享AI 插件开发工具插件系统【免费下载链接】claude-plugins-officialOfficial, Anthropic-managed directory of high quality Claude Code Plugins.项目地址https://gitcode.com/GitHub_Trending/cl/claude-plugins-official点击查看免费下载相关推荐Claude Code 斜杠命令Slash Command开发完全指南文件格式、Frontmatter 配置与插件集成实战Claude Code 斜杠命令Slash Command开发完全指南文件格式、Frontmatter 配置与插件集成实战 本文基于 Claude CodAI 应用AI 技能/插件开发工具Claude Code 插件命令实战指南十种插件斜杠命令模式与 CLAUDE_PLUGIN_ROOT 工程实践Claude Code 插件命令实战指南十种插件斜杠命令模式与 CLAUDE_PLUGIN_ROOT 工程实践 本篇技术指南以 claude pluginsAI 插件开发工具插件系统Claude Code 插件斜杠命令开发完全指南frontmatter、动态参数、Bash 执行与插件集成实战Claude Code 插件斜杠命令开发完全指南frontmatter、动态参数、Bash 执行与插件集成实战 本文基于 plugins/plugin devAI 插件开发工具插件系统创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
