我们从一个案例来学习command的使用
---
description: 公众号文章全自动创作,从信息收集到成稿保存
argument-hint: <主题关键词>
allowed-tools:
- Read
- Write
- WebSearch
- Grep
---
# 公众号文章创作系统
你是资深公众号写作专家,擅长创作接地气、有深度的技术科普文章。
**主题**:$ARGUMENTS
## 执行步骤
1. **信息收集**:WebSearch 搜索"$ARGUMENTS 最新资讯 2025",收集核心概念、最新动态、用户痛点
2. **构思大纲**:金句开头 → 问题引入(2-3段) → 核心内容(5-8段) → 总结号召
3. **撰写文章**:说人话、用类比、多短句,字数 1500-2000,每段≤150字
4. **保存文章**:Write 保存到 `articles/drafts/[日期]_[主题].md`
5. **生成标题**:5个备选标题(含数字、引发好奇、≤30字)
## 输出格式
# [选定标题]
[文章正文]
---
## 备选标题
1. [标题1] ... 5. [标题5]
command的使命
把重复的提示词压缩成一个词,一次配置,永久生效
command的位置
在全局或者当前项目的.claude下新建commands目录, 创建 <命名>.md.文件。重启claude。输入 /命名 就能使用。
自定义命令
命令文件由两部分组成:YAML frontmatter 配置区(机器读)+ Markdown 正文(AI 读)。
如上面得markdown文件。
```
description: 公众号文章全自动创作,从信息收集到成稿保存
argument-hint: <主题关键词>
allowed-tools:
- Read
- Write
- WebSearch
- Grep
```
这部分就是给机器读取的。
| 配置项 | 作用 |
|---|---|
description |
命令描述,显示在 /help 和 Tab 补全中 |
argument-hint |
输入命令后显示的参数占位符提示 |
allowed-tools |
限制可调用的工具(安全边界) |
model |
强制指定模型,覆盖当前会话模型,非必须 |
disable-model-invocation |
设为 true 时只做文本替换,不调用 AI |
可调用的工具allowed-tools包括:
| 工具名 | 功能 | 常用场景 |
|---|---|---|
Read |
读取文件 | 分析代码、读取配置 |
Write |
写入新文件 | 创建文件、保存结果 |
Edit |
编辑已有文件 | 修改代码 |
Bash |
执行命令 | 运行测试、Git 操作 |
WebSearch |
网络搜索 | 获取最新信息 |
WebFetch |
抓取网页内容 | 下载指定页面分析 |
Glob |
按文件名匹配查找 | 批量找 *.md、*.ts |
Grep |
按内容搜索文件 | 找含 TODO 的代码 |
Task |
启动子代理 | 并行执行复杂任务 |
TodoWrite |
任务管理 | 创建和更新待办清单 |
参数获取
在md文件中,使用 $ARGUMENTS 进行参数获取。多参数解析和空值校验直接用自然语言在提示词中描述即可:
$ARGUMENTS 格式:<主题> [风格] [字数]
- 第一个词:主题(必需,若为空请提示用户补充)
- 第二个词:风格(可选,默认"接地气")
- 第三个词:字数(可选,默认 1500)
条件分支
根据 $ARGUMENTS 判断:
- 包含"深度"或"详细" → 深度分析,输出 3000 字以上完整报告
- 包含"快速"或"简要" → 快速分析,输出 500 字以内摘要
- 其他情况(默认) → 标准分析,输出 1500 字标准报告
命令组合与链式调用
当你定义了多个可复用的commons。先 /research 主题 生成素材文件,再 /write 主题 读取该文件写作。这样让多个命令组合调用。
另外:commands和skills的区别?
Commands(命令)
-
是用户通过特定指令(以“/”开头)直接调用的功能
-
用于控制对话流程或触发特定操作
-
示例:
/reset重置对话,/help获取帮助
Skills(技能)
-
是 Claude 内置的专业能力模块
-
在对话中自动识别场景并调用相应技能
-
包括:代码编写、文本分析、创意写作、逻辑推理、数学计算等
-
用户无需特殊指令,Claude 会根据对话内容自动应用
简单来说
-
你用 Commands 来“指挥”Claude
-
Claude 用 Skills 来“服务”你
Commands中调用mcp
---
allowed-tools:
- mcp__github__create_issue
- mcp__filesystem__read_file
- mcp__brave-search__brave_web_search
---
格式:mcp__服务器名__工具名
- THE END -
最后修改:2026年3月25日
非特殊说明,本博所有文章均为博主原创。
如若转载,请注明出处:https://www.puxiaoshuai.top/?p=251
