SuperAPI AI 工具集

claude-plugin-guide

编程与开发

查看项目

更新于 10-16 07:07

技能介绍

用途

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 指令。
  • 关于收费、价格、平台等具体信息,资料中暂未提供。