尧图网页设计 
如何在Deep Code CLI中编写第一个Agent SkillSKILL.md写作完整教程【免费下载链接】deepcode-cliDeep Code 是专为 deepseek-v4 模型优化的终端 AI 编码助手支持深度思考、推理强度控制以及 Agent Skills。项目地址: https://gitcode.com/gh_mirrors/de/deepcode-cliDeep Code CLI 是专为 deepseek-v4 模型优化的终端 AI 编码助手支持深度思考、推理强度控制与 Agent Skills 扩展能力。本教程手把手教你从零编写第一个 Agent Skill7 个步骤搞定 SKILL.md 的存放位置、frontmatter 写法、正文结构与自动触发新手也能直接上手。一、Agent Skill 是什么把重复流程打包成技能Agent Skill 的本质是一个包含SKILL.md文件的目录。当任务匹配时Deep Code 会把它加载进会话让模型按你定义的流程执行。完整官方文档见 docs/agent-skills.md。✅ 适合写成 Skill会重复使用固定的代码审查流程、发布流程、文档生成流程说明太长每次粘贴进对话不方便需要配套资源模板、脚本、示例、参考文档有明确触发条件例如处理 PDF 表单❌ 不适合一次性任务要求 → 直接在对话里说当前仓库的短规则 → 写进AGENTS.md需要实时连接外部系统的能力 → 用 MCP 提供工具二、第一步选对 Skill 存放位置4 个扫描路径Deep Code CLI 按以下顺序扫描 Skills相同name只保留优先级最高的一个优先级范围路径建议用途1项目./.deepcode/skills/团队共享提交到仓库2项目./.agents/skills/跨客户端互操作3用户~/.deepcode/skills/个人使用新手推荐从这开始4用户~/.agents/skills/跨客户端互操作5内置built-in打包内置 skills无需手动放置每个 Skill 放在独立目录中目录里必须有SKILL.md~/.deepcode/skills/ └── code-review/ ├── SKILL.md └── scripts/ └── collect-diff.sh三、第二步写一个最小可用的 SKILL.md文件由两部分组成顶部 YAML frontmatter Markdown 正文。一个最小可运行的例子来自官方文档 docs/agent-skills.md--- name: code-review description: Review code changes for bugs, security risks, and missing tests. Use when the user asks for a code review, PR review, or diff review. --- # Code Review Use a code review mindset. Prioritize bugs over style comments. ## Workflow 1. Inspect the diff and surrounding code. 2. List findings first, ordered by severity. 3. Include file and line references for every finding.保存后启动deepcode在终端输入/skills能看到code-review就说明 Skill 已生效。四、第三步Frontmatter 三个字段这样写字段是否必填作用与写法建议name建议必填Skill 唯一名称用小写字母、数字、连字符与目录名保持一致description建议必填用于自动匹配任务也显示在/skills菜单中是最重要的字段metadata.allow-implicit-invocation可选设为false时不参与自动匹配只能手动选择⚠️ 注意Deep Code CLI 当前只解释上表中的字段。其他 frontmatter 字段可用于跨客户端互操作或文档说明但不会自动限制工具权限。五、第四步让 description 成为触发器自动调用的工作原理每次发送消息后Deep Code 会把每个可用 Skill 的name和description交给模型判断匹配上的 Skill 才会被加载。描述越具体匹配越可靠。推荐公式这个 skill 做什么. Use when 任务类型、文件类型、用户常见说法或触发词.✅ 好的示例description: Extract tables from PDF files, fill PDF forms, and merge documents. Use when working with PDFs, forms, or invoices.❌ 差的示例description: Helps with documents写完对照这份清单自查说明了具体能力而不是只写主题名说明了何时使用包含用户可能输入的关键词包含文件类型、框架名、命令名或领域名没有覆盖过宽导致无关任务也触发六、第五步正文写给 Agent 看SKILL.md正文的读者是 agent 而不是人写法要直接、可执行、可验证。推荐结构# Skill Name ## When to use - Use when ... - Do not use when ... ## Workflow 1. Read ... 2. Run ... 3. Edit ... 4. Verify ... ## Rules - Preserve ... - Never ... - Ask the user when ... ## Examples写作原则使用命令式步骤例如Run tests after editing把必须遵守的约束写成明确的 Rules对高风险操作写清边界删除文件、迁移数据、发送请求对常见分支写出决策规则例如如果没有配置文件先搜索默认路径一个完整的项目发布 Skill 示例可参考 docs/agent-skills.md。七、第六步用附加文件控制篇幅长资料不要全塞进SKILL.md多文件 Skill 的经典结构my-skill/ ├── SKILL.md # 核心流程与规则保持精简 ├── references/ # 长文档、规范、API 说明 ├── examples/ # 输入输出样例 ├── scripts/ # 可复用脚本 └── templates/ # 文档或代码模板内置多文件 Skill deepcode-self-refer/SKILL.md 值得参考正文只负责该读哪份文档→如何回答的流程全部资料都放在references/子目录中。八、第七步测试你的 Skill测试方式操作列表检查终端输入/skills确认 Skill 在列手动调用输入框输入/打开 skills 菜单选择对应 Skill自动调用输入匹配 description 的短语如帮我审查这段代码自动调用还有三条规则要心里有数已加载的 Skill 不会在同一会话中重复加载设置了allow-implicit-invocation: false的 Skill 不会自动加载没有匹配项时什么都不加载九、可选用 enabledSkills 启用或禁用在settings.json中按名称控制开关{ enabledSkills: { code-review: true, db-migration: false } }规则很简单未配置的 Skill 默认启用设为false会隐藏所有扫描位置中的同名 Skill项目设置覆盖用户设置。字段完整说明见 docs/configuration.md。十、常见问题速查 /skills中看不到 Skill依次检查目录是否位于 5 个扫描位置之一文件名是否恰好是SKILL.mdSkill 是否在独立目录中如.deepcode/skills/my-skill/SKILL.mdenabledSkills是否把它设为false同名 Skill 是否被更高优先级位置覆盖自动调用不稳定依次检查description是否包含清晰的使用场景和触发词Skill 是否过宽导致模型难以判断边界是否误设了allow-implicit-invocation: false用户请求是否更明确地提到了该 Skill 的领域或文件类型更多内容见 docs/agent-skills.md 的故障排查章节。十一、进阶让内置 Skill 帮你写 Skillskill-writer内置的技能写作助手会追问范围、建议存放位置、生成 frontmatter 并逐项校验——在对话里直接说帮我创建一个 Skill即可触发源码见 skill-writer/SKILL.mdskill-digester专门审查并改写已有 Skill 的description还能引导安装 Skill见 skill-digester/SKILL.mdskill工具的加载实现skill-handler.tsVSCode 插件与 CLI 共享~/.deepcode/settings.json及相同的 Skill 扫描位置在终端写好的 Skill 也能直接在编辑器中使用。总结在 Deep Code CLI 中写出第一个 Agent Skill核心就 4 个动作建目录放一个SKILL.mdfrontmatter 写好name 带触发词的description正文用命令式写清 Workflow 与 Rules用/skills验证再用自然语言反复调教会写 Skill 之后反复粘贴的指令就变成了可复用的能力——这正是 Agent Skill 相比直接粘贴提示词的最大价值。延伸阅读docs/agent-skills.md — Agent Skills 官方完整文档docs/agents-md.md — AGENTS.md 与 Skill 如何分工README.md — 项目概览与安装说明【免费下载链接】deepcode-cliDeep Code 是专为 deepseek-v4 模型优化的终端 AI 编码助手支持深度思考、推理强度控制以及 Agent Skills。项目地址: https://gitcode.com/gh_mirrors/de/deepcode-cli创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考 如何在Deep Code CLI中编写第一个Agent Skill：SKILL.md写作完整教程
如何在Deep Code CLI中编写第一个Agent SkillSKILL.md写作完整教程【免费下载链接】deepcode-cliDeep Code 是专为 deepseek-v4 模型优化的终端 AI 编码助手支持深度思考、推理强度控制以及 Agent Skills。项目地址: https://gitcode.com/gh_mirrors/de/deepcode-cliDeep Code CLI 是专为 deepseek-v4 模型优化的终端 AI 编码助手支持深度思考、推理强度控制与 Agent Skills 扩展能力。本教程手把手教你从零编写第一个 Agent Skill7 个步骤搞定 SKILL.md 的存放位置、frontmatter 写法、正文结构与自动触发新手也能直接上手。一、Agent Skill 是什么把重复流程打包成技能Agent Skill 的本质是一个包含SKILL.md文件的目录。当任务匹配时Deep Code 会把它加载进会话让模型按你定义的流程执行。完整官方文档见 docs/agent-skills.md。✅ 适合写成 Skill会重复使用固定的代码审查流程、发布流程、文档生成流程说明太长每次粘贴进对话不方便需要配套资源模板、脚本、示例、参考文档有明确触发条件例如处理 PDF 表单❌ 不适合一次性任务要求 → 直接在对话里说当前仓库的短规则 → 写进AGENTS.md需要实时连接外部系统的能力 → 用 MCP 提供工具二、第一步选对 Skill 存放位置4 个扫描路径Deep Code CLI 按以下顺序扫描 Skills相同name只保留优先级最高的一个优先级范围路径建议用途1项目./.deepcode/skills/团队共享提交到仓库2项目./.agents/skills/跨客户端互操作3用户~/.deepcode/skills/个人使用新手推荐从这开始4用户~/.agents/skills/跨客户端互操作5内置built-in打包内置 skills无需手动放置每个 Skill 放在独立目录中目录里必须有SKILL.md~/.deepcode/skills/ └── code-review/ ├── SKILL.md └── scripts/ └── collect-diff.sh三、第二步写一个最小可用的 SKILL.md文件由两部分组成顶部 YAML frontmatter Markdown 正文。一个最小可运行的例子来自官方文档 docs/agent-skills.md--- name: code-review description: Review code changes for bugs, security risks, and missing tests. Use when the user asks for a code review, PR review, or diff review. --- # Code Review Use a code review mindset. Prioritize bugs over style comments. ## Workflow 1. Inspect the diff and surrounding code. 2. List findings first, ordered by severity. 3. Include file and line references for every finding.保存后启动deepcode在终端输入/skills能看到code-review就说明 Skill 已生效。四、第三步Frontmatter 三个字段这样写字段是否必填作用与写法建议name建议必填Skill 唯一名称用小写字母、数字、连字符与目录名保持一致description建议必填用于自动匹配任务也显示在/skills菜单中是最重要的字段metadata.allow-implicit-invocation可选设为false时不参与自动匹配只能手动选择⚠️ 注意Deep Code CLI 当前只解释上表中的字段。其他 frontmatter 字段可用于跨客户端互操作或文档说明但不会自动限制工具权限。五、第四步让 description 成为触发器自动调用的工作原理每次发送消息后Deep Code 会把每个可用 Skill 的name和description交给模型判断匹配上的 Skill 才会被加载。描述越具体匹配越可靠。推荐公式这个 skill 做什么. Use when 任务类型、文件类型、用户常见说法或触发词.✅ 好的示例description: Extract tables from PDF files, fill PDF forms, and merge documents. Use when working with PDFs, forms, or invoices.❌ 差的示例description: Helps with documents写完对照这份清单自查说明了具体能力而不是只写主题名说明了何时使用包含用户可能输入的关键词包含文件类型、框架名、命令名或领域名没有覆盖过宽导致无关任务也触发六、第五步正文写给 Agent 看SKILL.md正文的读者是 agent 而不是人写法要直接、可执行、可验证。推荐结构# Skill Name ## When to use - Use when ... - Do not use when ... ## Workflow 1. Read ... 2. Run ... 3. Edit ... 4. Verify ... ## Rules - Preserve ... - Never ... - Ask the user when ... ## Examples写作原则使用命令式步骤例如Run tests after editing把必须遵守的约束写成明确的 Rules对高风险操作写清边界删除文件、迁移数据、发送请求对常见分支写出决策规则例如如果没有配置文件先搜索默认路径一个完整的项目发布 Skill 示例可参考 docs/agent-skills.md。七、第六步用附加文件控制篇幅长资料不要全塞进SKILL.md多文件 Skill 的经典结构my-skill/ ├── SKILL.md # 核心流程与规则保持精简 ├── references/ # 长文档、规范、API 说明 ├── examples/ # 输入输出样例 ├── scripts/ # 可复用脚本 └── templates/ # 文档或代码模板内置多文件 Skill deepcode-self-refer/SKILL.md 值得参考正文只负责该读哪份文档→如何回答的流程全部资料都放在references/子目录中。八、第七步测试你的 Skill测试方式操作列表检查终端输入/skills确认 Skill 在列手动调用输入框输入/打开 skills 菜单选择对应 Skill自动调用输入匹配 description 的短语如帮我审查这段代码自动调用还有三条规则要心里有数已加载的 Skill 不会在同一会话中重复加载设置了allow-implicit-invocation: false的 Skill 不会自动加载没有匹配项时什么都不加载九、可选用 enabledSkills 启用或禁用在settings.json中按名称控制开关{ enabledSkills: { code-review: true, db-migration: false } }规则很简单未配置的 Skill 默认启用设为false会隐藏所有扫描位置中的同名 Skill项目设置覆盖用户设置。字段完整说明见 docs/configuration.md。十、常见问题速查 /skills中看不到 Skill依次检查目录是否位于 5 个扫描位置之一文件名是否恰好是SKILL.mdSkill 是否在独立目录中如.deepcode/skills/my-skill/SKILL.mdenabledSkills是否把它设为false同名 Skill 是否被更高优先级位置覆盖自动调用不稳定依次检查description是否包含清晰的使用场景和触发词Skill 是否过宽导致模型难以判断边界是否误设了allow-implicit-invocation: false用户请求是否更明确地提到了该 Skill 的领域或文件类型更多内容见 docs/agent-skills.md 的故障排查章节。十一、进阶让内置 Skill 帮你写 Skillskill-writer内置的技能写作助手会追问范围、建议存放位置、生成 frontmatter 并逐项校验——在对话里直接说帮我创建一个 Skill即可触发源码见 skill-writer/SKILL.mdskill-digester专门审查并改写已有 Skill 的description还能引导安装 Skill见 skill-digester/SKILL.mdskill工具的加载实现skill-handler.tsVSCode 插件与 CLI 共享~/.deepcode/settings.json及相同的 Skill 扫描位置在终端写好的 Skill 也能直接在编辑器中使用。总结在 Deep Code CLI 中写出第一个 Agent Skill核心就 4 个动作建目录放一个SKILL.mdfrontmatter 写好name 带触发词的description正文用命令式写清 Workflow 与 Rules用/skills验证再用自然语言反复调教会写 Skill 之后反复粘贴的指令就变成了可复用的能力——这正是 Agent Skill 相比直接粘贴提示词的最大价值。延伸阅读docs/agent-skills.md — Agent Skills 官方完整文档docs/agents-md.md — AGENTS.md 与 Skill 如何分工README.md — 项目概览与安装说明【免费下载链接】deepcode-cliDeep Code 是专为 deepseek-v4 模型优化的终端 AI 编码助手支持深度思考、推理强度控制以及 Agent Skills。项目地址: https://gitcode.com/gh_mirrors/de/deepcode-cli创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考