名称: 优化插件 描述: 当用户请求“验证插件”、“优化插件”、“检查插件质量”、“审查插件结构”或提及插件优化和验证任务时使用此技能。 参数提示: <插件路径> 用户可调用: true 允许工具: [“读取”, “全局查找”, “Bash(realpath )", "Bash(bash:)”, “任务”, “询问用户问题”, “任务创建”, “任务更新”]
插件优化
执行插件验证和优化工作流。目标: $ARGUMENTS
背景知识
工具调用模式
| 工具 | 风格 | 正确格式 |
|---|---|---|
| 读取, 写入, 全局查找, 搜索, 编辑 | 隐式 | “查找匹配文件…”, “读取每个文件…” |
| Bash | 隐式 | “运行 git status” |
| 任务 | 隐式 | “启动 插件名称:代理名称 代理” |
| 技能 | 显式 | “使用技能工具加载 插件名称:技能名称 技能” |
| 询问用户问题 | 显式 | “使用 询问用户问题 工具来[操作]” |
| 任务创建 | 显式 | “使用任务创建工具 跟踪” |
限定名称: 插件组件必须使用 插件名称:组件名称 格式。
渐进式披露: 技能封装领域专业知识—将通用代理转变为知识渊博的专家。渐进式披露保护上下文：元数据（约50个令牌）-> SKILL.md（约500个令牌）-> 引用（2000+个令牌，必须仅在需要时访问）。
组件模板验证
组件必须符合 ${CLAUDE_PLUGIN_ROOT}/examples/ 中的模板。
代理模板要求:
- 前言:
名称,描述,颜色,允许工具 - 系统提示: 第二人称（“您是…”），描述性语气（非指令性）
- 结构: 知识库 + 核心职责 + 方法 部分
指令型技能要求 (用户可调用: true):
- 前言:
名称,描述,用户可调用: true,允许工具 - 语气: 命令式（“加载…”, “创建…”, “执行…”）
- 强制阶段格式:
## 阶段 N: [阶段名称]带有 目标 和 操作 子部分 - 可选预阶段:
## 背景知识,## 初始化,## 上下文
知识型技能要求 (用户可调用: false):
- 前言:
名称,描述,用户可调用: false - 语气: 陈述式（“是”, “提供”, “包含”）
- 结构: 基于主题的部分（“## 核心概念”, “## 最佳实践”）
类型分类快速参考:
| 组件类型 | 用户可调用 | 语气 | 结构 | 声明于 |
|---|---|---|---|---|
| 代理 | 不适用 | 描述性（您是…） | 知识库 + 核心职责 + 方法 | 代理 |
| 指令型技能 | true |
命令式（加载…） | 阶段式（目标 + 操作） | 命令 |
| 知识型技能 | false |
陈述式（是/提供…） | 主题式（概念/模式） | 技能 |
清单交叉验证: 指令型必须位于 plugin.json 的 commands 数组中；知识型必须位于 plugin.json 的 skills 数组中。
阶段 1: 发现与验证
目标: 验证结构并检测问题。编排器不得应用修复。
操作:
- 使用
realpath解析路径并验证存在性 - 验证
.claude-plugin/plugin.json存在 - 查找组件目录:
commands/,agents/,skills/,hooks/ - 针对
${CLAUDE_PLUGIN_ROOT}/examples/模板验证组件 - 评估架构: 如果
commands/存在.md文件，使用询问用户问题工具询问迁移到技能结构 - 运行验证:
python3 ${CLAUDE_PLUGIN_ROOT}/scripts/validate-plugin.py "$TARGET"- 选项:
--check=structure,manifest,frontmatter,tools,tokens - JSON 输出:
--json - 详细:
-v, --verbose
- 选项:
- 按严重性（关键、警告、信息）编译问题
阶段 2: 基于代理的优化
目标: 启动代理以应用所有修复。编排器不直接进行修复。
条件: 始终执行。
操作:
- 使用以下提示内容启动
plugin-optimizer:plugin-optimizer代理:- 目标插件路径（来自阶段 1 的绝对路径）
- 验证控制台输出（来自阶段 1 的问题列表）
- 模板验证结果
- 用户决策（如果适用，迁移选择）
- 指令: 分析验证输出以识别问题
- 代理自主应用修复（在应用模板修复前必须使用
询问用户问题工具，呈现违规与具体示例和前后对比） - 代理在修复后递增
.claude-plugin/plugin.json中的版本:- 补丁 (x.y.Z+1): 错误修复
- 次要 (x.Y+1.0): 新组件
- 主要 (X+1.0.0): 重大变更
- 等待代理完成
路径参考规则:
- 相同目录: 使用相对路径（
./reference.md） - 外部目录: 使用
${CLAUDE_PLUGIN_ROOT}路径 - 组件模板: 参见
${CLAUDE_PLUGIN_ROOT}/examples/
冗余与效率:
- 冗余: 允许关键内容（必须/应该要求）的战略性重复。偏向简洁复述。
- 效率: 代理检测任务是否需要代理团队（可并行化 > 5 文件，多领域）。
阶段 3: 验证与交付物
目标: 验证修复、生成报告并更新文档。
操作:
- 执行验证脚本:
python3 ${CLAUDE_PLUGIN_ROOT}/scripts/validate-plugin.py "$TARGET" - 分析结果: 与阶段 1 发现比较，确认关键问题已解决
- 如果关键问题仍存在，恢复代理执行
- 使用以下模板生成最终验证报告
- 更新
README.md以反映当前状态（元数据、目录结构、使用说明；不附加版本历史日志）
验证报告模板
## 插件验证报告
### 插件: [名称]
位置: [绝对路径]
版本: [旧] -> [新]
### 摘要
[2-3 句关键统计信息]
### 阶段 1: 检测到的问题
#### 关键 ([数量])
- `文件/路径` - [问题描述]
#### 警告 ([数量])
- `文件/路径` - [问题描述]
### 阶段 2: 应用的修复
#### 结构修复
- [修复描述]
#### 模板符合性
- **代理**: [数量] 已验证，[数量] 已修复
- **指令型技能**: [数量] 已验证，[数量] 已修复
- **知识型技能**: [数量] 已验证，[数量] 已修复
#### 冗余修复
- [已应用的合并]
### 阶段 3: 验证结果
- 结构验证: [通过/失败]
- 清单验证: [通过/失败]
- 组件验证: [通过/失败]
- 工具模式验证: [通过/失败]
- 令牌预算验证: [通过/失败]
### 令牌预算分析
- 已分析技能: [数量]
- 层级 1 (元数据约50): [正常数量], [警告数量]
- 层级 2 (SKILL.md约500): [正常数量], [警告数量], [关键数量]
- 层级 3 (引用2000+典型): [总令牌数]
### 组件清单
- 命令: [数量] 找到，[数量] 有效
- 代理: [数量] 找到，[数量] 有效
- 技能: [数量] 找到，[数量] 有效
### 剩余问题
[无法自动修复的问题及解释]
### 总体评估
[通过/失败] - [详细推理]