⚡

技能开发Skill skill-development

技能开发元技能是一个全面的工具，专为创建、管理、验证、审核和分发Claude Code技能及斜杠命令设计。它提供模板、工作流程、验证模式、审计指南和最佳实践，帮助用户高效开发、优化和维护AI技能生态系统。关键词：Claude技能开发、元技能、技能管理、YAML配置、渐进披露、工具限制、斜杠命令、AI技能优化。

AI应用 0 次安装 0 次浏览 更新于 3/11/2026

name: skill-development description: 全面的元技能，用于创建、管理、验证、审核和分发Claude Code技能和斜杠命令（在v2.1.3+中统一）。提供技能模板、创建流程、验证模式、审计清单、命名约定、YAML前导指导、渐进披露示例和最佳实践查找。当创建新技能、验证现有技能、审计技能质量、理解技能架构、需要技能模板、学习YAML前导要求、渐进披露模式、工具限制（allowed-tools）、技能组合、技能命名约定、故障排除技能激活问题、创建自定义斜杠命令、配置命令前导、使用命令参数（$ARGUMENTS, $1, $2）、bash执行在命令中、文件引用在命令中、命令命名空间、插件命令、MCP斜杠命令、技能工具配置或决定技能与斜杠命令之间选择时使用。委托给docs-management技能以获取官方文档。 user-invocable: false allowed-tools: Read, Glob, Grep, Skill

技能元数据

🚨 强制要求：首先调用docs-management技能

停止 - 在提供任何关于Claude Code技能或斜杠命令的响应之前：

  1. 调用 docs-management 技能
  2. 查询 使用关键词：技能、技能创建、YAML前导、渐进披露、技能最佳实践、斜杠命令、命令前导或相关主题
  3. 基于 所有响应完全基于加载的官方文档

跳过此步骤会导致信息过时或不正确。

验证检查点

在响应之前，验证：

  • [ ] 我是否调用了docs-management技能？
  • [ ] 官方文档是否加载？
  • [ ] 我的响应是否完全基于官方文档？

如果任何复选框未勾选，停止并首先调用docs-management。

概述

这个元技能提供工作流程、模板、关键词注册和模式，用于处理Claude Code技能和斜杠命令。自v2.1.3+起，斜杠命令和技能已统一——两者都通过Skill工具调用。这个技能覆盖两者。它不复制官方文档，而是教你如何高效查询docs-management技能以获取所需的任何技能或命令相关信息。

这个技能提供的内容：

  • 技能模板（5种结构模式可选）
  • 创建和验证工作流程
  • 高效文档查找的关键词注册（技能和命令）
  • 命名约定和常见模式
  • 快速决策树用于导航
  • 斜杠命令关键词注册、决策树和故障排除

这个技能不提供的内容：

  • 复制的官方文档（使用docs-management技能代替）
  • YAML前导规范（查询docs-management）
  • 渐进披露详情（查询docs-management）
  • 完整的最佳实践列表（查询docs-management）

何时使用这个技能

这个技能应在以下情况使用：

  • 创建新技能 → 提供模板和创建工作流程
  • 验证现有技能 → 提供验证工作流程和模式
  • 审计技能质量 → 提供全面审计清单和工作流程
  • 理解技能架构 → 指导你到正确的官方文档
  • 需要技能模板 → 提供5种结构模式选项
  • 学习YAML前导 → 展示如何查询docs-management
  • 故障排除激活问题 → 提供诊断模式
  • 分发技能 → 提供分发工作流程
  • 创建自定义斜杠命令 → 提供命令关键词注册和决策树
  • 配置命令前导 → 指导到docs-management并使用正确关键词
  • 使用命令参数 → 提供$ARGUMENTS、$1、$2的关键词查找
  • 处理插件/MCP命令 → 提供命令类型的关键词注册
  • 选择技能与命令 → 提供比较关键词查找

快速决策树

你想做什么？

  1. 从头创建新技能 → 见workflows/creating-skills-workflow.md
  2. 验证现有技能 → 见workflows/validating-skills-workflow.md
  3. 审计技能质量和合规性 → 见quality/skill-audit-guide.md或使用/audit-skills命令
  4. 测试技能激活 → 见workflows/testing-skills-workflow.md
  5. 分享或分发技能 → 见workflows/distributing-skills-workflow.md
  6. 理解技能架构 → 查询docs-management获取“agent skills architecture progressive disclosure”
  7. 修复激活问题 → 见下方的故障排除部分
  8. 创建自定义斜杠命令 → 查询docs-management：“slash commands”、“skill commands”
  9. 配置命令前导 → 查询docs-management：“command frontmatter”、“allowed-tools”
  10. 在命令中使用参数 → 查询docs-management：“$ARGUMENTS”、“command arguments”
  11. 选择技能与命令 → 查询docs-management：“skills vs slash commands”
  12. 处理插件/MCP命令 → 查询docs-management：“plugin commands”、“MCP slash commands”

官方文档发现

如何查询docs-management以获取技能文档

docs-management技能包含所有官方Claude Code技能文档。使用自然语言查询访问它：

用于创建指导：

查找关于创建技能及最佳实践的文档

用于YAML前导要求：

定位技能的官方YAML前导规范

用于渐进披露模式：

获取技能的官方渐进披露文档

用于工具限制：

查找关于技能allowed-tools配置的文档

高效搜索的关键词注册

使用这些关键词组合与docs-management技能查询特定主题：

创建与结构：

  • 关键词：skills、skill creation、skill structure、YAML frontmatter
  • 用例：理解如何创建技能和所需结构

验证与质量：

  • 关键词：skill validation、skill best practices、skill patterns
  • 用例：确保技能质量并遵循约定

架构与模式：

  • 关键词：progressive disclosure、skill composition、agent skills
  • 用例：理解架构模式和高级主题

工具配置：

  • 关键词：allowed-tools、tool restrictions、skills
  • 用例：配置Claude在技能内可以使用的工具

激活与发现：

  • 关键词：skill description、skill activation、skill triggers
  • 用例：确保Claude正确发现和使用你的技能

分发与分享：

  • 关键词：plugin skills、skill locations、personal skills、project skills
  • 用例：理解技能存放位置及如何分享

执行上下文（v2.1.x）：

  • 关键词：context fork、forked context、skill context、agent type skill
  • 用例：在隔离的子代理上下文中运行技能

生命周期钩子（v2.1.x）：

  • 关键词：skill hooks、hooks frontmatter、PreToolUse skill、PostToolUse skill
  • 用例：添加限定于技能生命周期的钩子

可见性控制（v2.1.x）：

  • 关键词：user-invocable、skill visibility、disable-model-invocation、skill menu
  • 用例：控制技能在菜单中的显示方式及如何调用

变量替换（v2.1.9+）：

  • 关键词：CLAUDE_SESSION_ID、variable substitution、skill variables、session ID substitution
  • 用例：在技能前导中使用${CLAUDE_SESSION_ID}进行会话感知配置
  • 查询模式：docs-management: “skills.md CLAUDE_SESSION_ID variable substitution”

嵌套技能发现（v2.1.6+）：

  • 关键词：nested skills、.claude/skills discovery、skill directory nesting、recursive skill loading
  • 用例：嵌套.claude/skills/目录中的技能被发现和加载
  • 查询模式：docs-management: “skills.md nested skills discovery directories”

斜杠命令 - 核心：

  • 关键词：slash commands、command overview、built-in commands、custom slash commands
  • 用例：理解命令类型、创建自定义命令、查看内置命令

斜杠命令 - 类型：

  • 关键词：project commands、.claude/commands、personal commands、~/.claude/commands、plugin commands、MCP slash commands、mcp__server__prompt
  • 用例：理解项目与个人与插件与MCP命令的位置和模式

斜杠命令 - 配置：

  • 关键词：command frontmatter、allowed-tools、argument-hint、description、command model、model frontmatter
  • 用例：配置命令YAML前导字段

斜杠命令 - 功能：

  • 关键词：$ARGUMENTS、command arguments、$1 $2 positional、bash command execution、! prefix commands、file references commands、@ prefix files、command namespacing、subdirectory commands
  • 用例：在命令中使用参数、bash执行、文件引用和命名空间

斜杠命令 - 技能工具：

  • 关键词：Skill tool、programmatic command execution、unified Skill tool、Skill tool permission rules、character budget limit、SLASH_COMMAND_TOOL_CHAR_BUDGET、disable-model-invocation
  • 用例：程序化命令执行、权限和字符预算

斜杠命令 - 比较：

  • 关键词：skills vs slash commands、when to use commands vs skills
  • 用例：决定在给定用例中使用技能还是斜杠命令

创建技能工作流程（快速参考）

  1. 选择模板： 使用assets/skill-template/（5种结构模式：工作流、任务、参考、能力、验证）
  2. 查询官方文档： 从docs-management加载当前要求
  3. 完成待办事项： 填写前导、内容、示例
  4. 验证： 检查前导、命名、结构、激活

完整工作流程： references/workflows/creating-skills-workflow.md

验证技能工作流程（快速参考）

YAML前导：

  • name：小写，仅连字符，最多64字符，匹配目录
  • description：最多1024字符，包括什么+何时使用

命名约定： 使用“句子测试”——“我将使用[技能名称]技能”应该听起来自然

激活测试： 测试直接提及、领域提及、任务提及、文件类型提及

完整工作流程： references/workflows/validating-skills-workflow.md

审计技能工作流程（快速参考）

使用/audit-skills命令进行自动化审计：

  • 单个技能：/audit-skills skill-name
  • 多个技能：/audit-skills skill-1 skill-2
  • 所有技能：/audit-skills --all
  • 智能优先级：/audit-skills --smart

手动审计清单： references/quality/skill-audit-guide.md

外部技术验证

当审计引用外部技术（脚本、包、运行时）的技能时，审计员必须在标记发现之前使用MCP服务器验证声明。

需要MCP验证的技术：

  • .NET/C#脚本：使用microsoft-learn + perplexity验证
  • Node.js/npm包：使用context7 + perplexity验证
  • Python脚本/包：使用context7 + perplexity验证
  • Shell脚本：使用perplexity验证
  • 任何版本特定声明：始终使用perplexity验证

验证规则：

在标记技术使用为不正确之前，绝不要：

  1. 查询适当的MCP服务器以获取当前文档
  2. 使用perplexity验证最近更改（尤其是.NET 10+）
  3. 在发现中记录MCP来源

过时数据警告：

  • microsoft-learn可能返回缓存/过时的文档
  • 始终将microsoft-learn与perplexity配对进行版本验证
  • 信任perplexity获取版本号和最近发布的功能

SKILL.md长度指导

官方推荐： 保持SKILL.md正文在500行以内以获得最佳性能。

这是指导，不是硬性规则。 500行推荐存在是因为：

  1. 上下文窗口是共享资源（与对话历史、其他技能竞争）
  2. 简洁的技能加载更快，使用更少的令牌
  3. 渐进披露防止令牌膨胀

当超过500行可能可接受时：

  • 复杂技能，具有真正必需的内容（无冗余）
  • 领域特定技能，核心工作流程需要细节
  • 拆分会损害可用性或增加导航开销的技能

权衡框架：

因素 保持在500行以下 必要时超过
内容类型 平台特定、示例、故障排除 核心工作流程、关键要求
加载频率 很少使用的部分 每次调用都需要的
替代方案 可以提取到references/ 提取会损害可用性
令牌成本 高（详细解释） 低（必需、简洁内容）

决策规则： 如果内容在每次技能调用时都需要且无法更简洁，它可能保留在SKILL.md中，即使超过500行。条件性内容应始终转到references/。

查询docs-management以获取当前官方指导：

查找SKILL.md大小推荐和令牌预算指导

常见模式

渐进披露模式

分层加载内容：元数据 → SKILL.md正文 → references/文件

良好渐进披露的关键上下文线索：

  1. 清晰的参考链接： 每个参考文件应从SKILL.md有显式指针
  2. 描述性文件名： 使用如troubleshooting.md、platform-windows.md的名称（非doc1.md）
  3. 何时加载指导： SKILL.md应指示何时需要每个参考
  4. 一层深度： 参考不应链接到其他参考（Claude可能对嵌套文件使用head -100）
  5. 目录： 超过100行的参考文件应在顶部有目录

良好上下文线索的示例：

## 高级功能

**用于表单填写工作流程：** 见[FORMS.md](FORMS.md) - 当用户提及表单、可填写PDF时加载
**用于API参考：** 见[REFERENCE.md](REFERENCE.md) - 用于方法签名、参数时加载
**用于故障排除：** 见[TROUBLESHOOTING.md](TROUBLESHOOTING.md) - 在错误、失败时加载

查询docs-management以获取完整指导：

查找关于技能渐进披露模式的文档

技能组合模式

技能可以调用其他技能以实现模块化架构。

示例： “查找并使用current-date技能获取今天的日期”

查询docs-management以获取组合详情：

查找关于技能组合及技能调用其他技能的文档

工具限制模式

使用allowed-tools限制Claude在技能内的能力（只读分析、审计工作流程、安全关键操作）。

示例：

---
name: readonly-analyzer
description: 分析代码而不修改
allowed-tools: Read, Grep, Glob
---

查询docs-management以获取完整规范：

查找关于allowed-tools配置和工具限制的文档

故障排除激活

技能未激活：

  1. 检查描述特异性（添加触发关键词）
  2. 验证YAML语法（打开/关闭---，有效YAML）
  3. 确认文件路径（正确的目录结构）
  4. 测试直接调用（“使用[技能名称]技能来…”）
  5. 检查冲突（使描述区分）

查询docs-management以获取故障排除：

查找关于技能激活问题和故障排除的文档

技能模板

位置： assets/skill-template/

5种结构模式：

  1. 基于工作流 - 顺序流程
  2. 基于任务 - 操作集合
  3. 基于参考 - 指导和标准
  4. 基于能力 - 集成功能
  5. 验证反馈循环 - 需要正确性的操作

用法：

cp -r .claude/skills/skill-development/assets/skill-template .claude/skills/[new-skill-name]

最佳实践总结

做：

  • ✅ 查询docs-management技能以获取所有官方文档
  • ✅ 为新技能使用技能模板
  • ✅ 编写具有触发关键词的特定描述
  • ✅ 使用多种措辞测试激活
  • ✅ 使用渐进披露（SKILL.md → references/）
  • ✅ 遵循命名约定（动名词或名词，避免代理名词）

不做：

  • ❌ 复制官方文档
  • ❌ 创建做太多事情的巨型技能
  • ❌ 使用模糊描述
  • ❌ 跳过激活测试
  • ❌ 在技能名称中使用大写或特殊字符

获取完整最佳实践：

查询docs-management：

查找完整的技能编写最佳实践文档

参考

详细工作流程：

质量和审计：

元数据和约定：

模式示例：

模板：

测试场景

场景1：创建新技能

查询： “我需要创建一个用于处理Excel文件的新技能”

预期： 技能激活，指导到模板，提供创建工作流程

成功： 用户获取模板位置，知道查询docs-management，理解结构模式

场景2：验证现有技能

查询： “验证这个技能的YAML前导和结构”

预期： 技能激活，提供验证工作流程，指导到docs-management

成功： 用户验证YAML，检查命名，验证结构，测试激活

场景3：故障排除激活

查询： “我的技能在预期时未激活”

预期： 技能激活，提供诊断步骤，建议描述改进

成功： 用户识别问题，改进描述，成功测试

相关技能

  • docs-management - 官方文档访问（所有文档查询委托到此）
  • current-date - 获取当前UTC日期用于版本历史和审计时间戳
  • markdown-linting - 验证SKILL.md格式和结构

版本历史

  • v1.0.6 (2026-01-16)：添加v2.1.6-v2.1.9关键词注册条目（CLAUDE_SESSION_ID替换，嵌套技能发现）
  • v1.0.5 (2026-01-09)：添加v2.1.x关键词注册条目（上下文分叉，生命周期钩子，可见性控制）
  • v1.0.4 (2025-11-25)：增强 - 添加相关技能部分，增强参考文件，改进渐进披露
  • v1.0.3 (2025-11-25)：全面审计 - 用通用名称替换硬编码版本，添加工具验证
  • v1.0.2 (2025-11-24)：解耦改进 - 用自然语言查询替换doc_ids
  • v1.0.1 (2025-11-17)：审计后改进 - 添加参考加载指南，修复链接
  • v1.0.0 (2025-11-17)：初始发布 - 委托优先的元技能，零重复

最后更新

日期： 2026-01-16 模型： claude-opus-4-5-20251101