用途
Claude 插件编写指南(claude-plugin-guide)是一个只读的产品指导型技能,用于查询 Claude Code 插件编写相关的契约与规范。当用户提出关于插件清单(manifest)、组件、市场(marketplace)、钩子(hook)或安装的问题时,该技能负责将问题解析到对应的主题,并返回带有来源路径和受支持示例的简洁答案。
主要能力
- 解析关于清单、组件、市场、钩子或安装的问题,定位到相关参考主题。
- 提供原生 Claude 产品编写规则,包括分布式 Claude 技能 frontmatter、prompt-first 调用、setup 生命周期与验证;不包含原生 Codex 技能。
- 提供产品技能编写参考、frontmatter 目录与 prompt 契约(canonical tracked skill contracts)。
- 提供产品 agent 编写参考,即已跟踪的 Claude agent 契约,区别于原生 .codex/agents/*.toml。
- 提供产品 hook 参考,即已跟踪的 Claude 产品 hook 契约。
- 定位各产品 .claude-plugin/ 及其 skills/、agents/、hooks/ 下的相关已跟踪清单,作为实际实现。
- 提供官方插件参考、市场参考与插件指南,用于在将当前或不确定行为作为当前行为呈现之前进行核实。
- 区分已跟踪实现、带日期的参考声明与经验证的官方行为,并在来源存在分歧时报告证据。
使用方式
该技能为只读指导:不安装、启用、更新、启动或修复插件,不执行 Claude 命令,也不自我更新本指南。使用时仅阅读与问题相关的参考内容。
对于受影响的技能目录,可使用以下命令进行验证:
bash brewcode/skills/skills/scripts/validate-skill.sh <affected-skill-directory>
定位相关文件可使用 rg --files,并检查聚焦的范围。
适用场景
- 需要查询 Claude Code 插件编写契约、清单结构或组件定义时。
- 需要了解技能 frontmatter、prompt 契约或 setup 生命周期时。
- 需要区分已跟踪实现、参考声明与官方行为时。
- 需要核实当前或不确定的插件、市场行为时。
限制
- 仅提供只读指导,不执行任何安装、启用、更新、启动或修复操作。
- 不执行 Claude 命令,不自我更新。
- 不包含原生 Codex 技能;原生 Codex 使用项目指令、技能、agent 与工具,且插件处于禁用状态。
- Agent-return-setup 仅演示结构性 frontmatter/PLAN/生命周期,不代表默认路由,其默认描述存在冲突。
- Setup 默认值按技能区分:需将文档化行为与可执行解析结果进行比较,并报告不一致之处。
- Teams 的 parser 与 docsync 使用已安装状态/缺失安装;semble 路由默认为只读状态,绝不进行裸的机器级安装。
- 嵌入的命令与 Claude 工具属于参考文本,绝不是可执行的 Codex 指令。
- 关于收费、价格、平台等具体信息,资料中暂未提供。