obatried/oba-claude

# oba-claude 一个维护完善的 CLAUDE.md 系统 — 规则、治理策略、关联映射、示例以及一个漂移检测脚本。专为希望拥有一个不会腐烂的 CLAUDE.md 的 Claude Code 用户设计，可直接使用。 ## 存在意义 大多数人的 CLAUDE.md 最初是一个简短的规则手册，但随着时间的推移，它会逐渐变成一个“墓地” — 规则重叠、过时的事件、失效的引用、无人记得编写过的章节。这个文件在 Claude 的行为中悄然失去了分量。当这种情况发生时，没有任何信号；它只是在退化。 这是我在自己的 CLAUDE.md 上运行的系统，以防止这种情况发生。四个文件 + 一个脚本： | 文件 | 角色 | |---|---| | `CLAUDE.md` | 规则。10 个章节，每章最多 8 条要点，每个章节都有一个“验证标准：”行。 | | `CLAUDE_MAINTENANCE.md` | 编辑 CLAUDE.md 的策略。章节结构、带日期的条目、冲突协调、内部测试。 | | `CLAUDE_MAP.md` | 将 CLAUDE.md 的每个章节映射到执行它的关联钩子/技能/脚本。 | | `EXAMPLES.md` | 每条规则对应的 ❌/✅ 示例对。使 CLAUDE.md 保持为一个可快速浏览的参考卡片。 | | `scripts/audit-claude-sync.sh` | 每周检查 (1) 关联项漂移 和 (2) 超过 90 天未审查的章节。 | 重点不是你应该使用 *我的* 规则 — 而是根据你的工作调整它们。重点在于结构：一个规则文件、一个维护它的策略、一种将规则与执行关联起来的方法、一个放置示例的地方，以及一个在文件变得陈旧之前就能发现漂移的脚本。 ## 你得到什么 vs. 你需要带来什么 本仓库提供了规则和治理机制。它**没有**提供 `CLAUDE_MAP.md` 中引用的关联钩子（`stop-slash-text-guard.sh`、`gave-up-early-guard.sh` 等）。这些被列为示例 — 请自己连接或让该章节留空。审计脚本可以处理这两种情况。 ## 安装 请参阅 [安装指南](./INSTALL.md)。简短版本： ``` git clone https://github.com/obatried/oba-claude.git ~/oba-claude # 备份所有现有内容，然后将4个 .md 文件和脚本复制到 ~/.claude/ 中。 ``` 安装后，编辑 `~/.claude/CLAUDE_MAP.md` 以指向你的实际关联项路径。提供的配对是示例性的 — 请替换它们。 ## 相关项目 - **[dirty-claude](https://github.com/obatried/dirty-claude)** — 审计并清理你的 Claude Code 安装。如果你的 CLAUDE.md 很短或缺失，并且希望自动安装一个健全的基础配置，可以从这里开始。 - **[claude-code-starter-kit](https://github.com/obatried/claude-code-starter-kit)** — 一个更小的、包含 7 条原则的 CLAUDE.md，适用于新用户。当简单的工具包不够用时，oba-claude 是你升级到的版本。 ## 许可证 MIT。参见 [许可证](./LICENSE)。

标签：AI 助手, Claude Code, Markdown, Shell 脚本, SOC Prime, 对称加密, 工具集成, 应用安全, 开发工具, 开发流程, 最佳实践, 治理策略, 漂移检测, 自动化审计, 规则管理, 软件维护, 配置文件维护, 防御加固, 项目治理