用途:本技能是 Claude Code 插件构件格式的权威参考,适用于编写、评审或校验插件组件(清单、命令、智能体、技能、规则、钩子、记忆文件),也可用于对 NL 构件做 lint。
主要能力:
- 插件清单 plugin.json:位于 .claude-plugin/plugin.json,必需字段 name(kebab-case);可选 version(semver)、description、author、homepage、repository、license(SPDX)、keywords,以及组件路径字段 commands、agents、skills、hooks、mcpServers、lspServers、outputStyles(字符串或字符串数组)。
- 命令 frontmatter(commands/*.md):必需 description;可选 name(官方文档称显式可选,省略时回退到文件名或所在目录)、argument-hint、allowed-tools、model(haiku/sonnet/opus)、user-invocable。正文用命令式语气面向 Claude,多阶段流程用编号步骤,显式定义输出格式,可用相对路径引用共享片段。
- 共享片段(commands/shared/):必须写 user-invocable: false 以免出现在顶层命令菜单,需有清晰 description,由消费命令按完整相对路径引用。
- 智能体 frontmatter(agents/*.md):name、description(建议含 3 个以上具体触发短语,最好附 2 个以上 <example> 块);建议声明 model、color(cyan/blue/magenta/yellow/green/red)、tools(JSON 数组或逗号分隔字符串)、skills(JSON 数组或 YAML 列表)。
- 技能结构(SKILL.md,跨工具开放标准):必需 name(1-64 字符,小写加连字符,须与父目录同名)和 description(1-1024 字符,说明做什么与何时用);可选 license、compatibility(≤500 字符)、metadata、allowed-tools(实验性)。路径约定涵盖 Claude Code、Codex、Continue、Kiro、Gemini CLI 等。正文建议 500 行以内,不作格式限制,不应因缺少 ## Output 等章节扣分。支持目录有 scripts/、references/、assets/,并采用渐进式披露(元数据约 100 tokens,正文 <5000 tokens,资源按需加载)。
- 规则(.claude/rules/<name>.md):必需 description;可选 paths(glob 数组)。正文以加粗祈使句开头并紧跟理由,具体可测,说明该做什么而非只列禁止,单个文件 500 行以内,有序集合用 NN-kebab-name.md。
- 钩子事件(大小写敏感):PreToolUse、PostToolUse、PostToolUseFailure、PermissionRequest、UserPromptSubmit、Stop、SubagentStop、SessionStart、SessionEnd、PreCompact、Notification、InstructionsLoaded;钩子类型 command/prompt/agent;matcher 为正则。
- hooks.json 格式:顶层 "hooks",二级为事件名,事件映射到 matcher 对象数组,每个 hook 对象含 type 及与之同名的字段。
- 命名约定:文件名与插件名用 kebab-case;技能引用用 plugin-name:skill-name;有序规则文件用 NN-kebab.md;环境变量用 SCREAMING_SNAKE;插件内路径使用 ${CLAUDE_PLUGIN_ROOT}。
- 记忆文件:位于 ~/.claude/projects/<project-slug>/memory/,单独文件需 YAML frontmatter(name、description、type 为 user/feedback/project/reference),且都须列入 MEMORY.md 索引,MEMORY.md 本身不需 frontmatter。
- 规则覆盖:可在 .claude/nlpm.local.md 用 suppress、max_penalty、threshold、min_examples、budget 等调整 nlpm:scoring 的规则。
- 工具目录:明确列出合法内置工具名与 mcp__<server>__<tool> 形式,工具名大小写敏感。
- 提示词工程建议:按角色、上下文、任务、约束、输出格式分层,复杂判断任务给 2 个以上示例,正向表述,显式规定输出格式。
适用场景:编写或维护 Claude Code 插件、lint NL 构件、统一命名与结构、配置钩子与记忆文件。
限制:不覆盖评分细则(见 nlpm:scoring)、反模式清单(见 nlpm:patterns)及 Claude Code 构件之外的通用软件工程规范;跨插件技能引用需先安装对应插件;部分字段(如 allowed-tools)为实验性。