云原生微服务运维DevOps【免费下载链接】mesheryMeshery, the cloud native manager项目地址https://gitcode.com/GitHub_Trending/me/meshery点击查看免费下载本指南以 command-creator 技能文档 为核心系统讲解 Claude Code 斜杠命令Slash Command的完整创建流程从命令文件结构与存储位置、六步创建工作流、四大命令模式到 agent 优化指令与质量自检清单。读完本文你将能把仓库中反复出现的多步骤流程代码评审、CI 修复、PR 提交封装为一行/command-name即可调用的可复用自动化。什么是斜杠命令斜杠命令是存放在特定目录下的 Markdown 文件当用户在 Claude Code 会话中输入/command-name时文件内容会被展开为一段提示词prompt注入对话指导 agent 自主执行后续任务。它非常适合重复性工作流代码评审、PR 提交、CI 修复需要保持一致性的多步骤流程Agent 委派delegation模式项目特定的自动化在 Meshery 仓库 中.claude/skills是指向../.agents/skills的相对符号链接Claude Code 正是通过这条链接发现.agents/skills/下全部打包技能Codex 与 OpenCode 则原生扫描$REPO_ROOT/.agents/skills无需任何配置。命令文件结构每个斜杠命令都是带 YAML frontmatter 的 Markdown 文件--- 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 自主执行的详细指令应按后文“agent 优化指令”一节的要求编写。命令创建六步工作流Step 1确定存储位置先检查当前目录是否在 git 仓库内git rev-parse --is-inside-work-tree 2/dev/null自动判定规则在 git 仓库内 → 项目级命令.claude/commands/不在 git 仓库内 → 全局命令~/.claude/commands/用户显式指定时以用户为准提到 “global” 或 “user-level” 则用~/.claude/commands/提到 “project” 或 “project-level” 则用.claude/commands/。确定位置后应先告知用户再继续。项目级命令适用于与项目工作流绑定、需要项目上下文文件、需要团队共享的自动化可随仓库版本管理全局命令适用于跨项目通用的个人效率工具任何项目下都可用。Step 2展示命令模式创建前先加载 patterns.md帮助用户理解命令类型并询问“哪种模式最接近你想创建的命令”模式结构典型场景Workflow Automation分析 → 行动 → 报告提交 PR 栈submit-stackIterative Fixing运行 → 解析 → 修复 → 重复修复 CIensure-ciAgent Delegation上下文 → 委派 → 迭代创建实现计划Simple Execution解析参数 → 执行 → 返回输出代码评审Step 3收集命令信息通过问答收集四类关键信息A. 命令名与用途命令名用于文件名与功能用于description字段命令名必须使用 kebab-case连字符禁用下划线✅ 正确submit-stack、ensure-ci、create-from-plan❌ 错误submit_stack、ensure_ci、create_from_plan文件名与命令名一致my-command.md通过/my-command调用B. 参数是否接收参数、参数必选还是可选、参数代表什么若接收参数在 frontmatter 中加入argument-hint必选参数用尖括号argument-hint: file-path可选参数用方括号argument-hint: [base-branch]混合形式argument-hint: command [args...]C. 工作流步骤命令应遵循的具体步骤、执行顺序、使用的工具或命令初始分析或检查、主要动作、结果处理方式、成功标准、错误处理方案D. 工具限制与指引应使用的特定 agent 或工具、应避免的操作、需要读取的上下文文件Step 4生成优化命令加载 best-practices.md 获取模板结构、agent 执行最佳实践、写作风格指南与质量清单。核心原则使用祈使/不定式形式动词开头明确而具体包含预期结果提供具体示例定义清晰的错误处理Step 5创建命令文件确定完整路径项目级.claude/commands/[command-name].md全局~/.claude/commands/[command-name].md确保目录存在mkdir -p [directory-path]使用 Write 工具写入命令文件向用户确认报告文件位置、总结命令功能、说明调用方式/command-name [arguments]Step 6测试与迭代可选建议用户运行/command-name [arguments]进行测试根据反馈迭代优化并更新文件四大命令模式详解1. Workflow Automation工作流自动化结构分析 → 行动 → 报告。适用于步骤顺序清晰的多步工作流、先分析后行动的命令、产出明确结果提交、PR、报告的流程。关键要素显式的文件检查顺序、基于文件存在性的条件逻辑、清晰的输出格式、上下文感知决策。典型例子如 submit-stack组合了上下文文件优先级检查先查.PLAN.md、工作流自动化和条件工具选择。2. Iterative Fixing迭代修复结构运行 → 解析 → 修复 → 重复。适用于需要多次尝试才能成功的命令lint、测试、CI以及有明确通过/失败标准的任务。关键要素迭代控制最大尝试次数、卡死检测、用 TodoWrite 跟踪进度、明确的停止条件、失败类型分类、增量修复。安全上限为最多 10 次迭代同一错误连续出现 3 次即停止成功标准是退出码为 0如make all-ci全部通过。3. Agent DelegationAgent 委派结构上下文 → 委派 → 迭代。适用于需要专用 agent 的复杂任务、含人工评审的多阶段流程、受益于 agent 专业化的任务。关键要素明确的 agent 调用指令、分阶段工作流规划 → 评审 → 执行、显式的落盘触发、用户评审检查点、委派前收集上下文。规划阶段严禁写代码必须等用户明确批准如 “looks good”“approved”后才能持久化到磁盘。4. Simple Execution简单执行结构解析参数 → 执行 → 返回输出。适用于带参数的单步命令、既有工具的包装命令、简单运行并报告的命令。关键要素参数处理必选 vs 可选、直接调用工具、最少逻辑、输出格式化。本质上是外部脚本的便捷包装。Agent 优化指令与模板结构命令由 AI agent 执行因此写作必须面向自主执行优化。完整模板结构参见 best-practices.md核心要点如下写作风格始终使用祈使/不定式形式动词开头而非第二人称✅ 正确Run git status to check current branch ❌ 错误You should run git status明确具体而非含糊✅ 正确Run make lint to check for linting errors ❌ 错误Check for errors包含预期结果✅ 正确Run git status - this should show modified files in src/ directory ❌ 错误Run git status提供真实示例不用 foo/bar 占位✅ 正确Example: git commit -m Add user authentication with OAuth2 ❌ 错误Example: git commit -m foo barAgent 优化要素显式文件检查明确告诉 agent 何时检查什么文件如“FIRST: Check if.PLAN.mdexists in the repository root”并给出 if/else 分支逻辑。工具使用指引明确说明使用哪个工具——pytest/pyright/ruff/prettier/make/gt 等命令用 Bash 工具专用子 agent 用 Task 工具subagent_typesubagent。反模式标注用NEVER或DO NOT显式列出禁止行为如“NEVER run additional exploration commands”“DO NOT batch completions”。条件逻辑使用清晰的 if/else 结构并给出都不满足时的兜底处理报告用户并优雅退出。成功标准精确定义何时停止如“SUCCESS: Stop whenmake all-ciexits with code 0”。错误处理给出具体动作——报告失败的命令、展示错误消息、询问用户如何处理不要自动重试。进度追踪指定何时如何使用 TodoWrite每完成一个任务立即标记完成不要批量操作。真实命令示例解析examples.md 提供了四个完整可参考的真实命令实现可归纳出以下关键设计特征特征submit-stackensure-cicreate-implementation-plancodex-review模式Workflow AutomationIterative FixingAgent DelegationSimple Execution参数可选description无无可选[base-branch]上下文文件检查.PLAN.md检查AGENTS.md无无迭代单次最多 10 次用户驱动迭代单次工具Git、GraphiteMake、Edit 工具Task 工具脚本执行进度追踪内联报告TodoWrite必需无无错误处理询问用户卡死即停未指定显示错误消息成功标准PR 已提交退出码 0用户批准计划脚本完成submit-stack 详解Workflow Automation典型流程先检查.PLAN.md是否存在存在则读取计划上下文不存在则回退到git status/git diff HEAD分析基于分析生成单句提交信息并执行git add . git commit -m ...gt restack重排分支栈gt submit --stack --publish --no-edit提交整个栈的 PR--stack提交整个上下栈、--publish发布草稿 PR、--no-edit免交互、--restack提交前重排最后展示创建/更新的 PR 数量、URL 与当前栈状态。ensure-ci 详解Iterative Fixing流程为反复执行make all-ci依次包含 lint、format、prettier-check、pyright、test 五类检查按失败类型分类修复Ruff lint 失败用make fix、格式失败用make format、Prettier 失败用make prettier、类型错误用 Read/Edit 工具修改对应行、测试失败则读取测试与源文件分析断言。每轮修复后重跑验证直至退出码 0超过 10 次迭代、同一错误连续出现 3 次或遇到无法自动修复的错误时以## Finalization Status: STUCK格式报告并停止。质量自检清单与常见陷阱最终定稿前核对结构命令名描述性且为 kebab-casedescription简洁行动导向用于/helpfrontmatter 含必填的description需要时含argument-hint有用户可见的 “What This Command Does” 摘要有编号的 “Implementation Steps”。内容步骤编号且顺序清晰每步有具体可执行指令明确指定工具用法文件检查显式化含代码示例条件逻辑使用清晰的 if/else用 “NEVER”/“DO NOT” 标注反模式错误处理定义具体动作成功标准明确陈述。写作风格使用祈使形式具体不模糊含预期结果提供真实示例。常见陷阱指令含糊❌ “Fix any errors that appear” → ✅ 列出 lint/格式错误分别对应的修复命令。缺少错误处理❌ “Run make all-ci / Apply fixes / Done” → ✅ 按退出码分支处理并定义卡死停止条件。条件判断歧义❌ “Check if file exists and do something” → ✅ 显式区分文件存在/不存在的分支行为。批量操作❌ “Fix all the errors, then mark all todos as completed” → ✅ 每修复完一个错误类别立即标记完成。工具混淆不要用 agent 去跑 make应明确 “Use Bash tool to run make commands”。缺少上下文创建提交前应先做上下文文件与 git 状态检查而不是直接提交。描述低质❌ “A command that helps with CI stuff” → ✅ “Run make all-ci and iteratively fix issues until all checks pass”。快速提示设计工作流时加载 patterns.md参考 examples.md 查看既有命令的组织方式定稿前加载 best-practices.md 确保质量pytest/pyright/ruff/prettier/make/gt 等命令使用 Bash 工具执行专用子任务使用 Task 工具调用子 agent执行前先检查特定上下文文件如.PLAN.mdTodo 完成一个标记一个不要批量包含显式错误处理指令定义清晰的成功标准总结创建斜杠命令的六步闭环为检测位置项目级 vs 全局→展示模式框定对话→收集信息名称、用途、参数、步骤、工具→生成优化命令agent 可执行指令→创建文件落在正确位置→确认与迭代。核心目标是创建 agent 能够无需追问即可自主执行的命令——步骤清晰、工具用法显式、错误处理完备。在 command-creator 技能 的指导下配合 patterns.md、examples.md、best-practices.md 三份参考文档即可将 Meshery 仓库日常开发中反复出现的流程沉淀为可靠、可维护、可复用的团队级或个人级自动化命令。赞分享云原生微服务运维DevOps【免费下载链接】mesheryMeshery, the cloud native manager项目地址https://gitcode.com/GitHub_Trending/me/meshery点击查看免费下载相关推荐Meshery 仓库 command-creator 技能实战用 Claude Code 斜杠命令把重复工作流固化为可执行资产Meshery 仓库 command creator 技能实战用 Claude Code 斜杠命令把重复工作流固化为可执行资产 本篇技术指南基于 Mesher云原生微服务运维DevOps用 Command Creator 技能打造可自主执行的 Claude Code 斜杠命令从设计到落地用 Command Creator 技能打造可自主执行的 Claude Code 斜杠命令从设计到落地 这篇指南以 meshery 仓库中打包的 Comman云原生微服务运维DevOps为 AI Agent 编写可自主执行的 Slash CommandClaude Code 命令创作最佳实践为 AI Agent 编写可自主执行的 Slash CommandClaude Code 命令创作最佳实践 本指南以 Meshery 仓库内 .agents/云原生微服务运维DevOps创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
