OpenClaw Optimised

核心功能

本技能提供系统化的 CLAUDE.md 优化方法论，核心围绕「少即是多」原则——过长的配置文件会导致 Claude 忽略关键指令。

显著优点

1. 实战验证的方法论：基于「每行必须解决真实问题」的筛选标准，避免理论堆砌
2. 清晰的结构模板：提供从项目元信息、命令、代码风格到关键警告的完整框架
3. 多层级配置支持：涵盖用户级（~/.claude/）、项目根级、子目录级及规则片段的灵活部署方案
4. 可量化的优化目标：明确建议控制在 50 行以内，并提供完整的自检清单

潜在局限

1. 工具特定性：专为 Anthropic 的 Claude Code 设计，不直接适用于其他 AI 编程助手
2. 经验依赖：强调「仅添加已遭遇的真实问题」，新手可能难以判断何为「非显而易见」
3. 维护成本：建议定期审查（每几周）和根据误行为动态调整，需要持续投入

适合人群

• 使用 Claude Code 的开发者
• 团队技术负责人（需统一 AI 辅助编码规范）
• 现有 CLAUDE.md 效果不佳、Claude 频繁「忽略指令」的用户

常规风险

• 过度精简：删除过多导致关键上下文丢失
• 规则冲突：多文件配置时出现重复或矛盾指令
• 版本漂移：项目演进后 CLAUDE.md 未及时更新，反而引入误导

使用建议

从 /init 命令生成的基础配置开始，严格按「优化清单」逐项审查，优先用 bullet points 替代段落，对真正关键的限制使用 IMPORTANT/YOU MUST 标记（但需克制）。

核心功能

claude-optimised 是一个纯文档型 Skill，专注于指导开发者如何编写和优化 CLAUDE.md 文件，以最大化 Claude Code 的性能表现。其核心方法论是"Less Is More"——过长的配置文档会导致关键规则被忽略。

核心用法

该 Skill 适用于三种场景：
1. 创建新的 CLAUDE.md 时作为结构参考
2. 审查现有 CLAUDE.md 时进行优化建议
3. 用户询问最佳实践 时提供权威指导

关键原则包括：

• 每行配置必须回答"删除它会导致 Claude 犯错吗？"
• 仅包含非标准信息（Claude 无法从代码中推断的）
• 使用项目特定的命令、关键陷阱、领域术语
• 明确排除 Claude 已知的通用编程实践

推荐的 CLAUDE.md 结构

# Project Name
一句话描述

## Commands
- 测试/构建/开发命令

## Code Style
- 仅非显而易见的约定

## Architecture
- 仅复杂架构简述

## IMPORTANT
- 关键警告（极少使用）

理想目标：50 行以内，示例文档仅 15 行。

显著优点

1. 权威方法论：基于 Anthropic 官方推荐的 CLAUDE.md 实践，经过实际验证
2. 极致精简：提供清晰的"包含/排除"决策框架，避免配置膨胀
3. 具体可操作：包含格式规则、文件放置位置、优化检查清单
4. 维护指导：提供定期审查策略和反模式警示
5. 多层级支持：支持用户级、项目级、子目录级配置

潜在局限

1. 需人工判断："显而易见"vs"非显而易见"的界限需要开发者经验判断
2. 项目特异性：建议高度依赖具体技术栈（Next.js、Supabase、Zustand 等示例），需要使用者自行替换
3. 无自动化：纯指南性质，不提供自动格式化或验证工具
4. 团队推广成本：需要团队成员统一理解"Less Is More"原则

适合人群

• 使用 Claude Code 进行开发的工程师
• 需要为团队建立统一 AI 辅助开发规范的 Tech Lead
• 发现 Claude 频繁"忽略规则"而需要优化配置的用户
• 追求高效 token 利用率的成本敏感团队

风险与注意事项

| 风险类型 | 说明 |

|---------|------|

| 过度精简 | 删除真正必要的上下文，导致 Claude 理解偏差 |

| 版本漂移 | 项目演进后 CLAUDE.md 未及时更新 |

| 团队不一致 | 不同成员对"显而易见"定义不同 |

| 多文件冲突 | `~/.claude/`、`./CLAUDE.md`、`.claude/rules/` 内容重复或矛盾 |

建议配合 /init 命令使用，并每几周审查一次配置有效性。