ARTICLE DETAIL

资讯详情

深耕网站建设、视觉设计与SEO优化的一线实战洞察。

用 Command Creator 技能打造可自主执行的 Claude Code 斜杠命令:从设计到落地

用 Command Creator 技能打造可自主执行的 Claude Code 斜杠命令:从设计到落地 云原生微服务运维DevOps【免费下载链接】mesheryMeshery, the cloud native manager项目地址https://gitcode.com/GitHub_Trending/me/meshery点击查看免费下载这篇指南以 meshery 仓库中打包的 Command Creator 技能 为骨架系统讲解如何在 Claude Code 中把重复性工作流沉淀为以/command-name调用的可复用斜杠命令Slash Command并覆盖位置决策、四种命令模式、六步创建流程、Agent 优化指令写法与质量清单。读完你将能够独立把一个高频重复流程PR 提交、CI 修复、代码评审等转成结构清晰、可自主执行、可测试迭代的斜杠命令并在项目级与全局两级正确落盘。斜杠命令是什么一种展开成提示词的 Markdown 文件斜杠命令本质上是一个 Markdown 文件存储在.claude/commands/项目级或~/.claude/commands/全局/用户级下调用时其内容会被展开为提示词注入当前对话从而让 Agent 按既定流程自主执行。它尤其适合重复性工作流代码评审、PR 提交、CI 修复需要一致性的多步骤流程Agent 委派Agent Delegation类任务项目专属的自动化。标准结构--- description: Brief description shown in /help (required) argument-hint: placeholder (optional, if command takes arguments) --- # Command Title [Detailed instructions for the agent to execute autonomously]description必填显示在/help输出中argument-hint可选仅当命令接收参数时存在用于提示参数格式正文Agent 需要自主执行的详细指令。调用方式与存储位置/command-name [arguments]层级路径生效范围项目级.claude/commands/my-command.md仅当前项目全局/用户级~/.claude/commands/my-command.md所有项目何时调用该技能当出现以下需求时即可触发 Command Creator 技能从零创建新斜杠命令、自动化重复执行的工作流、把多步骤流程固化为一致执行、将手工流程转为自动化命令、为团队工作流创建项目级命令、为个人效率构建全局命令。官方建议的触发短语包括create a command、make a slash command、add a command、I keep doing X, can we make a command for it?、automate this workflow、create a reusable command。在本仓库中command-creator技能的元数据定义在 .agents/skills/command-creator/SKILL.md 的 frontmatter 中其中description字段即被用于技能发现。技能核心能力1. 智能位置检测根据当前目录的 git 仓库状态、用户显式偏好以及命令的作用域与目的自动判定命令应落位于项目级还是全局。2. 基于模式的设计引导用户从四种经过验证的命令模式中选择工作流自动化、迭代修复、Agent 委派、简单执行。3. Agent 优化指令生成的命令可被 Agent 自主执行祈使/不定式动词开头的指令、显式工具使用说明、清晰的成功标准、具体的错误处理、明确的预期结果。4. 质量保障内置命名约定强制 kebab-case、参数处理与提示、工具限制指引、错误恢复策略、进度上报模式等最佳实践。5. 捆绑参考文档随技能附带三份完整参考文件分别对应模式设计、真实命令实现与质量检查清单。六步创建工作流第 1 步确定存放位置自动检测逻辑如下检查当前目录是否位于 git 仓库内git rev-parse --is-inside-work-tree 2/dev/null默认规则在 git 仓库内 → 项目级.claude/commands/不在 git 仓库内 → 全局~/.claude/commands/允许用户覆盖显式提到 global/user-level 用全局显式提到 project/project-level 用项目级进入下一步前必须将所选位置告知用户。第 2 步展示命令模式向用户呈现四种模式帮助框定需求并询问哪种模式最接近你想创建的命令工作流自动化分析 → 行动 → 报告如 submit-stack迭代修复运行 → 解析 → 修复 → 重复如 ensure-ciAgent 委派上下文 → 委派 → 迭代如 create-implementation-plan简单执行带参数运行命令如 codex-review详细设计指引见 .agents/skills/command-creator/references/patterns.md。第 3 步收集命令信息通过问答收集四类信息A. 命令名称与用途名称作为文件名名称必须为 kebab-casemy-command正确my_command错误用于/help输出的描述描述应简洁、动作导向文件名与命令名一一对应my-command.md→ 调用为/my-command。B. 参数是否接收参数必填还是可选参数代表什么若接收参数在 frontmatter 中增加argument-hint: placeholder必填参数用尖括号...可选参数用方括号[...]。C. 工作流步骤具体步骤及执行顺序、使用的工具或命令需覆盖初始分析或检查、主要动作、结果处理方式、成功标准、错误处理方式。D. 工具限制与引导是否使用特定 Agent 或工具应避免哪些操作是否需要读取特定文件作为上下文第 4 步生成优化命令依据 .agents/skills/command-creator/references/best-practices.md 中的模板结构、Agent 执行最佳实践、写作风格与质量清单生成命令。核心原则使用祈使/不定式动词开头、表述具体明确、包含预期结果、给出具体示例、定义清晰的错误处理。第 5 步创建命令文件确定完整文件路径项目级为.claude/commands/[command-name].md全局为~/.claude/commands/[command-name].md确保目录存在mkdir -p [directory-path]用 Write 工具写入命令文件向用户确认报告文件位置、概括命令功能、说明调用语法/command-name [arguments]。第 6 步测试与迭代建议用户运行测试/command-name [arguments]等待用户反馈根据结果迭代改进将优化写回文件。四种命令模式详解模式一工作流自动化分析 → 行动 → 报告适用场景需要分析后行动、有清晰顺序、产出特定结果提交、PR、报告的多步骤流程。示例提交 PR stack1. Analyze git history to identify commit stack 2. Create PRs for each commit with proper dependencies 3. Report created PRs with links and status关键特征带依赖的连续步骤、行动前有清晰的分析阶段、全面的最终报告。模式二迭代修复运行 → 解析 → 修复 → 重复适用场景需要反复执行直到满足成功条件的任务lint、测试、CI有明确通过/失败判据。示例确保 CI 通过1. Run tests and capture output 2. Parse failures and errors 3. Fix identified issues 4. Repeat until all tests pass关键特征循环直到成功条件、解析错误指导修复、跨迭代跟踪进度。建议设置安全上限最大迭代 10 次、同一错误连续出现 3 次即停止、使用 TodoWrite 跟踪迭代进度。模式三Agent 委派上下文 → 委派 → 迭代适用场景需要专业 Agent 专长的复杂任务、多阶段流程、需要人审的任务。示例创建实施计划1. Gather context (requirements, codebase) 2. Delegate to subagent agent 3. Iterate on plan with user feedback 4. Save final plan to .PLAN.md关键特征使用 Task 工具调用专业 Agent、向被委派 Agent 传递相关上下文、对专业 Agent 的输出进行迭代。模式四简单执行解析参数 → 执行 → 返回输出适用场景单步命令、现有工具的包装命令、直接运行并上报的命令。示例代码评审1. Run codex review on specified files 2. Present results to user关键特征最少逻辑、直接执行、参数透传给底层工具、快速反馈回路。模式选择速查需求对应模式基于分析创建提交/PR工作流自动化迭代修复直到通过迭代修复创建计划或委派给专家Agent 委派运行工具并展示结果简单执行协调多个 Agent多 Agent 编排检查多个上下文文件上下文文件优先级按复杂度选择方案条件工具选择运行 make 目标Makefile 集成从简开始按需展开渐进式披露命令通常组合多种模式例如 submit-stack 组合了上下文文件优先级检查 .PLAN.md、工作流自动化分析→提交→提交 PR与条件工具选择。位置策略项目级还是全局项目级命令.claude/commands/适用场景命令与项目工作流强相关、需要项目特定上下文或文件、需要团队共享、自动化与项目结构绑定。例如/submit-stack项目的 PR 提交流程、/ensure-ci项目的测试套件、/deploy-staging项目的部署流程。优势随项目纳入版本控制、团队共享、支持项目级定制。全局命令~/.claude/commands/适用场景跨项目通用、个人生产力工具、通用工作流自动化、无项目依赖。例如/codex-review评审任意文件、/create-implementation-plan通用规划、/git-cleanup任意仓库的 git 维护。优势处处可用、支持个人定制、与具体项目解耦。捆绑参考资源技能在references/目录下附带三份互补的参考文件写作时按需加载文件内容加载时机.agents/skills/command-creator/references/patterns.md四种模式的详细设计指引、各模式适用时机、工具使用建议、真实示例设计命令工作流、选择合适模式时.agents/skills/command-creator/references/examples.md/submit-stack、/ensure-ci、/create-implementation-plan等完整源码、关键决策注释、最佳实践示例需要具体命令的结构范例时.agents/skills/command-creator/references/best-practices.md命令模板结构、Agent 优化写作风格、常见陷阱、质量检查清单、工具限制模式、错误处理策略、命名约定最终定稿前保证质量实战示例示例一创建项目级 CI 修复命令用户诉求I keep fixing CI failures manually. Can we make a command for this?技能流程检测到项目级在 git 仓库内→ 建议迭代修复模式 → 收集信息名称ensure-ci、描述 Iteratively fix CI failures until all tests pass、无参数、步骤为 运行测试 → 解析失败 → 修复问题 → 重复→ 使用 Bash 工具运行 pytest 生成命令 → 创建.claude/commands/ensure-ci.md→ 用户以/ensure-ci调用。示例二创建全局代码评审命令用户诉求Create a global command to review code with Codex技能流程检测到全局用户显式要求→ 建议简单执行模式 → 收集信息名称codex-review、描述 Review code files using Codex、必填参数files、步骤为 运行 codex 评审 → 展示结果→ 生成命令 → 创建~/.claude/commands/codex-review.md→ 用户以/codex-review src/app.py src/utils.py调用。示例三创建 PR 提交工作流用户诉求Make a command that analyzes my commits and creates a PR stack技能流程检测到项目级 → 建议工作流自动化模式 → 收集信息名称submit-stack、描述 Create PR stack from commit history、可选参数[base-branch]默认 main、步骤为 分析提交 → 创建 PR → 报告结果→ 使用 git 分析与 gh CLI 生成命令 → 创建.claude/commands/submit-stack.md→ 用户以/submit-stack或/submit-stack develop调用。编写最佳实践命名约定必须使用 kebab-case连字符而非下划线正确submit-stack、ensure-ci、create-from-plan错误submit_stack、ensure_ci、create_from_plan。参数提示必填参数用angle-bracketsargument-hint: file-path可选参数用[square-brackets]argument-hint: [base-branch]混合形式argument-hint: command [args...]Agent 优化指令用祈使/不定式正确 Run pytest to execute tests错误 You should run pytest to execute tests。显式说明工具正确 Use the Bash tool to runpytest tests/错误 Run the tests。定义成功标准正确 Continue until all tests pass (exit code 0)错误 Fix the tests。包含错误处理正确 If pytest fails, parse the output to identify failing tests, then fix each one错误 Fix any test failures。给出真实示例避免 foo/bar 占位符例如git commit -m Add user authentication with OAuth2。包含预期结果例如 Run git status - this should show modified files in src/ directory。工具限制Bash 工具用于pytest、pyright、ruff、prettier、make、npm、yarn、gtgit-town 命令。Task 工具用于专业 Agentsubagent、subagents、长时间运行或复杂的委派任务。命令中应避免交互式提示命令必须自主执行、用户确认循环除非模式明确要求、需要解释的模糊指令。常见陷阱模糊指令错误 Fix any errors that appear正确分类型给出修复动作make fix、make format、Edit 工具手工修复。缺少错误处理应写明若退出码为 0 则成功非 0 则解析输出、针对性修复、再次验证、同一错误连续 3 次则停止。条件分支含糊应使用明确的 if/else 结构如检查.PLAN.md存在与否的分支。批量操作不要先修完所有错误再统一标记 todo应每修完一类错误立即标记对应 todo 完成。工具混淆明确 Use Bash tool to run make commands不要含糊地说use an agent to run make。缺少上下文先检查.PLAN.md、git status、git diff HEAD再行动。描述质量差/help中显示的 description 要清晰、动作导向例如 Run make all-ci and iteratively fix issues until all checks pass。质量检查清单定稿前核对结构名称具描述性且为 kebab-case描述简洁动作导向frontmatter 含description必填必要时含argument-hint有用户向摘要 What This Command Does有编号的 Implementation Steps。内容步骤编号且顺序清晰每步含具体可执行指令显式指定工具文件检查给出代码示例条件逻辑为清晰 if/else用 NEVER/DO NOT 标出反模式错误处理定义具体动作成功标准明确。写作风格祈使/不定式具体不模糊包含预期结果真实示例。位置项目级/全局判断合适目录已存在或将创建文件路径正确。测试用户知道调用方式/command-name [arguments]尽可能已测试迭代已纳入用户反馈。常见应用场景开发工作流提交 PR分析提交、按依赖创建 PR stack、修复 CI迭代运行测试、解析失败、修复、代码评审运行 linter、formatter、静态分析、部署构建、测试、部署到 staging/production。项目自动化初始化搭建项目结构、安装依赖、文档从代码生成文档、更新 README、测试运行全量测试套件并出覆盖率报告、发布升级版本、生成 changelog、打 tag。个人效率Git 清理删除已合并分支、修剪远端、代码库分析生成架构图、依赖图、重构跨文件统一模式、规划为功能创建实施计划。团队协作新成员入职搭建开发环境、克隆仓库、标准执行代码风格、提交信息格式、知识沉淀记录架构决策、补充示例、评审人工评审前的自动化评审检查。在 meshery 仓库中的落地形态该技能并非孤立文档而是仓库 Agent 工具链的一部分。[.agents/README.md](https://link.gitcode.com/i/ba70577ec1865c75da97f81b405035d0)说明.agents/skills/是该仓库所有打包工作流的单一事实来源每个技能一个目录并含SKILL.mdClaude Code 通过.claude/skills指向../.agents/skills的相对符号链接发现技能Codex 与 OpenCode 则原生扫描.agents/skills因此技能内容一律通过.agents/skills/...规范路径自引用自身文件绝不依赖符号链接解析。仓库根目录的 AGENTS.md 进一步要求技能只登记在.agents/skills/下、不得在 AGENTS.md 中逐个枚举、.claude/skills只能是符号链接。作为通用型技能Command Creator 不依赖仓库特定代码其模式与示例同样适用于 Meshery 自身的 Go 后端make golangci、Next.js 前端make ui-lint与 mesheryctlgo test ./...等重复性检查流程——例如可以将运行make golangci并迭代修复直到通过封装为一条迭代修复型命令。小结与上手路径一份高质量的斜杠命令应当可靠无需人工干预即可自主执行、可维护结构清晰、文档完善、可复用项目级或全局可用、优化为任务选用恰当工具与 Agent。上手路径为识别一个想自动化的重复工作流 → 调用/command-creator技能 → 按引导工作流创建命令 → 基于结果测试与迭代 → 团队共享项目级或个人使用全局。启动命令只需输入/command-creator或直接说 I want to create a command that [does something]。赞分享云原生微服务运维DevOps【免费下载链接】mesheryMeshery, the cloud native manager项目地址https://gitcode.com/GitHub_Trending/me/meshery点击查看免费下载相关推荐Claude Code 斜杠命令实战用 Quick Plan 一键生成可执行的工程实施计划claude-code-hooks-masteryClaude Code 斜杠命令实战用 Quick Plan 一键生成可执行的工程实施计划claude code hooks mastery 在 Clauclaude-howto 实战用 Claude Code /commit 斜杠命令打造带上下文的智能 Git 提交claude howto 实战用 Claude Code /commit 斜杠命令打造带上下文的智能 Git 提交 导读 /commit 是 claude h教程文档Claude Code 斜杠命令实战用 label-issue 自动为 GitHub Issue 打标签Claude Code 斜杠命令实战用 label issue 自动为 GitHub Issue 打标签 本篇技术指南围绕 claude code actioAI AgentCI/CD代码智能体开发者工具创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考
返回列表