# The Rig：为Claude Code打造的结构化智能编程系统

> 本文介绍The Rig——一套为Claude Code设计的结构化智能编程系统，通过双层架构、强制工作流和自动化安全钩子解决AI辅助开发中的状态丢失、规则漂移和隐性损害问题。

- 板块: [Openclaw Llm](https://www.zingnex.cn/forum/board/openclaw-llm)
- 发布时间: 2026-05-09T10:14:18.000Z
- 最近活动: 2026-05-09T10:18:33.524Z
- 热度: 141.9
- 关键词: Claude Code, AI辅助编程, 智能体系统, 结构化工作流, 记忆系统, 安全钩子, 版本控制, 开发工具
- 页面链接: https://www.zingnex.cn/forum/thread/the-rig-claude-code
- Canonical: https://www.zingnex.cn/forum/thread/the-rig-claude-code
- Markdown 来源: ingested_event

---

# The Rig：为Claude Code打造的结构化智能编程系统\n\nAI辅助编程工具正在改变软件开发的方式，但一个根本性问题困扰着开发者：每次与AI助手的新会话都像是重新开始。Claude Code虽然强大，却是无状态的——没有结构支撑，每个会话都要重复已做过的决策、重新询问已回答的问题。GitHub开源项目The Rig正是为解决这一痛点而生，它通过强制结构而非更好的提示词，为AI辅助开发带来一致性保障。\n\n## Claude Code的痛点：强大但无状态\n\nClaude Code作为Anthropic推出的AI编程助手，具备强大的代码理解和生成能力。然而，其无状态特性在实际生产环境中暴露出四个核心问题。\n\n首先是冷启动问题。每次新会话开始时，AI助手需要重新了解项目背景、技术栈、编码规范等已多次讨论过的信息。这不仅浪费时间，还导致每次会话的上下文重建成本居高不下。\n\n其次是规则漂移。没有强制机制的情况下，不同会话可能采用不同的编码约定，已确立的规则可能被悄然违反。这种不一致性在团队协作中尤为致命。\n\n第三是隐性损害风险。AI助手可能在不经意间写入受保护文件、提交包含敏感信息的代码、或在隐藏工作区中修改历史记录。这些操作往往不会立即显现问题，却埋下安全隐患。\n\n最后是知识流失。会话结束后，关于设计决策的讨论、遇到的问题及其解决方案往往没有系统记录，导致知识无法积累和传承。\n\n## The Rig的解决方案：强制结构而非更好提示\n\nThe Rig的核心理念是通过架构层面的强制结构来解决上述问题，而非依赖更精细的提示词工程。这种"固执己见"（opinionated）的设计理念意味着它定义了一套明确的工作方式，开发者需要遵循而非自定义。\n\n该系统采用双层加载架构，在每次会话启动时按顺序加载。全局层位于`~/.claude/`目录，安装一次后适用于机器上的所有项目，包含身份定义、硬性规则、工作风格和可复用技能脚本。项目层则位于每个代码库内部，定义项目特定的行为，包括流程定义、规则集、记忆系统和任务生命周期管理。\n\n这种分层设计确保了个人偏好可以在全局层统一配置，而项目特定需求则在项目层精确定义，两者协同工作形成完整的上下文环境。\n\n## 全局层：一次安装，处处适用\n\n全局层通过`install.sh --global-only`命令一次性安装，其核心文件包括`CLAUDE.md`和技能脚本库。`CLAUDE.md`定义了AI助手的身份、硬性规则和工作风格，确保每次会话都以一致的基调开始。\n\n技能脚本库位于`skills/`目录，包含五个开箱即用的技能脚本：调试（debug）、代码审查（review）、重构（refactor）、测试生成（tests）和代码解释（explain）。这些脚本是可复用的提示词模板，标准化了常见任务的执行方式。\n\n个人配置文件`~/.your-ai-contexts/PROFILE.md`允许开发者定义自己的专业背景、技术偏好和沟通风格。这一文件不会被提交到版本控制，确保个人隐私的同时让AI助手了解"你是谁"。\n\n## 项目层：版本控制的智能编程规范\n\n项目层是The Rig的核心创新，它将AI辅助编程的规范纳入版本控制，使团队可以协同定义和维护编码标准。项目层包含多个精心设计的子系统。\n\n流程系统（`.rig/processes/`）定义了四个标准化工作流：new-task（启动新任务）、ship（完成并交付）、debug（调试问题）和post-merge（合并后处理）。这些流程强制规定了每个阶段的步骤和检查点，确保工作方式的规范性。\n\n规则系统（`.rig/rules/`）包含四类规则：编码标准（coding standards）、Git约定（git conventions）、安全规则（security rules）和验证协议（verification protocol）。这些规则以结构化形式存在，AI助手可以在每次操作前检查合规性。\n\n记忆系统（`.rig/memory/`）是The Rig最具创新性的组件，包含PROGRESS日志（构建历史）、ERRORS日志（遇到的问题及解决方案）、DECISIONS日志（设计决策记录）和CONTEXT_SNAPSHOT（会话状态快照）。这些文件在会话结束时由`/wrap`命令自动更新，确保知识持续积累。\n\n任务生命周期系统（`.rig/tasks/`）通过backlog（待办）、active（进行中）和done（已完成）三个目录管理任务状态，提供了轻量级的项目跟踪能力。\n\n## 安全钩子：自动化防护机制\n\nThe Rig在`.husky/`目录集成了Git钩子，自动执行敏感信息扫描（使用gitleaks工具）和工具页脚清理。这意味着每次提交前都会自动检查是否包含密码、API密钥等敏感信息，从源头防止泄露。\n\n`.claude/`目录包含Claude Code的钩子配置和13个斜杠命令，实现了工具执行前后的强制检查。这些钩子确保AI助手在执行操作前验证权限，在操作后记录结果，形成完整的审计追踪。\n\n## 安装与使用：从全局到项目\n\nThe Rig的安装分为两个阶段。首先将仓库克隆到永久位置（如`~/tools/the-rig`），然后运行`./install.sh --global-only`安装全局层。开发者需要编辑`~/.your-ai-contexts/PROFILE.md`填写个人配置。\n\n对于新项目，先创建项目目录并初始化Git，然后运行`~/tools/the-rig/install.sh --project-only`安装项目层。安装完成后，在Claude Code中执行`/kickoff`命令，该命令会读取`PROJECT_BRIEF.md`，确认项目结构，并一次性生成CLAUDE.md、任务待办列表和GitHub issues。\n\n对于已有项目，The Rig支持智能合并，保留现有文件的同时添加Rig组件。升级时只需拉取最新Rig源码并重新运行项目安装程序，系统会自动检测并保留用户自定义内容。\n\n## 会话启动时的自动加载\n\n当在配置了The Rig的项目中启动Claude Code时，系统会自动按顺序加载以下文件：首先是`~/.claude/CLAUDE.md`定义AI身份，然后是`~/.your-ai-contexts/PROFILE.md`了解用户背景，接着是`./CLAUDE.md`获取项目信息。\n\n如果存在`./.rig/memory/CONTEXT_SNAPSHOT.md`，该文件包含上次会话的完整状态，AI助手加载后即可获得完整上下文，无需重新 briefing。如果不存在或已过时，则依次加载PROGRESS.md、ERRORS.md和active/目录下的任务文件。\n\n这种设计确保了会话间的连续性，真正实现了"从上次离开的地方继续"。\n\n## 生产验证：100+次Pull Request的实战打磨\n\nThe Rig并非纸上谈兵的概念项目，而是在真实生产环境中经过100多次Pull Request迭代打磨而成。这种实战背景意味着其设计决策都源于实际开发中的真实痛点，而非理论假设。\n\n从冷启动到规则执行，从安全防护到知识管理，The Rig提供了一个完整的解决方案框架。对于希望将Claude Code从"玩具"升级为"生产工具"的开发者而言，这是一个值得深入探索的开源项目。