项目初始化
创建项目状态和空白的宪章，以便工作流可以干净启动；如有需要，其他阶段也可以自动初始化它。
面向基于分支功能开发的 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
- 仓库许可证
- 所提供的来源文本中未说明
FluencyLoop 替代品
Prompt Genie
Prompt Genie 是面向 AI 工作流的提示管理与优化工具，并提供 Claude Code 记忆功能，可复用会话上下文中的重复读取，帮助个人和团队复用提示、对比模型输出并减少不必要的 token 消耗。
Orca
Orca 是面向编码代理的 Agent 开发环境，支持在隔离的 git worktree 中并行运行多个 CLI agent，并提供桌面端与移动端协作流程。
Firebase Studio
Firebase Studio 是一款基于浏览器的全栈应用开发工作区，支持 Gemini 辅助编写代码、应用预览、云模拟器、导入仓库、原型开发、协作与从浏览器部署。
EZsite AI
EZsite AI 是一款 AI 网站构建器，可将 URL 转为完整的 React 或 Vue.js 应用。支持托管、自定义域名、代码导出及面向团队的后端功能，帮助快速交付可部署结果。
AI Magicx
AI Magicx 是一体化 AI 工作区，集聊天、图片、视频、语音、音乐、邮件和开发任务于一处，帮助创作者、团队和开发者集中使用多种模型，无需在多个工具和订阅间切换。
Paper
Paper 是一款设计工具，连接画布、代码和 AI agent，让团队在一个工作流中完成创建、协作与交付。支持桌面应用、基于 MCP 的 agent 访问，以及真实内容和设计 token 工作流。