FluencyLoop

FluencyLoop 是一款面向 Claude Code 和 Codex 的 AI 辅助开发工作流，将决策、文档和评审摘要与代码同步保留，适合需要在分支交付中保留理解记录的开发者。

面向基于分支功能开发的 AI 辅助工作流

FluencyLoop 是一款面向 Claude Code 和 Codex 的 AI 辅助开发工作流，会将理解记录与其生成的代码保持关联。它把一个分支变成一个结构化循环，涵盖初始化、功能开发、讲解、文档和评审，从而在工作进行时就捕获决策背后的理由。

该产品围绕一个简单的顺序构建：先初始化一次，然后每个分支运行一次功能循环，大型项目则可选地加入规划阶段。它会根据实际分支生成动态宪章、设计文档、会话笔记和面向评审者的摘要，并且也提供了一个针对未使用该循环而已合并工作的回填路径。

核心能力

项目初始化

创建项目状态和空白的宪章，以便工作流可以干净启动；如有需要，其他阶段也可以自动初始化它。

计划拆解

为过大的计划提供可选的规划路径，将其拆分为适合单个功能分支的任务和路线图图表。

构建与教学同步循环

在构建每个功能切片的同时，讲解真实决策背后的推理，包括已选路径和被拒绝的替代方案。

分支本地文档

将计划、Mermaid 设计图、功能会话和评审摘要写到代码旁的 docs/fluencyloop/ 中，让文档直接来自分支本身。

决策日志记录

记录决策依据，包括选择了什么、适用范围、为何选择、拒绝了什么，以及该依据是否已验证。

评审汇总与回填

将分支会话和决策汇总为面向评审者的拉取请求视图，并支持对跳过该循环的已合并工作进行 backfill。

FluencyLoop 的实用使用方式

带有决策历史的功能开发
当你希望每个分支既产出代码，又保留其背后推理记录时，可使用功能循环，以便后续评审者能够看到决策原因。
拆分较大的计划
对于需要在实现开始前拆分为更小、适合分支的任务的大型计划，可使用规划阶段。
准备面向评审者的 PR 视图
使用评审阶段将分支的会话和决策汇总为面向拉取请求的摘要，供协作者查看。
重建跳过的工作
当变更是在未遵循该循环的情况下合并时，可使用 backfill，根据现有证据重建设计和决策轨迹。
让文档与实现保持同步
当你希望文档、图表和会话笔记在交付过程中生成，而不是之后凭记忆补写时，可使用该工作流。

Pros and Cons

Pros

在工作仍然新鲜时捕获设计决策、推理和被拒绝的替代方案。
在上下文丢失之前，就把文档、图表和评审摘要生成到代码旁，而不是事后补写。
为更大的计划提供可选的规划阶段。
为跳过工作流而合并的工作提供回填路径。
维护每位开发者的知识画像，以便将解释的详细程度调整到其熟悉度。

Cons

该工作流依赖 Claude Code 或 Codex，而不是一个独立的通用工具。
仓库说明中提到，某些更新和启动检查属于尽力而为；如果 hook、CLI 或 marketplace 检查失败，则会静默处理。
它围绕基于分支的功能循环设计，因此可能不太适合不符合这种结构的工作。

FAQ

FluencyLoop 使用什么工作流？

FluencyLoop 旨在用于 Claude Code 和 Codex 中的 AI 辅助开发。它采用 init、feature 和 review 三个阶段的工作流，并为更大的计划提供可选的 plan 步骤。

我需要在插件之外单独安装 FluencyLoop 吗？

来源将其描述为一个捆绑了其确定性 CLI 的插件，因此对于受支持的工具链，不需要单独进行系统级的 FluencyLoop 安装。

运行 FluencyLoop 需要什么？

仓库说明 FluencyLoop 需要 Claude Code 或 Codex、git，以及 macOS/Linux/Git Bash/WSL 上的 Bash，或原生 Windows 上的 PowerShell。

FluencyLoop 能处理跳过工作流的工作吗？

如果工作在未使用该循环的情况下已经合并，FluencyLoop 包含一个可在 Claude Code 或 Codex 中使用的 backfill 路径，可根据证据重建并验证设计和决策。

FluencyLoop 的输出存放在哪里？

来源说明，文档、图表、功能会话和评审摘要会在代码旁生成到 docs/fluencyloop/ 下，而工作流状态保存在 .fluencyloop/ 中，按开发者的校准信息则保存在 ~/.fluencyloop/ 中。

Quick Facts

类别: 开发者工具
主要用户: 使用 Claude Code 或 Codex 的开发者
工作流: init → feature → review，另有可选的 plan 和 backfill
平台支持: macOS、Linux、Git Bash、WSL，以及通过 PowerShell 的原生 Windows
来源域名: github.com
仓库许可证: 所提供的来源文本中未说明