manifest-reference

# 插件清单参考 `plugin.json` 配置的完整参考。 ## 文件位置 **必需路径**：`.claude-plugin/plugin.json` 清单文件必须位于插件根目录的 `.claude-plugin/` 文件夹中。如果文件位置不正确，Claude Code 将无法识别插件。 ## 完整字段参考 ### 核心字段 #### name (必需) **类型**：字符串 **格式**：kebab-case (短横线命名法) **示例**：`"test-automation-suite"` 插件的唯一标识符。用于： - 在 Claude Code 中识别插件 - 与其他插件进行冲突检测 - 命令命名空间（可选） **要求**： - 在所有已安装的插件中必须唯一 - 仅使用小写字母、数字和连字符 - 不得包含空格或特殊字符 - 以字母开头 - 以字母或数字结尾 **验证**： javascript /^[a-z][a-z0-9]*(-[a-z0-9]+)*$/ **示例**： - ✅ 正确：`api-tester`, `code-review`, `git-workflow-automation` - ❌ 错误：`API Tester`, `code_review`, `-git-workflow`, `test-` #### version **类型**：字符串 **格式**：语义化版本控制 (MAJOR.MINOR.PATCH) **示例**：`"2.1.0"` **默认值**：若未指定，则为 `"0.1.0"` 语义化版本控制指南： - **MAJOR**：不兼容的 API 变更，破坏性更新 - **MINOR**：新功能，向后兼容 - **PATCH**：错误修复，向后兼容 **预发布版本**： - `"1.0.0-alpha.1"` - Alpha 版本 - `"1.0.0-beta.2"` - Beta 版本 - `"1.0.0-rc.1"` - 发布候选版本 **示例**： - `"0.1.0"` - 初始开发阶段 - `"1.0.0"` - 第一个稳定版本 - `"1.2.3"` - 1.2 版本的补丁更新 - `"2.0.0"` - 包含破坏性变更的主版本 #### description **类型**：字符串 **长度**：建议 50-200 字符 **示例**：`"Automates code review workflows with style checks and automated feedback"` 插件用途和功能的简要说明。 **最佳实践**： - 专注于插件的功能，而非实现方式 - 使用主动语态 - 提及关键特性或优势 - 保持在 200 字符以内，以便在市场中显示 **示例**： - ✅ "通过代码分析和覆盖率报告生成全面的测试套件" - ✅ "与 Jira 集成以实现自动问题跟踪和冲刺管理" - ❌ "一个帮助你做测试工作的插件" - ❌ "这是一个非常长的描述，它不断地谈论每一个单一的功能……" ### 元数据字段 #### author **类型**：对象 **字段**：name (必需), email (可选), url (可选) { "author":