agent-sh/enhance

# enhance 用于插件、代理、提示词、文档、钩子和技能的主增强编排器。 ## 概述 enhance 插件针对不同内容类型提供专门的解析器，基于 prompt engineering 最佳实践识别问题并提出改进建议。 ## 架构 ``` /enhance │ ├─→ /enhance:agent → Agent-specific analysis (frontmatter, tool restrictions) ├─→ /enhance:prompt → General prompt patterns (clarity, structure, examples) ├─→ /enhance:docs → Documentation analysis (RAG optimization, readability) ├─→ /enhance:plugin → Plugin structure (MCP tools, security patterns) ├─→ /enhance:claudemd → Project memory optimization (CLAUDE.md/AGENTS.md) ├─→ /enhance:hooks → Hook definitions (frontmatter, safety) └─→ /enhance:skills → SKILL.md structure and triggers ``` **分析深度**：基于确定性的发现（HIGH、MEDIUM、LOW） **自动修复**：使用 `--fix` 标志可用于 HIGH 确定性问题 **模型选择**：Opus 用于质量关键型分析器，Sonnet 用于基于模式的检查 ## 命令 ### `/enhance` 在当前目录上运行所有适用的增强器。 ``` /enhance # Auto-detect and run all relevant analyzers /enhance --fix # Apply HIGH certainty auto-fixes /enhance --verbose # Include LOW certainty issues ``` ### `/enhance:agent [target]` 分析代理提示词文件的配置和结构问题。 ``` /enhance:agent # All agents in directory /enhance:agent my-agent.md # Specific agent /enhance:agent --fix # Apply auto-fixes ``` **检测**：缺失 frontmatter、无限制的 Bash、缺失角色部分、工具配置问题 ### `/enhance:prompt [target]` 分析提示词是否符合 prompt engineering 最佳实践。 ``` /enhance:prompt # All prompts in directory /enhance:prompt system-prompt.md # Specific prompt /enhance:prompt --fix # Apply auto-fixes ``` **检测**：模糊指令、缺失示例、过度强调、结构问题、无效代码块（JSON/JS 语法、语言不匹配、标题层级） ### `/enhance:docs [target]` 分析文档的可读性和 RAG 优化。 ``` /enhance:docs # All docs in directory /enhance:docs --ai # AI-only mode (aggressive optimization) /enhance:docs agent-docs/ --ai # Specific directory ``` **检测**：冗长短语、分块不佳、断链、token 低效 ### `/enhance:plugin [target]` 分析插件结构和 MCP 工具定义。 ``` /enhance:plugin # All plugins /enhance:plugin my-plugin # Specific plugin /enhance:plugin --fix # Apply auto-fixes ``` **检测**：缺失 schema 字段、安全模式、版本不匹配 ### `/enhance:claudemd` 分析项目记忆文件（CLAUDE.md、AGENTS.md）。 ``` /enhance:claudemd # Find and analyze project memory /enhance:claudemd --fix # Apply auto-fixes ``` **检测**：缺失部分、引用损坏、README 重复、跨平台问题 ### `/enhance:hooks` 分析钩子定义的 frontmatter 质量。 ``` /enhance:hooks # All hook definitions /enhance:hooks pre-commit.md # Specific hook ``` **检测**：缺失 frontmatter、缺失名称/描述 ### `/enhance:skills` 分析 SKILL.md 文件的必需元数据和触发清晰度。 ``` /enhance:skills # All SKILL.md files /enhance:skills enhance-docs # Specific skill ``` **检测**：缺失 frontmatter、缺失名称/描述、缺失触发短语 ## 代理 | Agent | Purpose | Model | |-------|---------|-------| | `agent-enhancer` | Frontmatter、工具限制、代理结构 | opus | | `prompt-enhancer` | 清晰度、示例、结构、反模式 | opus | | `docs-enhancer` | RAG 优化、可读性、token 效率 | opus | | `plugin-enhancer` | MCP schema、安全模式、结构 | sonnet | | `claudemd-enhancer` | 项目记忆验证、跨平台 | opus | | `hooks-enhancer` | 钩子 frontmatter、结构、安全性 | sonnet | | `skills-enhancer` | SKILL.md 结构、触发短语 | sonnet | ## 确定性级别 | Level | Meaning | Auto-Fixable | |-------|---------|--------------| | HIGH | 确定的问题 | 部分 | | MEDIUM | 可能的改进 | 否 | | LOW | 建议性意见 | 否 | LOW 确定性问题仅在启用 `--verbose` 标志时显示。 ## 常用标志 | Flag | Description | |------|-------------| | `--fix` | 应用 HIGH 确定性的自动修复 | | `--verbose` | 包含 LOW 确定性问题 | | `--dry-run` | 显示将要修复的内容而不实际应用 | | `--ai` | 仅 AI 模式（docs 分析器） | | `--both` | 双受众模式（docs 分析器，默认） | ## 输出格式 每个分析器生成一份 markdown 报告： ``` ## 分析：{name} **File**: {path} **Analyzed**: {timestamp} ### 摘要 - HIGH: {count} issues - MEDIUM: {count} issues - LOW: {count} issues (verbose only) ### {Category} 问题 ({n}) | Issue | Fix | Certainty | |-------|-----|-----------| | Description | Suggested fix | HIGH | ``` ## 集成 可通过以下方式调用： - 直接命令：`/enhance:*` - 工作流中的阶段 9 审查循环 - 发货前的 `delivery-validator` - 单独的分析工作流 ## 需求 - Claude Code - Node.js（用于 lib 函数） ## 许可证 MIT

标签：AI Agent开发, CLAUDE.md, DNS 反向解析, JSON验证, MCP工具, MITM代理, SOC Prime, 前端元数据, 安全合规, 安全模式检测, 开发工具, 插件分析器, 文档优化, 模块化设计, 模型上下文协议, 网络代理, 自动化修复, 自定义脚本, 错误基检测, 防御加固, 静态代码分析