用途
enhance-claude-memory 用于分析和优化项目记忆文件（CLAUDE.md、AGENTS.md），帮助提升 AI 助手对项目规则、架构和命令的理解与遵循程度。
主要能力
该技能会按顺序查找项目记忆文件：CLAUDE.md（Claude Code）、AGENTS.md（OpenCode、Codex）、.github/CLAUDE.md、.github/AGENTS.md。它读取文件内容并与 README.md 对比，运行全部模式检查，验证文件与命令引用是否存在于文件系统，计算 token 指标与重复度，并生成结构化 Markdown 报告。
检测模式共 20 项，分为以下类别：
- 结构验证（HIGH）：检查是否包含 Critical Rules、Architecture、Key Commands 等章节，规则是否按优先级排列并附带 WHY 说明。
- 指令有效性（HIGH）：检查是否用正向指令替代负向指令、是否使用强约束语言（must、always、required）、是否定义指令优先级。
- 内容位置（HIGH）：依据“lost in the middle”现象，检查关键规则是否放在文件开头或结尾，而非埋在中部。
- 引用验证（HIGH）：提取文件路径与命令引用，验证文件是否存在、npm 脚本是否在 package.json 中定义。
- 效率分析（MEDIUM）：估算 token 数（字符数/4 或词数*1.3），建议上限约 1500 token；检测与 README 的重复度（超过 40% 会标记）；检查是否使用列表而非长段落。
- 质量检查（MEDIUM）：检查规则是否附带 WHY 解释、嵌套是否超过 3 层、是否可选使用 XML 风格标签。
- 智能体/技能定义（MEDIUM）：检查自定义智能体是否包含 Description、Tools 等必填字段，技能是否有清晰的触发描述。
- 跨平台兼容性（MEDIUM/HIGH）：检查是否硬编码 .claude/ 路径，是否使用通用术语而非 Claude 专属表述。
使用方式
该技能以工作流方式运行：查找文件 → 读取内容与 README → 运行模式检查 → 验证引用 → 计算指标 → 生成报告。输出为结构化 Markdown，包含 Metrics 表、Summary 表以及按类别分组的问题与修复建议表。
适用场景
适用于使用 Claude Code、OpenCode、Codex 等 AI 助手的项目，尤其是需要维护 CLAUDE.md 或 AGENTS.md 项目记忆文件的团队。
限制
报告引用问题前必须先验证文件引用；标记效率问题时应考虑上下文；跨平台建议为参考性质而非强制要求；位置建议虽为 HIGH 确定性但可能存在合理例外。