FLowCraft框架

Claude Code 开发流程框架 - 标准化需求→设计→编码→测试→审查→交付

目录

• 项目简介
• 功能特性
• 系统要求
• 安装指南
• 快速开始
• 工作流程
• 常用命令
• 框架组件
• 配置说明
• 常见问题

项目简介

FLowCraft框架是一套基于 Claude Code 的智能开发流程管理系统。它通过自动化 hooks、标准化流程和 AI 辅助技能，帮助开发者实现从需求分析到交付的全流程规范化管理。

核心价值

• 流程标准化：强制执行 P0→P1→P2→P3→P4→P5 六阶段开发流程
• 质量保障：AI 代码审查、TDD 支持、自动化测试
• 智能辅助：GitNexus 代码分析、UI/UX 设计、并行 Agent
• 状态持久化：项目状态自动保存，支持会话恢复

功能特性

1. 六阶段开发流程

| 阶段 | 名称 | 功能 | |------|------|------| | P0 | 待命阶段 | 等待用户任务 | | P0.5 | 问题回溯 | 已完成功能发现问题时的回溯分析 | | P1 | 需求澄清+设计 | 需求调研、技术选型、PRD 编写、架构设计 | | P2 | 编码实现 | TDD/普通编码、AI 代码审查 | | P3 | 测试阶段 | 接口清单检查、测试验证 | | P4 | 综合审查 | 代码质量、测试覆盖、集成一致性、PRD 追溯 | | P5 | 交付阶段 | 生成报告、归档任务 |

2. 自动化 Hooks

• 阶段检查：自动检测阶段推进条件
• 权限控制：智能权限请求处理
• 会话记录：自动记录用户输入和 AI 回复
• 状态同步：实时更新项目状态

3. Superpowers 技能集

| 技能 | 用途 | |------|------| | phase | 阶段管理（查看/推进/回退） | | status | 查看项目完整状态 | | review | P4 综合审查 | | code-review | AI 代码质量审查 | | P5report | 生成任务总结报告 | | checkpoint | 保存工作状态快照 | | archive | 清理和归档历史记忆 | | ui-ux-pro-max | UI/UX 设计（67 风格+96 配色+57 字体） | | gitnexus-* | 代码分析（查询/影响/重构/调试） | | playwright | Playwright 测试 | | task | 多任务管理（新任务/切换/列表/归档，目录即任务） |

4. 智能辅助

• GitNexus 集成：代码知识图谱、影响分析、安全重命名
• UI/UX 设计：支持 React/Vue/Svelte/SwiftUI 等 13 个技术栈
• 并行 Agent：多 Agent 协作，提高开发效率
• 记忆管理：自动归档、释放上下文空间

5. 多任务（Multi-task）

• 目录即任务：在哪个工作根启动就自动绑定该目录的任务状态（.claude/tasks/{目录名}.md），零配置
• 会话隔离：同目录多会话按 session_id 自动隔离；并行任务用多目录 / git worktree 承载
• 说人话即可："新任务：xxx / 切换任务 xxx / 任务列表 / 归档任务 xxx"——命令由 AI 执行，用户零学习成本
• 解析优先级：FLOWCRAFT_TASK_ID > session 绑定 > 目录默认 > 单任务回退；旧项目行为零变化

系统要求

必需

• Claude Code：最新版本
• Python：3.x（用于 hooks 脚本）
• Git：用于版本控制

可选

• Node.js：用于 GitNexus（npx 命令）
• JDK 17+：用于 Java MCP 服务
• Elasticsearch 8.x：用于日志存储

安装指南

方式零：npm 包安装（跨平台，无 bash 依赖）

# 打包（仓库内执行，产出 leocm-flowcraft-2.1.0.tgz）
npm pack ./flowcraft

# 全局安装后提供 flowcraft 命令
npm i -g leocm-flowcraft-2.1.0.tgz

# 常用命令（与 install.sh 参数面等价）
flowcraft install --quick          # 项目安装
flowcraft install --global         # 用户级全局安装
flowcraft init                     # 当前目录最小化初始化
flowcraft install --preset backend # 应用预设

# Sessionlog 分发（默认关闭，明确启用才分发）
flowcraft install --sessionlog                            # 分发默认 http://127.0.0.1:8181/api/logs
flowcraft install --sessionlog http://host:8181/api/logs  # 分发指定地址

方式一：自动安装（推荐）

前置条件

1. 将 flowcraft 目录放到项目根目录下
2. 确保已安装 Python 3.x（支持 python/python3/py/py3 命令）

claude (推荐)

   安装 FLowCraft install.sh
   
   chmod +x ~/.flowcraft/hooks/*.py

   # 安装完重启claude

Linux / macOS

# 进入项目根目录
cd your-project

# 添加执行权限
chmod +x flowcraft/install.sh

# 运行安装脚本
./flowcraft/install.sh

chmod +x ~/.flowcraft/hooks/*.py

Windows

使用 Git Bash 或 Claude Code 执行：

# 进入项目根目录
cd your-project

# 运行安装脚本
./flowcraft/install.sh

安装脚本功能

1. 复制框架文件：将 setup/.claude 复制到项目根目录（项目级状态文件/报告/审查/归档永不覆盖，已存在则自动备份并保留）；hooks/skills/commands 仅创建空目录（由用户级 --global 提供，不重复复制）
2. 添加 PATH 设置：为 hook 文件添加环境变量
3. 修复行尾符：CRLF → LF（跨平台兼容）
4. 替换 Python 命令：将脚本中的 python 命令替换为检测到的命令
5. 复制规范文件：将 setup/AGENTS.md 与 setup/CLAUDE.md 覆盖到项目根目录（AGENTS.md 旧文件自动备份为 AGENTS.md.bak）
6. 保护项目数据：.codex/ 与 .claude/ 下的 project-state.md、prd.md、session_log.json、reports/、reviews/、archive/、model-catalog.json、config.toml、settings.local.json 已存在时一律保留（不覆盖、不删除、不备份），仅更新框架文件；仅对会被模板覆盖的框架文件（settings.json、AGENTS.md、CLAUDE.md、project-state.md）在覆盖前自动备份

方式二：通过 Claude Code 重新安装

适用于已安装过 FLowCraft 框架的项目，用于升级或修复。

前置条件

1. 将最新版 flowcraft 目录复制到项目根目录下（覆盖旧版）

操作步骤

在 Claude Code 中执行：

重新安装FLowCraft

说明

• 项目级状态永不覆盖：.codex/ 与 .claude/ 下的 project-state.md、prd.md、session_log.json、reports/、reviews/、archive/、model-catalog.json、config.toml、settings.local.json 已存在时自动保留，不覆盖、不删除、不产生备份，无需手动恢复
• 框架文件更新：settings.json、AGENTS.md、CLAUDE.md 等框架文件更新到最新版；hooks/skills/commands 仅建空目录（由用户级 --global 提供，不重复复制）；被覆盖的旧文件自动备份（AGENTS.md.bak、*.bak-<时间戳>）
• 全新安装：项目无 .codex/.claude 时按模板初始化（含空的 project-state.md）

方式三：全局安装（--global，所有项目生效）

./flowcraft/install.sh --global

• hooks：安装到 ~/.flowcraft/hooks/ 并合并注册到 ~/.claude/settings.json（用户已有 env/权限等配置保留）
• skills/commands 全局兜底：全量分发到 ~/.claude/skills/、~/.claude/commands/（Claude）与 ~/.codex/skills/（Codex）；项目级仅建空目录不再重复复制，命令在任意项目可用
• Codex hooks：脚本安装到 ~/.flowcraft/codex-hooks/，注册到 ~/.codex/hooks.json（命令路径改写为绝对路径，已有配置合并保留）
• Codex 实验特性：自动在 ~/.codex/config.toml 启用 [features] skills = true / codex_hooks = true（合并，已有配置无损）
• 安全合并：所有合并前自动备份 .bak-<时间戳>；重跑 --global 即全量升级，幂等可重复
• 生效方式：安装后重启 Claude Code / Codex（skills 启动时加载一次）

快速开始

1. 启动 Claude Code

cd your-project
claude

2. 查看当前状态

/status

3. 提交任务

直接告诉 Claude 你的需求：

实现一个用户登录功能

Claude 会自动：

1. 进入 P1 阶段进行需求澄清
2. 编写 PRD 文档
3. 进入 P2 编码实现
4. 执行 P3 测试
5. 进行 P4 综合审查
6. 完成 P5 交付

4. 阶段管理

/phase          # 查看当前阶段
/phase next     # 推进到下一阶段
/phase prev     # 回退到上一阶段
/P0             # 直接跳转到 P0（待命阶段）
/P0.5           # 直接跳转到 P0.5（问题回溯）
/P1             # 直接跳转到 P1（需求澄清+设计）
/P2             # 直接跳转到 P2（编码实现）
/P3             # 直接跳转到 P3（测试阶段）
/P4             # 直接跳转到 P4（综合审查）
/P5             # 直接跳转到 P5（交付阶段）

工作流程

┌─────────────────────────────────────────────────────────────┐
│                      FLowCraft 工作流程                          │
├─────────────────────────────────────────────────────────────┤
│                                                             │
│  P0 等待任务                                                │
│    ↓                                                        │
│  P1 需求澄清 + 设计 + 原型                                  │
│    ├─ 需求调研                                              │
│    ├─ 技术选型                                              │
│    ├─ PRD 编写                                              │
│    └─ 架构设计                                              │
│    ↓                                                        │
│  P2 编码实现                                                │
│    ├─ TDD / 普通编码                                        │
│    ├─ AI 代码审查                                           │
│    └─ 问题修复                                              │
│    ↓                                                        │
│  P3 测试阶段                                                │
│    ├─ 接口清单检查（可选）                                  │
│    └─ 测试验证                                              │
│    ↓                                                        │
│  P4 综合审查                                                │
│    ├─ 代码质量                                              │
│    ├─ 测试覆盖                                              │
│    ├─ 集成一致性                                            │
│    └─ PRD 追溯                                              │
│    ↓                                                        │
│  P5 交付                                                    │
│    ├─ 生成报告                                              │
│    ├─ 归档任务                                              │
│    └─ 转到 P0                                               │
│                                                             │
│  P0.5 问题回溯（按需触发）                                  │
│    ├─ 触发条件：P5后发现问题 / 测试严重bug / 重新提问       │
│    ├─ 问题记录 → 根因分析                                   │
│    └─ 用户选择：A优化方案 / B重走需求 / C直接修复           │
│                                                             │
└─────────────────────────────────────────────────────────────┘

阶段详情

P0 - 待命阶段

目的：等待用户任务，准备进入开发流程

执行内容：

1. 获取当前状态
2. 检查是否有未完成任务
3. 等待用户输入新任务

触发条件：

• 用户提交新任务（如"实现用户登录功能"）
• 任务完成后自动回到 P0

状态文件：

• current_phase: P0
• task_description: ""（空）
• started_at: ""（空）

P0.5 - 问题回溯（按需触发）

目的：已完成功能发现问题时的回溯分析，避免随意修改代码

触发条件：

• P5 交付后发现功能问题
• 测试阶段发现严重 bug
• 用户重新提问已完成功能的问题

执行流程：

1. 触发确认：收到问题报告 → 向用户展示 P0.5 选择项 A/B/C
2. 进入 P0.5：立即更新 current_phase: P0.5，记录 phase_history
3. 问题记录：记录发现的具体问题现象，不是猜测或解决方案
4. 根因分析：分析问题来源
   • 需求不明：PRD 没有覆盖的场景
   • 方案缺陷：原有方案有漏洞
   • 实现 bug：代码写错了
5. 决策执行（用户选择）：

| 选项 | 描述 | 执行后 phase | |------|------|-------------| | A | 在原有方案上优化分析 | P0.5 → P1（新方案）→ P2 | | B | 完整重走需求阶段 | P0.5 → P1（新需求）→ P2 | | C | 直接修复代码 | P0.5 → P0（完成后记录到 phase_history） |

A vs B 的区别：

• A：保留原方案基础上分析优化，适合"方案有漏洞但基本方向对"
• B：推倒重来，重新梳理需求，适合"需求本身就有问题或需要完全重新设计"
• C：不做任何分析，直接改代码（不推荐，除非错误非常明确且不影响方案）

强制约束：不能在用户选择 A/B/C 之前改任何代码

P1 - 需求澄清+设计

目的：充分理解需求，编写 PRD，设计架构

执行流程：

1. 需求澄清+智能补充

   • 充分对话，从功能性角度补充（核心/扩展/相关功能）
   • 使用 AskUserQuestion 系统性提问
   • 判断充分性后记录 requirements_clarification
   • GitNexus 用途：查询现有代码帮助理解需求、查找类似功能作为参考
   • 【决策点1：需求确认】

2. 技术调研+技术栈确认

   • 先询问技术偏好
   • Context7 MCP + WebSearch 调研
   • UI 强制用 ui-ux-pro-max（67 风格+96 配色+57 字体）
   • 【决策点2：技术栈确认】

3. 编写 PRD 并确认

   • 编写精简 PRD（≤150 行）
   • 写入 .claude/prd.md
   • 记录 prd_file
   • 删除 requirements_clarification
   • 锁定 PRD
   • 【决策点3：PRD 确认】

4. 架构设计+方案对比

   • 提供 2-3 个方案（含模块/数据/API/部署/优缺点/场景）
   • 用户选择后写入 architecture_decisions
   • 【决策点4：架构确认】

5. 原型设计+设计确认（UI 项目）

   • 应用设计系统
   • Chrome 展示响应式（375/768/1440px）
   • 写入 ui_design
   • 禁止 Bootstrap 3/4/jQuery UI
   • 【决策点5：设计确认】

5 个决策点确认 → P2 自动驱动

产出物：

• .claude/prd.md（PRD 文档）
• requirements_clarification（需求澄清记录）
• architecture_decisions（架构决策）
• ui_design（UI 设计，如有）

P2 - 编码实现

目的：按 PRD 开发代码，确保代码质量

执行流程：

1. GitNexus 索引检查

   • 检查当前仓库是否已索引：npx gitnexus status
   • 未索引：跳过 GitNexus 相关功能
   • 已索引：使用 GitNexus 辅助编码

2. 开发方式选择（P2 开始时询问）：

| 方式 | 说明 | 适用场景 | |------|------|---------| | TDD（测试驱动开发） | 先写测试，再写实现代码 | 核心业务逻辑、需要高质量保证的代码 | | 普通编码 | 先写代码，再补充测试 | 快速开发、功能相对简单 | | 只编译（不做测试） | 10 分钟快速原型，只编译不测试 | 验证想法、快速原型、时间紧迫 |

3. 编码实现

   • 严格按 PRD 开发，每行代码对应 PRD 需求
   • 禁止增减 PRD 外内容
   • GitNexus 用途：
     • 修改现有代码：gitnexus_impact 分析影响范围（强制）
     • 探索不熟悉代码：gitnexus_query 按概念查找、gitnexus_context 查看完整上下文
     • 提交前：gitnexus_detect_changes 确认变更范围（强制）

4. AI 代码审查（P2 完成后自动触发）

   • 读取 project-state.md 中的 modified_files 列表
   • 对每个文件执行 AI 代码质量审查（基于阿里巴巴 Java 开发手册）
   • 问题处理：
     • 无问题：直接进入 P3
     • 有问题：列出完整问题清单 → 等待用户确认 → 修复
   • 修复方式：
     • A. AI 生成：AI 生成修复代码，用户确认后应用
     • B. 用户指示：用户告知修复方式，AI 执行
     • C. 忽略问题：记录豁免，进入 P3
   • 重试上限：同一问题修复最多 5 次

产出物：

• 源代码文件
• 测试文件（TDD/普通编码方式）
• .claude/code-review-report.md（代码审查报告）

P3 - 测试阶段

目的：验证代码质量，确保功能正确

执行流程：

1. 询问是否执行接口清单检查

   • 提示用户：是否需要检查 HTTP/HTTPS 接口清单？
   • 默认：否

2. 扫描代码中的 HTTP/HTTPS 调用（如选择执行）

   • 仅扫描 modified_files 中列出的本次修改文件
   • 搜索文件中的 HTTP/HTTPS 调用
   • 支持常见 HTTP 客户端库（Apache HttpClient、OkHttp、RestTemplate、HttpClient、fetch）

3. 选择输出格式

   • A. CURL 命令格式（可直接执行的命令）
   • B. 表格格式（简洁列表）
   • C. JSON 格式（结构化数据）

4. 生成清单文件

   • 生成 .claude/external-urls.md 文件
   • 包含所有找到的 HTTP/HTTPS 调用
   • 按文件分组

5. 测试验证

   • 运行测试用例
   • 验证功能正确性
   • 检查边界条件

6. 用户确认

   • 展示清单内容和测试结果
   • 询问是否确认所有接口都已正确？
   • 等待用户确认

产出物：

• .claude/external-urls.md（接口清单，可选）
• 测试报告

P4 - 综合审查

目的：全面审查代码质量，确保符合标准

审查内容：

| 检查项 | 说明 | 检查标准 | |--------|------|---------| | 代码质量检查 | 检查代码规范 | 基于阿里巴巴 Java 开发手册 | | 测试覆盖检查 | 验证测试用例覆盖 | 覆盖所有 PRD 需求 | | 集成一致性检查 | 确保新代码兼容 | 与现有系统无冲突 | | PRD 追溯检查 | 验证代码对应需求 | 每行代码必须对应 PRD 需求 |

审查流程：

1. 自动执行审查

   • 最多重试 3 次
   • 每次审查后自动修复问题

2. 列出问题清单

   • 文件路径
   • 行号
   • 问题描述
   • 严重程度（HIGH/MEDIUM/LOW）

3. 用户选择修复方式

| 选项 | 描述 | 执行动作 | |------|------|---------| | A | AI 生成修复 | AI 生成修复代码，用户确认后应用，回 P2 | | B | 用户指示 | 用户告知修复方式，AI 执行，回 P2 | | C | 忽略问题 | 记录豁免，进入 P5 |

4. 审查通过
   • 审查通过后自动进入 P5
   • 生成审查报告

强制约束：

• 未列出清单或未获客户确认前，禁止直接修改代码
• 同一问题修复最多 3 次，超过后必须停止并提示用户介入

产出物：

• .claude/reviews/P4-review-{date}.md（审查报告）

P5 - 交付阶段

目的：生成报告，归档任务，完成交付

执行流程：

1. GitNexus 更新（可选）

   • 已索引：执行 npx gitnexus analyze 更新知识图谱
   • 无索引：跳过

2. 生成报告

   • 执行 /P5report 生成任务总结报告
   • 保存到 .claude/reports/ 目录
   • 报告内容：
     • 任务概述
     • 技术实现
     • 测试结果
     • 代码质量
     • 交付物清单

3. 交付确认

   • 向用户展示交付物清单和报告摘要
   • 确认完成

4. 归档任务

   • 归档到 completed_tasks（精简格式）
   • 清空 phase_history
   • 清空当前任务字段
   • current_phase 转到 P0

产出物：

• .claude/reports/{date}-{task}.md（任务总结报告）
• 更新 project-state.md（归档任务）

归档格式：

completed_tasks:
  - description: "任务描述（精简）"
    result: "完成情况（一句话）"

常用命令

阶段管理

| 命令 | 说明 | |------|------| | /phase | 查看当前阶段 | | /phase next | 推进到下一阶段 | | /phase prev | 回退到上一阶段 | | /P0 | 切换到 P0（待命阶段） | | /P0.5 | 切换到 P0.5（问题回溯） | | /P1 | 切换到 P1（需求澄清+设计） | | /P2 | 切换到 P2（编码实现） | | /P3 | 切换到 P3（测试阶段） | | /P4 | 切换到 P4（综合审查） | | /P5 | 切换到 P5（交付阶段） |

状态查看

| 命令 | 说明 | |------|------| | /status | 查看项目完整状态 | | /Pstatus | 查看当前阶段状态 |

审查与报告

| 命令 | 说明 | |------|------| | /review | 执行 P4 综合审查 | | /code-review | 执行 AI 代码质量审查 | | /P5report | 生成任务总结报告 |

工具与辅助

| 命令 | 说明 | |------|------| | /checkpoint | 保存工作状态快照 | | /archive | 清理和归档历史记忆 | | /playwright | Playwright 测试 | | /ui-ux-pro-max | UI/UX 设计 |

GitNexus 命令

| 命令 | 说明 | |------|------| | /gitnexus-cli | GitNexus CLI 命令 | | /gitnexus-exploring | 探索代码架构 | | /gitnexus-debugging | 调试问题 | | /gitnexus-impact-analysis | 影响分析 | | /gitnexus-refactoring | 重构代码 |

框架组件

目录结构

your-project/
├── CLAUDE.md                    # FLowCraft 流程定义（核心）
└── .claude/
    ├── project-state.md         # 项目状态（活文档）
    ├── prd.md                   # PRD 文档
    ├── session_log.json         # 会话日志
    ├── code-review-report.md    # 代码审查报告
    ├── external-urls.md         # 外部接口清单
    ├── settings.json            # Claude Code 配置
    ├── hooks/                   # 空目录（用户级全局提供）
    │   ├── check-phase-advancement.py
    │   ├── log_session.py
    │   ├── permission-request.py
    │   ├── session-end.py
    │   ├── session-start.py
    │   ├── stop-check.py
    │   ├── user-prompt-submit.py
    │   └── ...
    ├── skills/                  # 空目录（用户级全局提供）
    │   ├── phase/
    │   ├── status/
    │   ├── review/
    │   ├── code-review/
    │   ├── P5report/
    │   ├── checkpoint/
    │   ├── archive/
    │   ├── ui-ux-pro-max/
    │   ├── gitnexus/
    │   ├── playwright/
    │   └── ...
    ├── FLowCraft/                    # FLowCraft 规则文档
    │   └── rules/
    │       ├── 01-lifecycle-phases.md
    │       ├── 02-coding-standards.md
    │       ├── 03-testing-standards.md
    │       ├── 04-git-workflow.md
    │       ├── 05-anti-amnesia.md
    │       ├── 06-review-tools.md
    │       ├── 07-parallel-agents.md
    │       ├── 08-chrome-integration.md
    │       ├── 09-memory-management.md
    │       └── 10-ui-ux-standards.md
    ├── commands/                # 阶段命令
    │   ├── P0.md
    │   ├── P0.5.md
    │   ├── P1.md
    │   ├── P2.md
    │   ├── P3.md
    │   ├── P4.md
    │   ├── P5.md
    │   └── Pstatus.md
    ├── reports/                 # 任务报告
    └── reviews/                 # 审查报告

核心文件说明

CLAUDE.md

FLowCraft 流程定义文件，包含：

• 启动指令
• 核心规则
• 阶段流程
• 执行规范
• GitNexus 配置

project-state.md

项目状态活文档，包含：

• 项目路线图
• 已完成任务列表
• 当前任务状态
• 阶段历史记录
• 架构决策记录

settings.json

Claude Code 配置文件，包含：

• Hooks 配置
• 权限设置
• 环境变量

配置说明

Hooks 配置

Hooks 在 settings.json 中配置，支持以下事件：

| 事件 | 说明 | |------|------| | SessionStart | 会话开始时触发 | | SessionEnd | 会话结束时触发 | | UserPromptSubmit | 用户提交输入时触发 | | PreToolUse | 工具执行前触发（阶段检查、权限检查） | | PostToolUse | 工具执行后触发（状态提醒） | | PostToolUseFailure | 工具执行失败后触发 | | Stop | 停止时触发 | | PreCompact | 压缩前触发 | | SubagentStart | 子 Agent 启动时触发 | | SubagentStop | 子 Agent 停止时触发 | | TaskCompleted | 任务完成时触发 | | PermissionRequest | 权限请求时触发 |

权限配置

在 settings.json 的 permissions 部分配置允许的命令：

{
  "permissions": {
    "allow": [
      "Bash(npm run test)",
      "Bash(npm run build)",
      "Bash(git *)"
    ]
  }
}

环境变量

| 变量 | 说明 | 默认值 | |------|------|--------| | SESSION_LOG | 会话日志路径 | .claude/session_log.json | | GIT_USER | Git 用户名 | git config user.name |

常见问题

Q1: 安装后 hooks 不工作？

A: 检查以下几点：

1. 确认 ~/.flowcraft/hooks/*.py 有执行权限（Linux/macOS）
2. 确认 Python 命令正确（运行 python --version）
3. 检查 settings.json 中 hooks 配置是否正确

Q2: 如何升级框架？

A: 重新运行安装脚本即可：

./flowcraft/install.sh

注意：project-state.md 不会被覆盖，其他文件会更新。

Q3: 如何跳过某个阶段？

A: 使用阶段命令强制切换：

/P3    # 强制切换到 P3

但不建议跳过阶段，会影响代码质量。

Q4: GitNexus 如何使用？

A:

1. 确保已安装 Node.js
2. 首次使用需要索引仓库：npx gitnexus analyze
3. 使用 /gitnexus-* 命令进行代码分析

Q5: P4 审查未通过怎么办？

A:

1. Claude 会自动列出问题清单
2. 等待用户确认修复方式（A/B/C）
3. 最多重试 3 次
4. 超过 3 次需要用户介入

技术支持

• 问题反馈：提交 GitHub Issue
• 文档更新：查看 .claude/FLowCraft/rules/ 目录
• 技能说明：查看 .claude/skills/ 目录

许可证

MIT License

更新日志

v2.1.0 (2026-10-12)

• Sessionlog 分发改为明确启用：--sessionlog [url]（默认不分发；裸旗标分发 http://127.0.0.1:8181/api/logs）；默认地址 192.168.2.99→127.0.0.1
• 守卫修复：.claude/ 拦截锚定 project_root，用户级 ~/.claude/**（如计划草稿）放行；白名单补 plans/
• 钩子输出 UTF-8 双保险：消除 Windows GBK 乱码（进程内 reconfigure + dispatch 子进程 UTF-8）

v2.0.0 (2026-09-24)

• --global 补全用户级安装：skills/commands 分发（Claude + Codex 全局兜底）、Codex 全局 hooks 注册（~/.codex/hooks.json 绝对路径）、config.toml [features] 特性开关合并
• 项目级安装不再复制 hooks/skills/commands（仅建空目录，统一由用户级提供）
• Codex hook 守卫对非受管项目放行（无状态文件不拦截），与 Claude 侧行为一致

v1.0.1 (2026-05-13)

• 清理残留数据文件（旧 PRD、报告、审查记录）
• 删除测试/调试文件（test-block.sh、test-phase.sh 等）
• 修复 file-suggestion.sh 规则路径错误
• 统一 settings.json 中 hook 路径格式
• 创建 archive 目录
• 优化安装脚本步骤编号
• 移除 install.bat（统一使用 .sh 脚本）

v1.0.0 (2026-05-12)

• 初始版本发布
• 六阶段开发流程
• 自动化 hooks 系统
• Superpowers 技能集
• GitNexus 集成
• UI/UX 设计支持