用途：该资料是 AI 智能体技能的设计与开发指南，适用于创建 Claude Code 技能与 MCP 工具、编写或评审 SKILL.md 元数据与描述、优化技能触发可靠性、按渐进式披露组织内容、测试技能激活与行为，以及为智能体工作流设计工具接口。
核心原则：一，描述决定激活，Claude 依据描述与用户意图匹配来选择技能，需写明具体能力、触发关键词与否定场景；描述模糊会导致激活不稳定或不激活。二，关键指令前置，Claude 可能截断长内容，不可协商的规则应放在前 100 行。三，渐进式披露节省 token，按 SKILL.md（概览）→ references/（细节）→ scripts/（执行）组织。四，测试激活而非只测执行，技能能正常运行但从不触发则毫无价值，需用真实用户措辞、同义词与边界情况测试。五，一个领域一个技能，重叠技能会造成激活冲突，应按语言、框架或工作流阶段拆分并使用不同触发关键词。
规则分类与优先级：技能元数据设计（CRITICAL，前缀 meta-）含名称小写连字符、不以连字符开头结尾、避免连续连字符、全局唯一、必填 frontmatter、仅用允许字段、YAML 语法有效、名称少于 64 字符、名称与目录一致；描述工程（CRITICAL，desc-）含写明具体能力、包含触发关键词、第三人称、长度优化、避免模糊词、区分相似技能、包含否定场景；内容结构（HIGH，struct-）含统一标题层级、关键指令靠前、祈使句、代码块标注语言、SKILL.md 少于 500 行、单一职责、保留仓库约定；触发优化（HIGH，trigger-）含斜杠命令别名、文件类型模式、工作流阶段、错误模式、同义词覆盖；渐进式披露（MEDIUM-HIGH，prog-）含三级披露、引用链接不超一层、执行脚本而非阅读代码、惰性加载示例、互斥上下文分离；MCP 工具设计（MEDIUM，mcp-）含动作加对象命名、参数文档、可执行错误信息、单一用途、allowed-tools 安全约束、幂等操作；测试与验证（MEDIUM，test-）含真实措辞触发测试、边界输入、否定场景不触发、全新上下文下的指令清晰度；维护与分发（LOW-MEDIUM，maint-）含语义化版本、变更日志、插件打包分发、外部来源安装前安全审计。
用法与限制：创建规则可复制 assets/templates/_template.md 并遵循 frontmatter 模式，含 title、impact（CRITICAL|HIGH|MEDIUM-HIGH|MEDIUM|LOW-MEDIUM|LOW）、impactDescription、tags；引用文件采用 references/{prefix}-{slug}.md。资料中未提供安装命令、收费、价格或平台支持信息。