云原生微服务运维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），仅供参考
企业数字化 ERP 产品动态
相关推荐
I2C物理层深度解析：开漏结构、上拉电阻与总线电容 1. 项目概述：为什么两根线值得花整整七天去“盘”透？I2C不是什么高不可攀的黑科技，它就藏在你每天用的手机里——屏幕亮度调节、电池电量读取、摄像头对焦控制，背后全是I2C在跑；它也蹲在你家智能电饭煲的主控板上&… · 2026/9/23 10:42:52
俞永福面试避坑指南：3年老兵整理的速查手册 俞永福面试避坑指南：3年老兵整理的速查手册 面试被问原理答不上来，那种大脑一片空白的窒息感，谁懂？ 我见过太多同学，简历上写着“熟悉俞永福”，结果面试官一问底层逻辑，直接卡壳。 别慌，这份俞永福速查手册，就是为你准备的救命稻草。… · 2026/9/23 10:42:45
Talos Linux ImageCacheConfig 配置指南：本地镜像缓存开启与工作原理 Talos Linux ImageCacheConfig 配置指南：本地镜像缓存开启与工作原理 【免费下载链接】talos Talos Linux is a modern Linux distribution built for Kubernetes. 项目地址: https://gitcode.com/gh_mirrors/ta/talos
ImageCacheConfig 是 Talos Linux 中用… · 2026/9/23 10:42:45
IronClaw Google Sheets 扩展解析：get_spreadsheet 元数据操作的设计与实现 人工智能AI 应用交互助手AI Agent 【免费下载链接】ironclaw IronClaw is an Agent OS focused on privacy, security and extensibility 项目地址： https://gitcode.com/gh_mirrors/iro/ironclaw 点击查看 免费下载 本篇文章聚焦 IronClaw 开源仓库中 Google Shee… · 2026/9/23 11:24:39
搞定设备台账模板完整示例：从源码看数据结构设计 搞定设备台账模板完整示例：从源码看数据结构设计 你是不是也遇到过这种情况：刚学完 Python 或 Java，觉得语法都通了，但一接到“做一个设备台账系统”的需求就懵了？… · 2026/9/23 11:24:39
钢材系统源码深扒：3个核心坑点，保姆级教程助你面试通关 钢材系统源码深扒：3个核心坑点，保姆级教程助你面试通关 面试官问“钢材库存并发扣减怎么保证一致性”，你答了“加锁”，追问“锁粒度呢？死锁咋防？”直接卡壳。别慌，这篇 保姆级教程… · 2026/9/23 11:24:39
RTL8111E千兆网卡电路设计：PCIe接口、电源与MDI差分走线实战 简介：这份资源面向硬件工程师与PCB设计初学者，聚焦瑞昱RTL8111E高速以太网控制器的参考电路设计，帮助读者理解千兆网卡从原理图到布局的完整设计思路。压缩包内共1个PDF文件，约75KB，内容为RTL8111E/RTL8111F/RTL8105E的… · 2026/9/23 11:24:39
变异体杀手的诞生之路 /* MD / 富文本中的 .toc（含博客园搬家等嵌套结构）；.toc-box 在侧栏，不受影响 */#content_views .toc,/* 编辑器常在目录前后插入空 p（:empty 仍占 20px），一并去掉避免顶空隙 */#content_views.markdown_views > p:empty:has(+ .toc),#content_views.markdown_views … · 2026/9/23 11:24:33
ztoggle 性能优化：3 个核心考点拆解，面试不再卡壳 ztoggle 性能优化：3 个核心考点拆解，面试不再卡壳 翻过几百页的官方文档，却连最基础的 ztoggle 行为都说不清？别慌，这不是你的错。大厂面试官根本不想听你背诵定义，他们只关心你懂不懂底层逻辑，以及如何在高并发场景下做性能优化。… · 2026/9/23 11:24:33
3招搞定手机怎么下载微信面试难题实战项目解析 3招搞定手机怎么下载微信面试难题实战项目解析 面试被问“手机怎么下载微信”背后的原理，90%的人答不上来。别笑，这看似弱智的问题，实则是考察你对移动应用分发机制、安全校验及网络协议理解的试金石。我带过不少校招新人，他们背了八股文，却连一个A… · 2026/9/23 0:00:03
你有新短消息请注意查收：3个新手避坑指南搞定消息系统选型 你有新短消息请注意查收：3个新手避坑指南搞定消息系统选型 面试被问“高并发下如何保证消息不丢失”，你张口就是“用Redis”，结果面试官追问“如果Redis宕机了怎么办”，你瞬间卡壳。这种场景太常见了，很多新手在背八股文时，只记住了技术名词… · 2026/9/23 0:00:29
