# dev-flow-plugin

**Repository Path**: brother-one/dev-flow-plugin

## Basic Information

- **Project Name**: dev-flow-plugin
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-03-04
- **Last Updated**: 2026-03-12

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# dev-flow

**把 AI 写代码变成 AI 做工程。**

![License](https://img.shields.io/badge/license-MIT-blue.svg)
![Version](https://img.shields.io/badge/version-v2.0.0-green.svg)
![Claude Code](https://img.shields.io/badge/Claude%20Code-Plugin-orange.svg)
![Language](https://img.shields.io/badge/language-中文%20%7C%20English-red.svg)
[![Hook CI](https://github.com/brother-one/dev-flow-plugin/actions/workflows/hook-ci.yml/badge.svg)](https://github.com/brother-one/dev-flow-plugin/actions/workflows/hook-ci.yml)

Claude Code Plugin — 三阶段工作流驱动（SHAPE/BUILD/SHIP），5 Agent 并行评审，6 道质量门禁，6 个核心 Hook，10 个 Skill，全程文档可追溯。


<!-- TODO: 添加协作演示 GIF -->

> 让 Claude Code 从「你说我写」变成「需求→设计→编码→测试→CR→合并」的完整研发闭环，
> 每一步都有独立评审、门禁拦截、文档留痕。

---

## 目录

- [为什么需要 dev-flow？](#为什么需要-dev-flow)
- [适用场景](#适用场景)
- [快速开始](#快速开始)
- [三阶段工作流](#三阶段工作流)
- [6 道质量门禁](#6-道质量门禁)
- [Agent 角色体系](#agent-角色体系)
- [Skill 一览](#skill-一览)
- [Hook 防御体系](#hook-防御体系)
- [三层架构](#三层架构)
- [i18n 国际化](#i18n-国际化)
- [技术栈模板](#技术栈模板)
- [度量与仪表板](#度量与仪表板)
- [Plugin Marketplace](#plugin-marketplace)
- [分支策略适配](#分支策略适配)
- [协作通知（可选扩展）](#协作通知可选扩展)
- [外部 LLM 辅助评审](#外部-llm-辅助评审)
- [CI 多平台适配](#ci-多平台适配)
- [Hook 测试套件](#hook-测试套件)
- [多语言支持](#多语言支持)
- [前置条件](#前置条件)
- [目录结构](#目录结构)
- [教程](#教程)
- [常见问题](#常见问题)
- [团队与企业部署](#团队与企业部署)
- [许可证](#许可证)

---

## 为什么需要 dev-flow？

| 没有 dev-flow | 有 dev-flow |
|:---:|:---:|
| 用户说需求，AI 直接写代码 | 需求先拆解、评审、确认，再动手 |
| 写完就算完 | 6 个门禁逐一签收，不过不放行 |
| 一个 AI 自说自话 | 独立 reviewer 评审 + writer 执笔，角色隔离 |
| 设计在脑子里 | 8 章节设计文档 + DDL + 回滚方案，白纸黑字 |
| 测试随缘 | TDD 先写测试、全量编译、接口链路验证 |
| 改了什么不清楚 | 每个需求一个 FEATURE.md，门禁/返工/签收全记录 |
| 换个会话全忘了 | Hook 自动保存/恢复状态，跨会话无缝继续 |

---

## 适用场景

**谁适合用：**
- 独立开发者 / 小团队，想让 AI 辅助完整研发流程，而不只是写代码片段
- 需要对 AI 产出进行质量管控、留下审计痕迹的场景
- 希望 Claude Code 能记住上下文、不跑偏、不乱改代码的用户

**什么项目适合：**
- 各种规模的需求：从 XS 级 Bug 修复（10 分钟轻量流程）到 L 级大型功能（完整三阶段）
- 需要跨会话持续推进的长周期开发任务
- 多语言项目（Java / Go / Python / TypeScript / Kotlin / C++ / Rust）

**不太适合：**
- 纯探索/实验性代码，不需要任何质量留痕的场景

---

## 快速开始

### 第一步：安装

```bash
# 从 Gitee 克隆
git clone https://gitee.com/brother-one/dev-flow-plugin.git

# 或从 GitHub 镜像克隆
git clone https://github.com/brother-one/dev-flow-plugin.git
```

### 第二步：启动 Claude Code 并初始化项目

```bash
# 加载 Plugin 启动（将路径替换为实际 clone 位置）
claude --plugin-dir /path/to/dev-flow-plugin
```

**设置快捷命令（可选）**：

```bash
# macOS / Linux — 写入 ~/.bashrc 或 ~/.zshrc
alias cc='claude --plugin-dir /path/to/dev-flow-plugin'

# Windows PowerShell — 写入 $PROFILE
function cc { claude --plugin-dir D:\path\to\dev-flow-plugin @args }

# Windows CMD — 创建 cc.cmd 放到 PATH 目录下
# 文件内容: @claude --plugin-dir D:\path\to\dev-flow-plugin %*
```

首次使用在 Claude Code 中运行脚手架，交互式生成项目配置：

```
/dev-flow:init
```

脚手架会问你：编程语言、构建工具、编译/测试命令、仓库模式，并生成：

| 文件 | 用途 |
|------|------|
| `.dev-flow/config.md` | 项目配置唯一定义点（仓库、构建命令、基础设施） |
| `.dev-flow/config.env` | Hook 消费的环境变量 |
| `.dev-flow/features/` | 需求文档目录 |
| `.dev-flow/state/` | 运行时状态目录 |

### 第三步：开始开发

描述你的需求，dev-flow 自动接管，按阶段推进：

```
我要实现用户权限校验接口
```

---

## 三阶段工作流

```
        SHAPE 需求+设计        BUILD 编码+CR          SHIP 合并提测
       ┌──────────┐          ┌──────────┐          ┌──────────┐
       │ 需求拆解  │          │ TDD 编码  │          │ 全量验证  │
       │ 设计讨论  │─G1/G2──→│ 自测+链路  │G3/G4/G5→│ 按策略合并 │──G6──→ Done
       │ reviewer评审│        │ 代码评审  │          │ 用户确认推送│
       │ 用户确认  │          │ 整改循环  │          │ 经验沉淀  │
       └──────────┘          │ 用户确认  │          └──────────┘
                              └──────────┘
```

**核心公式**：（输入 + 返工输入）+ 流程 + 门禁 = 高质量产出

### SHAPE：需求理解 + 详细设计

CC 与用户交互式拆解需求、讨论设计，reviewer 独立评审，用户确认。

**产出物**：`requirement.md` + `design.md`

### BUILD：编码自测 CR

TDD 编码（先写测试再实现）→ 全量编译 + 单测 → 代码评审 → HIGH 问题整改循环。

**产出物**：代码 + `reviews/test-report.md` + `reviews/code-review.md`

**整改循环**：HIGH 问题 → 修复 → 重跑 self-test → 复审，直到 0 个 HIGH

### SHIP：合并提测

全量验证 → 按项目策略合并 → 用户确认 push → 经验沉淀。

### 返工机制

返工不等于重来。保留有效产出，只重做受影响部分：

| 回退路径 | 触发条件 | 处理 |
|---------|---------|------|
| BUILD → SHAPE | 编码时发现设计缺陷 | `git stash` 暂存代码，重跑 SHAPE，`stash pop` 继续 |
| SHIP → BUILD | 合并前测试失败 | 回退修复 |

连续返工 ≥3 轮自动升级为用户决策。

### 需求分级

| 级别 | 文件数 | 有 DB/接口变更 | 流程裁剪 |
|------|--------|:-------------:|---------|
| XS | ≤3 | 否 | 简化 SHAPE，轻量 BUILD |
| S | ≤8 | 否 | 简化 SHAPE |
| M | ≤20 | 可能 | 完整三阶段 |
| L | >20 | 是 | 完整三阶段 + 多仓并行编排 |

---

## 6 道质量门禁

每个阶段必须全部门禁签收后才能推进到下一阶段。

| 阶段 | 门禁 | 签收人 | 说明 |
|------|------|--------|------|
| **SHAPE** | G1 requirement.md 存在 | CC 自动 | 需求文档就绪 |
| | G2 design.md 存在（M/L） | CC 自动 | 设计文档就绪 |
| **BUILD** | G3 全量编译通过 | CC 自动 | 编译 0 错误 |
| | G4 全量单测通过 | CC 自动 | 测试 0 失败 |
| **SHIP** | G5 CR 0 个 HIGH | 3 专项评审官 | 并行评审汇总 |
| | G6 用户确认 push | 用户（线下） | 允许推送远程 |

---

## Agent 角色体系

| Agent | 角色 | 职责 |
|-------|------|------|
| `logic-reviewer` | 逻辑评审官 | 需求覆盖、架构方案、数据流、边界条件、测试覆盖 |
| `security-reviewer` | 安全评审官 | 注入、权限、泄露、配置安全 |
| `quality-reviewer` | 质量评审官 | 复杂度、重复、命名、规范、技术债 |
| `writer` | 文档执笔人 | CC 传入内容，writer 写入并验证 |

**评审机制**：

```
CC 准备评审内容 → 并行 spawn 3 专项评审官 → CC 汇总去重 → writer 写入
```

**关键约束**：3 评审官只审不写（没有 Write/Edit 权限）；writer 只写不评（不做内容判断）。

### Agent 模板继承

`templates/agents/` 提供 3 个基础模板，新 Agent 可继承复用：

| 模板 | 用途 |
|------|------|
| `base-reviewer.md` | 评审类 Agent 基础能力（评审规范、问题分级、输出格式） |
| `base-security.md` | 安全类 Agent 基础能力（OWASP、注入检测、鉴权审查） |
| `base-tester.md` | 测试类 Agent 基础能力（覆盖度分析、Mock 策略、回归验证） |

---

## Skill 一览

最核心的 5 个 Skill：

| Skill | 阶段 | 说明 |
|-------|------|------|
| `/dev-flow` | 全流程 | 状态机主编排器，驱动全部三阶段 |
| `/dev-flow:coding` | BUILD | TDD 编码，按依赖序逐模块实现 |
| `/dev-flow:self-test` | BUILD | 全量编译 + 单测 + 链路测试（可独立调用） |
| `/dev-flow:init` | 无限制 | 项目初始化脚手架（可独立调用） |

<details>
<summary>展开：全部 10 个 Skill</summary>

| Skill | 阶段 | 说明 | 执行模式 | 独立可用 |
|-------|------|------|---------|:--------:|
| `/dev-flow` | 全流程 | 状态机主编排器 | 主编排 | - |
| `/dev-flow:requirement-analysis` | SHAPE | 交互式需求拆解 | CC+用户交互 | - |
| `/dev-flow:brainstorm` | SHAPE | 设计讨论 | CC+用户交互 | - |
| `/dev-flow:coding` | BUILD | TDD 编码（按依赖序） | CC 直接 | - |
| `/dev-flow:self-test` | BUILD | 全量编译 + 单测 + 链路测试 | CC 直接 | ✅ |
| `/dev-flow:merge-release` | SHIP | 合并 + push + 经验沉淀 | CC 直接 | - |
| `/dev-flow:config-review` | 无限制 | 配置体系深度审查 | spawn reviewers | ✅ |
| `/dev-flow:init` | 无限制 | 项目初始化脚手架 | CC+用户交互 | ✅ |
| `/dev-flow:config` | 无限制 | 查询/修改配置、门禁开关、文档格式修复 | CC 直接 | ✅ |
| `/dev-flow:run` | 无限制 | 本地服务启动编排（编译→预检→启动→健康检查） | Subagent | ✅ |

标记 **✅** 的 Skill 可脱离 dev-flow 主流程单独调用。

</details>

---

## Hook 防御体系

事件驱动的自动化守护，6 个核心 Hook，无需手动触发。所有 Hook 遵循 **Fail-Safe 原则**（异常时放行，不阻塞正常工作）。

| Hook | 触发事件 | 做什么 |
|------|---------|-------|
| `doc-lock.sh` | PreToolUse[Edit/Write/NotebookEdit] | 设计文档修改建议（advisory，不阻塞） |
| `push-gate.sh` | PreToolUse[Bash] | 非 SHIP 阶段 Git push 拦截 |
| `bash-guard.sh` | PreToolUse[Bash] | 文件修改拦截 + 外部操作确认（DB/deploy/ssh） |
| `session-context.sh` | SessionStart | 注入项目全局快照（分支/变更/需求/门禁） |
| `state-save.sh` | PreCompact / SessionEnd | 持久化关键状态到 `compact-state.md`（异步） |
| `test-gate.sh` | Stop | BUILD/SHIP 阶段有源码变更时触发编译门禁 |

<details>
<summary>展开：辅助脚本（非 Hook，由 Hook/Skill source 引用）</summary>

| 脚本 | 用途 |
|------|------|
| `common.sh` | 向后兼容 wrapper，加载以下 5 个模块 |
| `common-core.sh` | 路径变量、config.env 加载、freemode/waiver、审计日志、jq helpers |
| `common-i18n.sh` | 国际化消息 (get_i18n_message) |
| `common-feature.sh` | FEATURE.md 解析、DOC-LOCK、状态 JSON 侧车 |
| `common-build.sh` | 构建命令 (run_build/run_compile/run_install) |
| `common-platform.sh` | 跨平台 helpers (kill/mktemp/service status) |

</details>

---

## 三层架构

```
┌─────────────────────────────────────────────────────┐
│               Plugin 层（可升级/可禁用）               │
│  dev-flow-plugin/                                    │
│  ├── skills/     10 个 Skill                         │
│  ├── agents/     5 个 Agent 角色                     │
│  ├── hooks/      6 个核心 Hook + 6 个辅助模块脚本     │
│  ├── templates/  13 个模板（Agent 继承 + 技术栈规则集）│
│  ├── i18n/       国际化资源（zh-CN / en）              │
│  ├── tests/      113 个测试用例                  │
│  └── settings.json                                   │
├─────────────────────────────────────────────────────┤
│               项目治理层（不可禁用）                    │
│  .claude/                                            │
│  ├── CLAUDE.md          角色定义 + 状态机总纲         │
│  ├── rules/*.md         协作规约/Git/编码/测试规范     │
│  └── hooks/             安全 Hook（审计/隔离/防泄漏）  │
├─────────────────────────────────────────────────────┤
│               项目配置层（/dev-flow:init 生成）         │
│  .dev-flow/                                          │
│  ├── config.md          项目配置唯一定义点             │
│  ├── config.env         Hook 环境变量                 │
│  ├── features/          需求文档（每需求一目录）          │
│  │   └── <需求名>/                                      │
│  │       ├── FEATURE.md       状态机主控                │
│  │       ├── requirement.md   需求理解文档              │
│  │       ├── design.md        详细设计文档              │
│  │       ├── external-changes.md  外部变更记录（可选）   │
│  │       └── reviews/        评审产出物                  │
│  ├── knowledge.md       团队知识库                    │
│  └── state/             运行时状态                    │
└─────────────────────────────────────────────────────┘
```

**Plugin 层**跨项目通用，随版本升级。**项目治理层**绑定技术栈和安全要求。**项目配置层**由 `/dev-flow:init` 按项目信息生成。换项目只需重跑 init。

---

## i18n 国际化

dev-flow 支持中英文双语界面，资源文件位于 `i18n/` 目录：

| 文件 | 语言 |
|------|------|
| `i18n/zh-CN.json` | 简体中文（默认） |
| `i18n/en.json` | English |

通过 `/dev-flow:config` 切换语言，Hook 输出、门禁提示、Agent 交互均跟随语言设置。

---

## 技术栈模板

`templates/rulesets/` 提供开箱即用的技术栈规则集，`/dev-flow:init` 自动匹配：

| 规则集 | 包含 | 适用场景 |
|--------|------|---------|
| `java-enterprise/` | coding-standards.md + git-workflow.md + testing.md + ruleset.json | Java/Maven 企业级项目 |
| `go-standard/` | coding-standards.md + testing.md + ruleset.json | Go 标准项目 |
| `typescript-react/` | coding-standards.md + testing.md + ruleset.json | TypeScript/React 前端项目 |

每个规则集包含编码规范、测试策略、Git 工作流等配置，`/dev-flow:init` 根据项目选择自动复制到 `.claude/rules/`。

---

---

## 分支策略适配

dev-flow 支持多种分支策略，在 `/dev-flow:init` 时选择，`/dev-flow:merge-release` 自动适配合并行为：

| 策略 | 合并方式 | 适用场景 |
|------|---------|---------|
| Feature Branch | feature → 版本分支 → main | 团队协作，多需求并行 |
| GitFlow | feature → develop → release → main | 企业级发版流程 |
| Trunk-Based | 短生命周期分支 → main | 持续部署，快速迭代 |

详见 [分支策略设计文档](docs/branch-strategies.md)。

---

## 协作通知（可选扩展）

协作通知 webhook 已从核心 Hook 中移除（v2.0）。如需在门禁签收、阶段推进等事件推送通知到飞书/钉钉/Slack，参考 [协作通知设计文档](docs/future/collaboration-design.md) 自行开发。

---

## 外部 LLM 辅助评审

v2.0 移除了 prompt 类型 Hook，改用纯命令型 Hook 实现防护。外部 LLM 辅助评审作为可选扩展保留。

详见 [多 LLM 辅助评审设计](docs/future/multi-llm-design.md)。

---

## CI 多平台适配

### GitHub Actions（已集成）

`.github/workflows/hook-ci.yml` 提供跨平台 CI 矩阵：

| 平台 | 运行环境 | 状态 |
|------|---------|------|
| Linux | ubuntu-latest | ✅ |
| macOS | macos-latest | ✅ |
| Windows | windows-latest（Git Bash） | ✅ |

---

## Hook 测试套件

`tests/` 目录包含完整的 Hook 回归测试：

| 文件 | 说明 |
|------|------|
| `hook-tests.sh` | 113 个测试用例，覆盖全部 Hook 脚本的核心逻辑 |
| `run-tests.sh` | 测试运行器，TAP 协议输出，聚合 pass/fail/skip |

**CI 矩阵**：GitHub Actions 在 3 个平台（Linux/macOS/Windows）并行执行，确保跨平台兼容性。

运行测试：

```bash
bash tests/run-tests.sh
```

---

## 多语言支持

`/dev-flow:init` 交互式适配技术栈，一次配置全流程通用：

| 技术栈 | 编译 | 测试 | 安装 |
|--------|------|------|------|
| Java / Maven | `mvn compile` | `mvn test` | `mvn install -DskipTests` |
| Go | `go build ./...` | `go test ./...` | - |
| Python / pip | `python -m compileall . -q` | `pytest` | `pip install -r requirements.txt` |
| TypeScript / npm | `npm run build` | `npm test` | `npm install` |
| Kotlin / Gradle | `./gradlew compileKotlin` | `./gradlew test` | - |
| C++ / CMake | `cmake --build build/` | `cd build && ctest` | - |
| Rust / Cargo | `cargo build` | `cargo test` | - |

**适配三步走**：
1. `/dev-flow:init` 生成配置（自动匹配 `templates/rulesets/` 中的规则集）
2. 检查 Skill/Agent 中的 `<!-- CUSTOMIZE -->` 块，按需替换技术栈特定内容
3. 如有项目特有安全检查项，补充到 `security-reviewer.md`

---

## 前置条件

| 依赖 | 说明 |
|------|------|
| [Claude Code](https://claude.com/claude-code) | 需支持 `--plugin-dir` |
| bash | Hook 执行（Windows 需 Git Bash） |
| jq | Hook JSON 解析（[安装指南](https://jqlang.github.io/jq/download/)） |
| git | 版本控制 |
| 构建工具 | 按项目技术栈（Maven / Go / npm / pip / Cargo / ...） |

---

## 目录结构

```
dev-flow-plugin/
├── .claude-plugin/
│   ├── plugin.json           Plugin manifest
│   └── marketplace.json      扩展包注册表
├── .github/
│   └── workflows/
│       └── hook-ci.yml       CI 矩阵（Linux/macOS/Windows）
├── skills/                    10 个 Skill
│   ├── dev-flow/SKILL.md     主编排器
│   ├── requirement-analysis/
│   ├── brainstorm/
│   ├── coding/
│   ├── self-test/
│   ├── merge-release/
│   ├── config-review/
│   ├── init/
│   ├── config/
│   └── run/
├── agents/                    5 个 Agent 角色
│   ├── logic-reviewer.md
│   ├── security-reviewer.md
│   ├── quality-reviewer.md
│   ├── writer.md
│   └── coach.md
├── hooks/                     工作流 Hooks
│   ├── hooks.json            6 个核心 Hook 注册
│   ├── doc-lock.sh           已签收文档写入拦截
│   ├── push-gate.sh          Git push 阶段门禁
│   ├── bash-guard.sh         Bash 文件修改拦截
│   ├── session-context.sh    会话启动状态快照
│   ├── state-save.sh         上下文/会话结束状态保存
│   ├── test-gate.sh          编译验证门禁
│   ├── common.sh             向后兼容 wrapper
│   ├── common-core.sh        路径变量、config.env、freemode/waiver
│   ├── common-i18n.sh        国际化消息
│   ├── common-feature.sh     FEATURE.md 解析、DOC-LOCK
│   ├── common-build.sh       构建命令
│   └── common-platform.sh    跨平台 helpers
├── templates/                 13 个模板文件
│   ├── agents/               Agent 继承模板
│   │   ├── base-reviewer.md
│   │   ├── base-security.md
│   │   └── base-tester.md
│   └── rulesets/             技术栈规则集
│       ├── java-enterprise/  Java 企业级
│       ├── go-standard/      Go 标准
│       └── typescript-react/ TypeScript/React
├── i18n/                      国际化资源
│   ├── zh-CN.json            简体中文
│   └── en.json               English
├── tests/                     Hook 测试套件
│   ├── hook-tests.sh         113 个测试用例
│   └── run-tests.sh          测试运行器
├── docs/
│   ├── tutorial/              深度教程（01-06）
│   ├── future/                未来规划设计文档
│   │   ├── collaboration-design.md 协作通知设计
│   │   └── multi-llm-design.md    多 LLM 辅助评审设计
│   ├── quick-start.md         快速上手
│   ├── distribution.md        分发指南
│   ├── branch-strategies.md   分支策略设计
│   ├── marketplace-design.md  Marketplace 设计
│   ├── web-dashboard-design.md 仪表板设计
│   ├── adaptive-flow-design.md 自适应流程设计
│   └── roadmap.md             路线图
├── rules/                     项目治理规范模板
│   ├── documentation.md
│   └── external-deps.md
├── settings.json              权限配置
├── CHANGELOG.md
├── KNOWN_ISSUES.md
└── README.md
```

---

## 教程

深度教程位于 `docs/tutorial/`，覆盖核心机制：

| 教程 | 内容 |
|------|------|
| [01 核心引擎](docs/tutorial/01-core-engine.md) | 三阶段工作流原理与门禁体系 |
| [02 Agent 协作与 Skill 体系](docs/tutorial/02-agent-and-skill.md) | Agent 角色分工、spawn 模型与 Skill 设计 |
| [03 Hook 机制](docs/tutorial/03-hook-mechanism.md) | 6 个核心 Hook 与 Fail-Safe 原则 |
| [04 架构设计](docs/tutorial/04-architecture.md) | 三层架构详解与定制化指南 |
| [05 文档体系](docs/tutorial/05-document-system.md) | FEATURE.md 生命周期与 DOC-LOCK 机制 |
| [06 完整演练](docs/tutorial/06-walkthrough.md) | 从需求到 push 的端到端实战演示 |

---

## 常见问题

**Q: 小需求也要走完整流程吗？**
不需要。dev-flow 自动按需求规模分级（XS/S/M/L），小改动简化 SHAPE，轻量 BUILD。

**Q: 可以单独用某个 Skill 吗？**
标记「独立可用 ✅」的 Skill 可以直接调用，如 `/dev-flow:self-test`、`/dev-flow:config-review`。

**Q: 换项目怎么办？**
重跑 `/dev-flow:init`，重新生成 `.dev-flow/config.*` 即可。Plugin 层不需要改动。

**Q: 返工会丢失进度吗？**
不会。返工保留有效产出（代码 `git stash` 暂存，文档追加修订章节），只重做受影响部分。

**Q: Windows 能用吗？**
能。需要 Git Bash。已知问题和 workaround 见 [KNOWN_ISSUES.md](KNOWN_ISSUES.md)。

**Q: Hook 没有触发怎么排查？**
常见原因：`jq` 未安装、`config.env` 路径错误、bash 版本过旧（需 ≥4.0）。可通过 `bash tests/run-tests.sh` 运行 Hook 测试套件排查。

**Q: 多仓项目怎么配置？**
`/dev-flow:init` 时选择「多仓」模式，填写各仓库路径。L 级需求会自动按仓库分工并行编排。

**Q: 怎么给项目添加自定义安全规则？**
编辑 `.claude/agents/security-reviewer.md`，在 `<!-- CUSTOMIZE -->` 块中补充项目特有风险点。

**Q: 怎么安装社区扩展包？**
参考 [Marketplace 设计文档](docs/marketplace-design.md) 了解扩展包安装方式。

---

## 团队与企业部署

<details>
<summary>展开：团队统一配置</summary>

**团队统一安装**：将插件仓库 clone 到团队共享路径，所有成员使用相同的 `--plugin-dir` 参数。

```bash
# 团队共享目录（Linux/macOS）
git clone https://gitee.com/brother-one/dev-flow-plugin.git /opt/dev-flow-plugin

# 团队共享目录（Windows）
git clone https://gitee.com/brother-one/dev-flow-plugin.git D:\opt\dev-flow-plugin
```

成员设置快捷命令（参见上方「设置快捷命令」章节）。

**企业 Fork 策略**：Fork 到企业组织，按企业规范定制 `rules/` 和 `agents/`，通过 upstream 合并获取版本更新。

**私有仓库**需配置 `GITHUB_TOKEN` 或 `GITEE_TOKEN` 环境变量。

详见 [分发指南](docs/distribution.md)。

</details>

---

## 许可证

[MIT](LICENSE)

---

> 问题反馈与建议：[Gitee Issues](https://gitee.com/brother-one/dev-flow-plugin/issues)