SuperAPI AI 工具集

conventions-claude

编程与开发

查看项目

更新于 10-16 07:18

技能介绍

该技能是 Claude Code 插件产物的专用规范叠加层,当产物被判定为 Tier 2-Claude 时由 scorer 和 checker 加载,在通用规范 nlpm:conventions 之上补充 Claude Code 特有的 schema。

用途与适用场景:编写或评分 Claude Code 工件(插件、命令、技能、智能体、规则、钩子、MCP 配置、内存文件)时,按此约定校验路径、字段名、事件名与取值。

主要能力与规则要点:

  • 插件清单 .claude-plugin/plugin.json 只有 name(kebab-case)为必需;可选 version、description、displayName、author、homepage、repository、license、keywords、$schema、defaultEnabled、userConfig、channels、dependencies,以及 commands、agents、skills、hooks、mcpServers、lspServers、outputStyles、workflows 等路径字段。agent、category 不是该清单字段。
  • 命令与技能在 v2.1.x 中为同一架构,推荐 .claude/skills/<name>/SKILL.md,仍支持 .claude/commands/<name>.md。frontmatter 中 description 为唯一推荐字段,其余(name、argument-hint、allowed-tools、model 等)均可选;新增 when_to_use、context、agent、hooks、paths、shell、background。
  • 智能体位于 .claude/agents/<name>.md,正文即系统提示;文档字段含 name、description、tools、disallowedTools、model、skills、effort、color、permissionMode、isolation、memory、maxTurns、background、initialPrompt 等。
  • 规则位于 .claude/rules/<name>.md,需 description,可选 paths。
  • 钩子事件区分大小写,如 SessionStart、PreToolUse、PostToolUse、Stop 等;类型有 command、http、mcp_tool、prompt、agent。hooks.json 顶层为 hooks,按事件名映射 matcher 数组。
  • MCP 配置为仓库根目录 .mcp.json,使用 mcpServers 键。
  • CLAUDE.md 按 managed policy、user、project、local 四个作用域依次加载。

使用方式:由 scorer/checker 在被分类为 Tier 2-Claude 时加载,作为评分依据。限制:具体校验命令与完整允许清单需参考官方文档;本资料未提供安装、收费与运行环境等信息。