声明：本文为学习笔记与工程化延伸，核心脉络来自阿里云开发者技术号发布的《AI coding 智能体设计》，在此基础上按“可落地教程”的方式重组，并补充可直接复用的命令设计清单与示例；如有出入，以原文与官方文档为准。原文链接见文末参考。
你有没有发现：同样是 AI coding，有的产品更像“聊天”，有的更像“工具”？
区别之一，就是它有没有把高频动作沉淀成/命令（slash commands）。
这一篇我们就只讲一件事：命令系统怎么做，才能把 AI 从“会说”变成“会做”，并且可扩展、可维护？
01｜命令系统解决的不是“便利”，而是“确定性”
自然语言很强，但也很贵：
贵在歧义、贵在重复解释、贵在难复用、贵在难审计。
而 /命令的价值是把一类动作变成确定操作：
- 清空/压缩上下文
- 初始化项目理解
- 生成变更清单/测试计划/安全审查
- 把某个“提示词模板”变成可重复执行的子命令
一句话：命令系统是在给智能体加“操作系统层”。
02｜命令从哪来？四层来源（以 Gemini-CLI 的思路做抽象）
《AI coding 智能体设计》在分析 Gemini-CLI 时提到：当输入第一个字符是/，会被识别为命令；命令不止内置一种来源，通常会分层：
- 内置命令：产品自带（例如清空对话、重置上下文、初始化等）
- MCP Server 提供的提示词命令：MCP 不只提供工具，也可以提供“提示词命令”，在 CLI 里像新增了子命令
- 扩展包命令：安装扩展后新增命令（带扩展标识，便于区分来源）
- 本地自定义命令：用户级/项目级放一个配置文件（如 toml），把常用提示词封装成命令
你不一定要用 Gemini-CLI，但这种分层非常值得借鉴：内核稳定 + 插件扩展 + 项目定制 + 个人习惯，不会互相污染。
03｜命令设计三条硬约束（做不到就别上命令）
很多团队一上来就把一堆提示词封装成命令，结果越用越乱。下面三条约束建议写进团队规范：
命令只做一件事（single-responsibility）
/clear就是清空，不要顺便改配置/review就是审查，不要顺便重构半个项目
命令输出必须可被下一步消费（machine-actionable）
- 最好输出：列表、路径、JSON、可执行步骤
- 避免输出：泛泛建议、无验证的结论
命令权限要最小化（least privilege）
- 默认只读：读文件/搜索/列目录
- 写操作要有“确认点”或白名单范围
04｜把提示词模板“升级”为命令：一个通用落地模板
你可以把命令当成“提示词模板 + 结构化输出协议”。
这里给一个可直接复制的模板（适用于多数 AI coding 工具）：
命令名：/audit 用途：对本次改动做工程化审查（可运行、可回滚、可验证） 输入（由系统提供）： - 已变更文件列表（如果没有，先让工具列出来） - 关键代码片段（如果没有，先读取） 输出（必须严格按结构）： 1) 改动摘要（最多 6 行） 2) 风险点（按 P0/P1/P2 分级） 3) 必须补的测试（给到测试点与示例用例） 4) 回滚策略（怎么撤回） 5) 验证步骤（本地/CI 各 1 套）这类命令在团队里特别有价值：让每个人用同一套“输出协议”对齐。
05｜（可选）本地自定义命令：用 toml/配置文件把命令放进项目
《AI coding 智能体设计》里提到 Gemini-CLI 支持在用户级/项目级目录放*.toml自定义命令。即便你不用同款工具，也强烈建议你保留这个思路：
命令应该跟项目走，别跟聊天记录走。
一个最小 toml 结构示例（示意）：
description = "生成本仓库的变更任务清单（带验收标准）" prompt = """ 请根据 @README.md @docs/ @src/ 的上下文，生成 tasks.md。 要求：每条任务可验证、可勾选、带风险与验证步骤。 输出：仅输出 Markdown 清单。 """你可以把它放在项目目录里，让团队所有人共享同一套命令。
06｜命令系统的“最小集”：我建议先落这 8 个
别一上来做 50 个命令。先把高频、低风险、收益大的 8 个做起来：
/clear：清空上下文，避免串台/compress：压缩历史（保留关键约束）/files：列出项目结构与关键入口（只读）/locate <symbol>：定位函数/类/接口定义（只读）/plan：把需求拆成 tasks.md（可验证）/review：对改动做审查（风险/测试/回滚）/testplan：生成测试点与用例/release-note：生成变更说明（面向发布）
注意：其中 4 个是“流程命令”（plan/review/testplan/release-note），它们会大幅降低团队对齐成本。
07｜排错清单：为什么你的命令“不好用”？
- 命令目标太宽：一条命令让它“顺便重构、顺便加测试、顺便写文档”
- 处理：拆命令；每条只做一件事
- 命令没有输出协议：导致每次输出风格不一，难验收
- 处理：固定结构 + 强制“验证步骤”
- 命令依赖的上下文不稳定：没给 @路径/没给文件列表
- 处理：命令内部第一步先拉取上下文（读文件/列目录）
- 权限不受控：命令动辄大改代码，难合并
- 处理：默认只读；写操作加确认点/白名单
08｜系列导航（收藏用）
- 系列 01：从 Chat 到 Agent：4 个关键零件
- 系列 02（本文）：命令系统：从提示词模板到可扩展子命令
- 系列 03：@路径上下文：如何给材料而不喂爆上下文
- 系列 04：MCP 与工具闭环：注册、调用、回填与失败恢复
- 系列 05：上下文治理：清空/压缩/摘要与预算控制
- 系列 06：SubAgent：上下文隔离与模块化协作
- 系列 07：规约驱动：让交付可复现的 Spec 工作流
- 系列 08：迷你 CLI：从伪代码到最小可运行骨架
参考与致谢
- 阿里云开发者技术号原文：《AI coding 智能体设计》
- Gemini-CLI 命令文档：docs/cli/commands.md
