optimize-plugin

插件优化

执行插件验证与优化工作流。目标： $ARGUMENTS

背景知识

使用 Skill 工具加载 plugin-optimizer:plugin-best-practices 技能，了解组件模板、工具调用规则和类型分类。

阶段 1：发现与验证

目标：验证结构并检测问题。编排器不得应用修复。

操作：

1. 使用 realpath 解析路径并验证其是否存在
2. 验证 .claude-plugin/plugin.json 是否存在
3. 查找组件目录：commands/、agents/、skills/、hooks/
4. 根据 ${CLAUDE_PLUGIN_ROOT}/examples/ 模板验证组件
5. 评估架构：如果存在 commands/ 且其中有 .md 文件，使用 AskUserQuestion 工具询问是否迁移到 skills 结构
6. 运行验证：python3 ${CLAUDE_PLUGIN_ROOT}/scripts/validate-plugin.py "$TARGET"
   • 选项：--check=structure,manifest,frontmatter,tools,tokens
   • JSON 输出：--json
   • 详细模式：-v, --verbose
7. 按严重级别汇总问题（严重、警告、信息）

阶段 2：基于 Agent 的优化

目标：启动 Agent 应用所有修复。编排器不得直接修复。

条件：始终执行。

操作：

1. 使用以下提示内容启动 plugin-optimizer:plugin-optimizer Agent：
   • 目标插件路径（阶段 1 中获取的绝对路径）
   • 验证控制台输出（阶段 1 的问题列表）
   • 模板验证结果
   • 用户决定（如适用，包含迁移选择）
   • 指示：分析验证输出以识别问题
2. Agent 自主应用修复（应用模板修复前，必须使用 AskUserQuestion 工具，展示违规项、具体示例以及修改前后的对比）
3. 修复后，Agent 在 .claude-plugin/plugin.json 中递增版本号：
   • 补丁版本（x.y.Z+1）：错误修复
   • 次要版本（x.Y+1.0）：新增组件
   • 主要版本（X+1.0.0）：不兼容的变更
4. 等待 Agent 完成

路径引用规则：

• 同一目录：使用相对路径（./reference.md）
• 目录之外：使用 ${CLAUDE_PLUGIN_ROOT} 路径
• 组件模板：参见 ${CLAUDE_PLUGIN_ROOT}/examples/

冗余与效率：

• 冗余：允许策略性地重复关键内容（MUST/SHOULD 要求），优先简洁重述。
• 效率：Agent 会检测任务是否需要 Agent Teams（可并行处理的文件超过 5 个、涉及多个领域）。

阶段 3：验证与交付物

目标：验证修复、生成报告并更新文档。

操作：

1. 执行验证脚本：python3 ${CLAUDE_PLUGIN_ROOT}/scripts/validate-plugin.py "$TARGET"
2. 分析结果：与阶段 1 的发现进行比较，确认严重问题已解决
3. 如果仍有严重问题，继续执行 Agent
4. 使用下方模板生成最终验证报告
5. 更新 README.md 以反映当前状态（元数据、目录结构、使用说明；不要追加版本历史记录）

验证报告模板

## Plugin Validation Report

### Plugin: [name]
Location: [absolute-path]
Version: [old] -> [new]

### Summary
[2-3 sentences with key statistics]

### Phase 1: Issues Detected
#### Critical ([count])
- `file/path` - [Issue description]

#### Warnings ([count])
- `file/path` - [Issue description]

### Phase 2: Fixes Applied
#### Structure Fixes
- [Fix description]

#### Template Conformance
- **Agents**: [Count] validated, [count] fixed
- **Instruction-type Skills**: [Count] validated, [count] fixed
- **Knowledge-type Skills**: [Count] validated, [count] fixed

#### Redundancy Fixes
- [Consolidations applied]

### Phase 3: Verification Results
- Structure validation: [PASS/FAIL]
- Manifest validation: [PASS/FAIL]
- Component validation: [PASS/FAIL]
- Tool patterns validation: [PASS/FAIL]
- Token budgets validation: [PASS/FAIL]

### Token Budget Analysis
- Skills analyzed: [count]
- Tier 1 (Metadata ~100): [OK count], [WARNING count]
- Tier 2 (SKILL.md under 5k): [OK count], [WARNING count], [CRITICAL count]
- Tier 3 (References, effectively unlimited): [total tokens]

### Component Inventory
- Commands: [count] found, [count] valid
- Agents: [count] found, [count] valid
- Skills: [count] found, [count] valid

### Remaining Issues
[Issues that couldn't be auto-fixed with explanations]

### Overall Assessment
[PASS/FAIL] - [Detailed reasoning]