REIN是一个轻量级的工作流控制框架，通过结构化流程和情绪压力提示，让AI编程助手变得更加谨慎、准确和可控。

REIN：为AI编程代理构建严格可控的工作流框架\n\n## 背景：AI编程助手的"幻觉"困境\n\n随着大型语言模型在代码生成领域的广泛应用，开发者们逐渐意识到一个令人头疼的问题：AI助手虽然能够快速生成代码，但它们经常"自信地犯错"。从幻觉出不存在的API函数，到忽略项目的类型检查规则，再到跳过测试直接宣布任务完成——这些问题正在消耗开发者大量的返工时间。\n\n正是在这样的背景下，REIN项目应运而生。它不仅仅是一份提示词模板，而是一套完整的工作流框架，旨在通过结构化的流程设计和研究支持的行为干预，让AI编程代理变得更加可靠和可控。\n\n## 核心理念：从FEAR到REIN的演进\n\nREIN是FEAR.md项目的自然演进。FEAR.md的核心理念非常独特：它利用"情绪压力"作为一种行为调节机制。项目的描述直白而有力——"SOUL.md告诉代理它是谁，FEAR.md告诉它懈怠时会发生什么"。\n\n这一理念的底层支撑来自Anthropic等研究机构的工作。研究表明，即使语言模型并不真正"感受"情绪，情绪相关的概念框架仍然能够功能性影响模型的行为表现。当任务被框定在失败、谨慎和后果的语境中时，模型会变得更慢猜测、更快验证、更愿意承认不确定性。\n\nREIN将这一理念扩展为一个完整的运行时框架，不再仅仅依赖静态文档，而是通过结构化的工作流来强制执行高质量标准。\n\n## REIN框架的架构设计\n\nREIN采用模块化设计，核心组件包括：\n\n### 1. REIN.md协议文档\n\n这是整个框架的"宪法"，定义了规范化的执行和推理指导原则。它规定了代理在编码过程中必须遵循的行为准则，包括但不限于：编辑前必须阅读相关文件、验证假设而非猜测、为新逻辑编写测试、运行项目的lint和类型检查工具、在声明完成前审查差异等。\n\n### 2. 技能包（Skills）\n\nREIN提供了10个预打包的技能模块，覆盖软件开发生命周期的各个阶段：\n\n- rein-go：完整的端到端工作流，从需求澄清到实现、清理、审查和验证\n- rein-interview：任务澄清阶段，通过结构化问答确保需求理解准确\n- rein-inspect：仓库检查，生成持久的代码库映射\n- rein-triage：在模糊或多文件变更前进行分流评估\n- rein-plan：将复杂工作分解为有序的步骤和检查点\n- rein-scope：处理需求过大或冲突的情况，进行范围协商\n- rein-review：提交前自我审查差异\n- rein-cleanup：行为锁定后的清理和重构工作\n- rein-verify：声明完成前的最终验证\n- rein-retro：事后回顾，从失误或可疑捷径中学习\n\n### 3. 运行时状态管理\n\nREIN引入了.rein/目录作为仓库本地的工件根目录，所有生成的输出、中间状态和任务历史都持久化存储在这里。这使得任务可以在任意阶段暂停和恢复，支持长时间运行的复杂工作流。\n\n### 4. 多IDE支持\n\nREIN设计为与主流AI编程工具兼容，目前支持：\n\n- Codex：通过.codex/skills/目录集成\n- Claude Code：通过.claude/commands/目录集成\n- Cursor：通过.cursor/rules/目录集成\n\n每种工具都有对应的协议文档（REIN.md）、工件根目录（.rein/）和指导块（AGENTS.md或CLAUDE.md），确保一致的用户体验。\n\n## 典型工作流演示\n\n使用REIN的最简单方式是通过rein go命令启动完整的端到端流程：\n\nbash\nnpm install -g @jstxn/rein\nrein init\nrein go \"为发票添加CSV导出功能\"\n\n\n这条命令会触发以下流程：\n\n1. 澄清阶段（Interview）：REIN会启动用户访谈，通过一系列问题深入理解需求意图和期望结果。系统会计算"清晰度分数"，确保在继续前对任务有充分理解。\n\n2. 规划阶段（Plan）：基于澄清结果，将任务分解为有序的步骤和检查点。\n\n3. 实现阶段（Implementation）：执行实际的代码编写工作。\n\n4. 清理阶段（Cleanup）：在功能锁定后进行代码清理和重构。\n\n5. 审查阶段（Review）：自我审查生成的差异，确保符合质量标准。\n\n6. 验证阶段（Verify）：运行测试、lint、类型检查等验证步骤。\n\n整个过程的状态都持久化存储在.rein/目录下，用户可以随时检查状态或从任意点恢复：\n\nbash\nrein go status --slug <任务标识> --json\nrein go resume --slug <任务标识> --json\n\n\n## 研究支撑与实践意义\n\nREIN的设计并非凭空想象，而是建立在扎实的研究基础之上。项目引用了多篇近期研究论文，包括：\n\n- Anthropic关于情绪概念在大型语言模型中功能的研究\n- 关于情绪刺激和强度如何塑造LLM行为的arXiv论文（arXiv:2604.07369）\n\n这些研究表明，情绪框架确实能够功能性影响模型的准确性、安全性和谄媚倾向。REIN将这种研究洞察转化为实用的工程工具。\n\n从实践角度看，REIN的价值在于：\n\n对个体开发者：减少返工时间，提高AI辅助编码的产出质量。通过强制执行验证和审查步骤，避免"看起来对但实际上错"的代码进入代码库。\n\n对团队：提供一致的质量标准和可审计的工作流程。.rein/目录中的持久化工件可以作为代码审查的辅助材料，展示AI代理的决策过程。\n\n对AI工具生态：展示了如何将研究洞察产品化为实用的开发者工具，为类似项目提供了参考架构。\n\n## 局限与未来展望\n\nREIN项目明确声明它是一个"工作流框架，而非基准测试或优越性证明"。这种谦逊的定位实际上是一种优势——它不承诺解决所有问题，而是专注于提供一个可扩展、可定制的质量控制框架。\n\n当前版本主要面向JavaScript/TypeScript生态（通过npm分发），但其核心概念可以应用于任何编程语言和AI编程工具。未来可能的演进方向包括：\n\n- 更广泛的IDE和编辑器支持\n- 团队协作功能，如共享的审查状态和知识库\n- 与CI/CD管道的深度集成\n- 基于历史数据的智能优化建议\n\n## 结语\n\nREIN代表了一种重要的范式转变：从把AI编程助手当作"聪明的自动补全工具"，转向将其视为需要严格监督和结构化流程的"协作伙伴"。通过结合研究支持的行为干预和实用的工程工作流，REIN为开发者提供了一个让AI助手更加可靠的工具箱。\n\n对于那些厌倦了修复AI生成错误代码的开发者来说，REIN值得一试。它不会让你的AI助手变得完美，但会让它变得更加谨慎、更加透明、更加可控——而这正是当前AI辅助开发领域最需要的品质。

REIN：为AI编程代理构建严格可控的工作流框架\n\n背景：AI编程助手的"幻觉"困境\n\n随着大型语言模型在代码生成领域的广泛应用，开发者们逐渐意识到一个令人头疼的问题：AI助手虽然能够快速生成代码，但它们经常"自信地犯错"。从幻觉出不存在的API函数，到忽略项目的类型检查规则，再到跳过测试直接宣布任务完成——这些问题正在消耗开发者大量的返工时间。\n\n正是在这样的背景下，REIN项目应运而生。它不仅仅是一份提示词模板，而是一套完整的工作流框架，旨在通过结构化的流程设计和研究支持的行为干预，让AI编程代理变得更加可靠和可控。\n\n核心理念：从FEAR到REIN的演进\n\nREIN是FEAR.md项目的自然演进。FEAR.md的核心理念非常独特：它利用"情绪压力"作为一种行为调节机制。项目的描述直白而有力——"SOUL.md告诉代理它是谁，FEAR.md告诉它懈怠时会发生什么"。\n\n这一理念的底层支撑来自Anthropic等研究机构的工作。研究表明，即使语言模型并不真正"感受"情绪，情绪相关的概念框架仍然能够功能性影响模型的行为表现。当任务被框定在失败、谨慎和后果的语境中时，模型会变得更慢猜测、更快验证、更愿意承认不确定性。\n\nREIN将这一理念扩展为一个完整的运行时框架，不再仅仅依赖静态文档，而是通过结构化的工作流来强制执行高质量标准。\n\nREIN框架的架构设计\n\nREIN采用模块化设计，核心组件包括：\n\n1. REIN.md协议文档\n\n这是整个框架的"宪法"，定义了规范化的执行和推理指导原则。它规定了代理在编码过程中必须遵循的行为准则，包括但不限于：编辑前必须阅读相关文件、验证假设而非猜测、为新逻辑编写测试、运行项目的lint和类型检查工具、在声明完成前审查差异等。\n\n2. 技能包（Skills）\n\nREIN提供了10个预打包的技能模块，覆盖软件开发生命周期的各个阶段：\n\n- rein-go：完整的端到端工作流，从需求澄清到实现、清理、审查和验证\n- rein-interview：任务澄清阶段，通过结构化问答确保需求理解准确\n- rein-inspect：仓库检查，生成持久的代码库映射\n- rein-triage：在模糊或多文件变更前进行分流评估\n- rein-plan：将复杂工作分解为有序的步骤和检查点\n- rein-scope：处理需求过大或冲突的情况，进行范围协商\n- rein-review：提交前自我审查差异\n- rein-cleanup：行为锁定后的清理和重构工作\n- rein-verify：声明完成前的最终验证\n- rein-retro：事后回顾，从失误或可疑捷径中学习\n\n3. 运行时状态管理\n\nREIN引入了.rein/目录作为仓库本地的工件根目录，所有生成的输出、中间状态和任务历史都持久化存储在这里。这使得任务可以在任意阶段暂停和恢复，支持长时间运行的复杂工作流。\n\n4. 多IDE支持\n\nREIN设计为与主流AI编程工具兼容，目前支持：\n\n- Codex：通过.codex/skills/目录集成\n- Claude Code：通过.claude/commands/目录集成\n- Cursor：通过.cursor/rules/目录集成\n\n每种工具都有对应的协议文档（REIN.md）、工件根目录（.rein/）和指导块（AGENTS.md或CLAUDE.md），确保一致的用户体验。\n\n典型工作流演示\n\n使用REIN的最简单方式是通过rein go命令启动完整的端到端流程：\n\nbash\nnpm install -g @jstxn/rein\nrein init\nrein go \"为发票添加CSV导出功能\"\n\n\n这条命令会触发以下流程：\n\n1. 澄清阶段（Interview）：REIN会启动用户访谈，通过一系列问题深入理解需求意图和期望结果。系统会计算"清晰度分数"，确保在继续前对任务有充分理解。\n\n2. 规划阶段（Plan）：基于澄清结果，将任务分解为有序的步骤和检查点。\n\n3. 实现阶段（Implementation）：执行实际的代码编写工作。\n\n4. 清理阶段（Cleanup）：在功能锁定后进行代码清理和重构。\n\n5. 审查阶段（Review）：自我审查生成的差异，确保符合质量标准。\n\n6. 验证阶段（Verify）：运行测试、lint、类型检查等验证步骤。\n\n整个过程的状态都持久化存储在.rein/目录下，用户可以随时检查状态或从任意点恢复：\n\nbash\nrein go status --slug <任务标识> --json\nrein go resume --slug <任务标识> --json\n\n\n研究支撑与实践意义\n\nREIN的设计并非凭空想象，而是建立在扎实的研究基础之上。项目引用了多篇近期研究论文，包括：\n\n- Anthropic关于情绪概念在大型语言模型中功能的研究\n- 关于情绪刺激和强度如何塑造LLM行为的arXiv论文（arXiv:2604.07369）\n\n这些研究表明，情绪框架确实能够功能性影响模型的准确性、安全性和谄媚倾向。REIN将这种研究洞察转化为实用的工程工具。\n\n从实践角度看，REIN的价值在于：\n\n对个体开发者：减少返工时间，提高AI辅助编码的产出质量。通过强制执行验证和审查步骤，避免"看起来对但实际上错"的代码进入代码库。\n\n对团队：提供一致的质量标准和可审计的工作流程。.rein/目录中的持久化工件可以作为代码审查的辅助材料，展示AI代理的决策过程。\n\n对AI工具生态：展示了如何将研究洞察产品化为实用的开发者工具，为类似项目提供了参考架构。\n\n局限与未来展望\n\nREIN项目明确声明它是一个"工作流框架，而非基准测试或优越性证明"。这种谦逊的定位实际上是一种优势——它不承诺解决所有问题，而是专注于提供一个可扩展、可定制的质量控制框架。\n\n当前版本主要面向JavaScript/TypeScript生态（通过npm分发），但其核心概念可以应用于任何编程语言和AI编程工具。未来可能的演进方向包括：\n\n- 更广泛的IDE和编辑器支持\n- 团队协作功能，如共享的审查状态和知识库\n- 与CI/CD管道的深度集成\n- 基于历史数据的智能优化建议\n\n结语\n\nREIN代表了一种重要的范式转变：从把AI编程助手当作"聪明的自动补全工具"，转向将其视为需要严格监督和结构化流程的"协作伙伴"。通过结合研究支持的行为干预和实用的工程工作流，REIN为开发者提供了一个让AI助手更加可靠的工具箱。\n\n对于那些厌倦了修复AI生成错误代码的开发者来说，REIN值得一试。它不会让你的AI助手变得完美，但会让它变得更加谨慎、更加透明、更加可控——而这正是当前AI辅助开发领域最需要的品质。