cc-devflow 2.4.5 → 2.4.6

package/.claude/CLAUDE.md

@@ -10,6 +10,7 @@ This directory contains Claude Code CLI extensions for the CC-DevFlow developmen
 ├── agents/                    # Agent instruction files (research-type, invoked by commands)
 │   ├── checklist-agent.md     # Checklist generation logic [NEW: REQ-002]
 │   ├── clarify-analyst.md     # Requirements clarification
+│   ├── flow-researcher.md     # /flow-init mandatory research runner (subagent; file-based memory)
 │   ├── prd-writer.md          # PRD generation
 │   ├── tech-architect.md      # Technical design
 │   ├── planner.md             # EPIC/TASKS planning
@@ -19,7 +20,7 @@ This directory contains Claude Code CLI extensions for the CC-DevFlow developmen
 │
 ├── commands/                  # Slash command definitions
 │   ├── flow-checklist.md      # /flow-checklist command [NEW: REQ-002]
-│   ├── flow-init.md           # /flow-init (modified: Git Branch Creation moved to Stage 1.2)
+│   ├── flow-init.md           # /flow-init (modified: research delegated to flow-researcher subagent)
 │   ├── flow-clarify.md        # /flow-clarify
 │   ├── flow-prd.md            # /flow-prd
 │   ├── flow-tech.md           # /flow-tech
@@ -132,7 +133,7 @@ Combine Ralph-Wiggum's autonomous iteration loop with Manus-style Planning-with-
 
 **Modified Files**:
 - `commands/flow-dev.md` - Merged Ralph Loop (Autonomous by default)
-- `commands/flow-init.md` - Added Manus method in Stage 2.5 Research
+- `commands/flow-init.md` - Research made mandatory via `flow-researcher` subagent (context-isolated)
 - `skills/cc-devflow-orchestrator/SKILL.md` - Updated routing for autonomous flow
 
 ### Attention Refresh Protocols

package/.claude/agents/flow-researcher.md

@@ -0,0 +1,132 @@
+---
+name: flow-researcher
+description: Executes mandatory /flow-init deep research using MCP services (Context7/WebSearch/WebFetch) with file-based memory. Produces research artifacts under devflow/requirements/$REQ_ID/research/ and returns only a short summary + file paths (no long pastes).
+tools: Read, Write, Grep, Glob, WebFetch, WebSearch, mcp__context7__resolve-library-id, mcp__context7__get-library-docs
+model: inherit
+---
+
+You are a requirement research runner invoked by `/flow-init`.
+
+Your job is to do **research work** without exhausting the main session context:
+- Put large content into files under `devflow/requirements/$REQ_ID/research/`
+- Return only a **short** summary + **paths**, never paste long docs into chat
+
+## MCP Research Requirement
+
+This agent MUST use **MCP services** to fetch external materials for deep research:
+- **Context7 MCP**: official documentation for detected frameworks/libraries (`mcp__context7__resolve-library-id` + `mcp__context7__get-library-docs`)
+- **WebSearch + WebFetch**: tutorials, guides, examples, case studies, and plan URLs
+
+All fetched content MUST be written to `research/mcp/YYYYMMDD/**` (not pasted into chat).
+
+## Hard Rules
+
+1. **NO USER INTERACTION**
+   - Never ask the user questions.
+   - If information is missing, record it under `## Unresolved Questions` in `research/research-summary.md`.
+
+2. **FILE-BASED MEMORY (MANDATORY)**
+   - Any fetched/long content must be written to files in `research/`.
+   - Chat output must stay small (decision bullets + file paths).
+
+3. **NO PLACEHOLDERS**
+   - Do not leave `TODO`, `FIXME`, `{{PLACEHOLDER}}`.
+   - Ensure `validate-research.sh --strict` passes.
+
+4. **TRACEABILITY**
+   - Every decision must include a concrete `Source` (file path + section/line if possible).
+
+## Input Contract (provided via prompt)
+
+You will receive a JSON payload in the prompt:
+
+```json
+{
+  "reqId": "REQ-123",
+  "reqDir": "devflow/requirements/REQ-123",
+  "title": "User Authentication",
+  "planUrls": ["https://..."],
+  "contextFiles": {
+    "brainstorm": "devflow/requirements/REQ-123/BRAINSTORM.md",
+    "roadmap": "devflow/ROADMAP.md",
+    "architecture": "devflow/ARCHITECTURE.md"
+  }
+}
+```
+
+## Required Outputs (MUST create/update)
+
+Under `${reqDir}/research/`:
+- `internal/codebase-overview.md`
+- `mcp/YYYYMMDD/official/*.md` (if applicable)
+- `mcp/YYYYMMDD/guides/*.md` (if applicable)
+- `mcp/YYYYMMDD/tutorials/*.md` (if applicable)
+- `mcp/YYYYMMDD/examples/*.md` (if applicable)
+- `research-summary.md` (human-readable decisions)
+- `tasks.json` (decision/rationale/alternatives filled)
+- `research.md` (consolidated, Decision/Rationale/Alternatives format)
+
+## Execution Procedure (follow in order)
+
+### Step 1: Validate Paths & Prepare Directories
+- Ensure `${reqDir}` exists.
+- Ensure `${reqDir}/research/` exists, create missing subfolders:
+  - `research/internal/`
+  - `research/mcp/YYYYMMDD/{official,guides,tutorials,examples}/`
+- Read `${reqDir}/BRAINSTORM.md` and `${reqDir}/README.md` if present.
+
+### Step 2: Internal Codebase Research (S0)
+Goal: produce a **useful** `research/internal/codebase-overview.md` with:
+- Repo tech stack snapshot (from `package.json`, lockfiles, etc.)
+- Relevant modules/entry points you will likely touch
+- Existing patterns for auth/data validation/error handling/tests
+- Constraints you must not violate (existing conventions, CI, tooling)
+
+### Step 3: External Research (Task 1-5)
+Do not paste docs into chat; store them as files.
+
+1) **Official docs (Context7 MCP)** for the detected key libraries/frameworks
+2) **Tutorials/guides (WebSearch + WebFetch)** for practical patterns
+3) **Examples/case studies (WebSearch + WebFetch)** similar to this requirement
+4) Write short per-source notes at top of each saved file:
+   - What it answers
+   - What it recommends
+   - Any caveats
+
+If planUrls exist:
+- Fetch each URL and store content under `research/mcp/YYYYMMDD/guides/plan-*.md` (or `tutorials/` if more appropriate).
+
+### Step 4: Write `research/research-summary.md`
+Use `.claude/docs/templates/RESEARCH_TEMPLATE.md` as the format baseline.
+- Create **at least 3** Decision blocks `### R001`, `### R002`, `### R003`.
+- Each decision must cite sources under `research/` (internal or external).
+- Add unresolved questions only when genuinely blocked.
+
+### Step 5: Generate & Fill `tasks.json`
+- Run:
+  - `bash .claude/scripts/generate-research-tasks.sh "${reqDir}"`
+- Ensure `tasks.json` contains at least **1** task.
+  - If the generator produced 0 tasks, append baseline tasks matching your decision blocks (`R001..R003`).
+- Fill each task's `decision`, `rationale`, `alternatives` based on `research-summary.md`.
+  - Prefer using `bash .claude/scripts/populate-research-tasks.sh "${reqDir}"` if it matches the ID format.
+
+### Step 6: Consolidate & Validate
+- Run:
+  - `bash .claude/scripts/consolidate-research.sh "${reqDir}"`
+  - `bash .claude/scripts/validate-research.sh "${reqDir}" --strict`
+- If validation fails:
+  - Fix the files (do not weaken validation).
+  - Re-run validation until it passes.
+
+## Return Format (chat output)
+
+Return ONLY:
+- 3–6 bullet decisions (R001..), one line each
+- Paths created/updated
+- Any unresolved questions (≤5)
+
+Never paste long fetched content.
+
+---
+
+**[PROTOCOL]**: 变更时更新此头部，然后检查 CLAUDE.md

package/.claude/commands/flow-init.md

@@ -219,85 +219,53 @@ Red Flags - STOP:
 
 ---
 
-### Stage 2.5: Research (MCP Mandatory Flow)
+### Stage 2.5: Research (Subagent Mandatory)
 
-**目标**: 收集"真实材料"，所有步骤 **MANDATORY**
+**目标**: 研究默认必跑，但将“研究型内容”隔离到 subagent，避免主会话上下文耗尽。
 
-**Manus 研究方法** (Planning-with-files 融合):
+**Iron Law**: 大内容落盘，主会话只返回「决策摘要 + 文件路径」。
 
-```yaml
-原则 1: 大内容存文件
-  → 抓取的文档存 research/mcp/$(date +%Y%m%d)/
-  → 上下文只保留路径引用
-  → 避免塞满上下文窗口
-
-原则 2: 决策前读取
-  → 每次做研究决策前，先读 research/research.md Decisions 章节
-  → 确保不重复已有决策
-  → 注意力刷新，目标回到窗口
-
-原则 3: 失败尝试记录
-  → 研究中放弃的方案写入 research/attempts/
-  → 说明放弃原因和学习（见 ATTEMPT_TEMPLATE 格式）
-  → 失败是学习数据，不要隐藏
-
-原则 4: 增量追加
-  → 使用 append 而非 rewrite
-  → 保持研究历史完整
-  → 避免覆盖已有信息
-```
-
-```
-S0: Internal Codebase Research (必需)
-→ 分析现有代码库，生成 research/internal/codebase-overview.md
+#### ✅ Mandatory: Call `flow-researcher` Subagent
 
-Task 1-5: External Learning Materials (MCP)
-1. Official Documentation (Context7)
-2. Domain Tutorials (Web Search)
-3. Core Materials (WebFetch)
-4. Case Studies/Examples (Web Search + WebFetch)
-5. Summary & Recommendations
+> subagent 负责内部/外部研究、落盘、任务回填、研究整合与质量验证；主 agent 只做编排与最终 Gate。
 
-→ 详见 {TEMPLATE:flow} Stage 2.5
+```
+Task tool call:
+  description: "Run mandatory research for /flow-init (file-based memory)"
+  subagent_type: "flow-researcher"
+  model: "inherit"
+  prompt: (JSON)
+    {
+      "reqId": "${REQ_ID}",
+      "reqDir": "devflow/requirements/${REQ_ID}",
+      "title": "${TITLE}",
+      "planUrls": ["..."],
+      "contextFiles": {
+        "brainstorm": "devflow/requirements/${REQ_ID}/BRAINSTORM.md",
+        "roadmap": "devflow/ROADMAP.md",
+        "architecture": "devflow/ARCHITECTURE.md"
+      }
+    }
 ```
 
-**输出**:
-- `research/internal/codebase-overview.md`
-- `research/mcp/$(date +%Y%m%d)/official/*`
-- `research/mcp/$(date +%Y%m%d)/guides/*`
-- `research/mcp/$(date +%Y%m%d)/tutorials/*`
-- `research/mcp/$(date +%Y%m%d)/examples/*`
-- `research/research-summary.md`
+**期望输出** (由 subagent 写入):
+- `devflow/requirements/${REQ_ID}/research/internal/codebase-overview.md`
+- `devflow/requirements/${REQ_ID}/research/mcp/$(date +%Y%m%d)/**`
+- `devflow/requirements/${REQ_ID}/research/research-summary.md`
+- `devflow/requirements/${REQ_ID}/research/tasks.json` (decision/rationale/alternatives 完整)
+- `devflow/requirements/${REQ_ID}/research/research.md` (可通过 validate-research)
 
 ---
 
 ### Stage 2.6: Research Consolidation
 
-```
-研究决策整合:
-1. Generate research tasks
-   → Run: {SCRIPT:research_tasks} "${REQ_DIR}"
-   → Output: research/tasks.json
-
-2. Populate task decisions
-   → Run: {SCRIPT:populate_tasks} "${REQ_DIR}"
-   → Fill decision/rationale/alternatives from research
-
-3. Consolidate research
-   → Run: {SCRIPT:consolidate} "${REQ_DIR}"
-   → Output: research/research.md
-   → Format: Decision/Rationale/Alternatives/Source
+> 该阶段由 `flow-researcher` subagent 执行（包含 tasks 生成/回填/整合/校验）。
 
-4. Update status
-   → orchestration_status.json.phase0_complete = true
-
-→ 详见 {TEMPLATE:flow} Stage 2.6
-```
+主 agent 在 Exit Gate 中只做最终验证与状态更新：
+- Run: `{SCRIPT:validate_research} "${REQ_DIR}" --strict`
+- `orchestration_status.json.phase0_complete = true`
 
 ---
-
-
-
 ### Stage 3: README Generation
 
 ```
@@ -317,7 +285,7 @@ Level 1: File Existence Check
 → 验证所有必需文件已创建
 
 Level 2: Research.md Structure Validation
-→ Run: {SCRIPT:validate_research} "${REQ_DIR}"
+→ Run: {SCRIPT:validate_research} "${REQ_DIR}" --strict
 → 检查 research.md 结构
 
 Level 3: Research.md Content Quality

package/.claude/docs/templates/INIT_FLOW_TEMPLATE.md

@@ -93,55 +93,32 @@ devflow/requirements/${REQ_ID}/
 
 ---
 
-## Stage 2.5: Research (MCP Mandatory Flow)
+## Stage 2.5: Research (Subagent Mandatory)
 
-**目标**: 收集"真实材料"，所有步骤 **MANDATORY**
+**目标**: 研究默认必跑，但研究过程必须“隔离上下文”。
 
-### S0: Internal Codebase Research (必需)
-```bash
-→ 分析现有代码库
-→ 生成 research/internal/codebase-overview.md
-```
-
-### Task 1-5: External Learning Materials (MCP)
-```
-1. Official Documentation (Context7)
-   → research/mcp/$(date +%Y%m%d)/official/
+**规则**: 大内容写入 `research/`，主会话只保留路径引用与决策摘要。
 
-2. Domain Tutorials (Web Search)
-   → research/mcp/$(date +%Y%m%d)/guides/
+### Mandatory: Call `flow-researcher` Subagent
 
-3. Core Materials (WebFetch)
-   → research/mcp/$(date +%Y%m%d)/tutorials/
-
-4. Case Studies/Examples (Web Search + WebFetch)
-   → research/mcp/$(date +%Y%m%d)/examples/
-
-5. Summary & Recommendations
-   → research/research-summary.md
+```
+Task tool call:
+  subagent_type: "flow-researcher"
+  prompt: (JSON) reqId/reqDir/title/planUrls/contextFiles
 ```
 
+**产物** (由 subagent 写入):
+- `research/internal/codebase-overview.md`
+- `research/mcp/$(date +%Y%m%d)/**`
+- `research/research-summary.md`
+- `research/tasks.json`
+- `research/research.md`
+
 ---
 
 ## Stage 2.6: Research Consolidation
 
-```bash
-# 1. Generate research tasks
-bash {SCRIPT:research_tasks} "${REQ_DIR}"
-→ Output: research/tasks.json
-
-# 2. Populate task decisions
-bash {SCRIPT:populate_tasks} "${REQ_DIR}"
-→ Fill decision/rationale/alternatives from research
-
-# 3. Consolidate research
-bash {SCRIPT:consolidate} "${REQ_DIR}"
-→ Output: research/research.md
-→ Format: Decision/Rationale/Alternatives/Source
-
-# 4. Update status
-orchestration_status.json.phase0_complete = true
-```
+> 该阶段由 `flow-researcher` subagent 执行（含 tasks 生成/回填/整合/校验）。
 
 ---
 
@@ -166,7 +143,7 @@ orchestration_status.json.phase0_complete = true
 
 ### Level 2: Research.md Structure Validation
 ```bash
-bash {SCRIPT:validate_research} "${REQ_DIR}"
+bash {SCRIPT:validate_research} "${REQ_DIR}" --strict
 → 检查 research.md 结构
 ```
 

package/.claude/scripts/populate-research-tasks.sh

@@ -72,24 +72,44 @@ def extract_task_sections(markdown_content: str) -> List[Dict[str, str]]:
     从 research-summary.md 中提取任务章节信息。
 
     期望格式:
-    ### RT-001: 输入框架构重构
-    **决策**: 全面重构方案
-    **理由**: 当前实现仅207行...
-    **备选方案**: 1. 渐进式增强...
+    ### R001 — 输入框架构重构
+    - **Decision**: 全面重构方案
+    - **Rationale**:
+      - 当前实现仅207行...
+    - **Alternatives Considered**:
+      - 渐进式增强...
     """
     sections = []
     current_section = None
-
-    # 匹配任务标题: ### RT-001: 任务标题
-    task_header = re.compile(r'^###\s+(RT-\d+):\s+(.+)$')
-    # 匹配决策行: **决策**: xxx 或 **Decision**: xxx
-    decision_line = re.compile(r'^\*\*(?:决策|Decision)\*\*:\s*(.+)$')
-    # 匹配理由行: **理由**: xxx 或 **Rationale**: xxx
-    rationale_line = re.compile(r'^\*\*(?:理由|Rationale)\*\*:\s*(.+)$')
-    # 匹配备选方案行: **备选方案**: xxx 或 **Alternatives**: xxx
-    alternatives_line = re.compile(r'^\*\*(?:备选方案|Alternatives)\*\*:\s*(.+)$')
+    current_field = None
+
+    # 匹配任务标题（兼容历史 RT-001）:
+    # - ### R001 — Title
+    # - ### R001: Title
+    # - ### R001 - Title
+    # - ### RT-001: Title  (legacy)
+    task_header = re.compile(r"^###\s+(?P<id>R\d{3}|RT-\d{3})\s*(?:[:—-])\s*(?P<title>.+)$")
+
+    # 匹配字段头（兼容是否带 bullet）:
+    # - - **Decision**: xxx
+    # - - **Rationale**:
+    # - - **Alternatives Considered**:
+    field_header = re.compile(
+        r"^(?:[-*]\s*)?\*\*(?P<label>决策|Decision|理由|Rationale|备选方案|Alternatives(?:\s+Considered)?|来源|Source)\*\*:\s*(?P<value>.*)$"
+    )
+
+    def normalize_task_id(raw: str) -> str:
+        if raw.startswith("RT-"):
+            return f"R{raw.split('-', 1)[1]}"
+        return raw
+
+    def normalize_list_item(line: str) -> str:
+        line = line.strip()
+        line = re.sub(r"^[-*]\s+", "", line)
+        return line.strip()
 
     for line in markdown_content.splitlines():
+        raw_line = line
         line = line.strip()
 
         # 检测新任务章节
@@ -97,9 +117,10 @@ def extract_task_sections(markdown_content: str) -> List[Dict[str, str]]:
         if task_match:
             if current_section:
                 sections.append(current_section)
+            current_field = None
             current_section = {
-                "id": task_match.group(1),
-                "title": task_match.group(2),
+                "id": normalize_task_id(task_match.group("id")),
+                "title": task_match.group("title"),
                 "decision": "",
                 "rationale": "",
                 "alternatives": "",
@@ -109,31 +130,35 @@ def extract_task_sections(markdown_content: str) -> List[Dict[str, str]]:
         if not current_section:
             continue
 
-        # 提取决策
-        decision_match = decision_line.match(line)
-        if decision_match:
-            current_section["decision"] = decision_match.group(1).strip()
-            continue
-
-        # 提取理由
-        rationale_match = rationale_line.match(line)
-        if rationale_match:
-            current_section["rationale"] = rationale_match.group(1).strip()
+        # 检测字段头
+        field_match = field_header.match(line)
+        if field_match:
+            label = field_match.group("label").strip().lower()
+            value = (field_match.group("value") or "").strip()
+
+            if label in {"来源", "source"}:
+                current_field = None
+                continue
+            if label in {"决策", "decision"}:
+                current_field = "decision"
+            elif label in {"理由", "rationale"}:
+                current_field = "rationale"
+            else:
+                current_field = "alternatives"
+
+            if value:
+                current_section[current_field] = value
             continue
 
-        # 提取备选方案
-        alternatives_match = alternatives_line.match(line)
-        if alternatives_match:
-            current_section["alternatives"] = alternatives_match.group(1).strip()
-            continue
-
-        # 继续累积多行理由（如果上一行是理由）
-        if current_section.get("rationale") and line and not line.startswith("**"):
-            current_section["rationale"] += " " + line.strip()
-
-        # 继续累积多行备选方案
-        if current_section.get("alternatives") and line and not line.startswith("**"):
-            current_section["alternatives"] += " " + line.strip()
+        # 累积字段内容（支持列表项）
+        if current_field and line:
+            item = normalize_list_item(raw_line)
+            if not item:
+                continue
+            if current_section[current_field]:
+                current_section[current_field] += "\n" + item
+            else:
+                current_section[current_field] = item
 
     # 添加最后一个章节
     if current_section:

package/CHANGELOG.md

@@ -7,6 +7,30 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ---
 
+## [2.4.6] - 2026-01-12
+
+### flow-init 工作流精简：研究步骤抽离为 subagent
+
+将研究型内容从主流程中拆分到独立 subagent，减少上下文消耗，并同步更新命令、模板、脚本与文档。
+
+#### Added
+
+- **flow-researcher agent** - 执行 `/flow-init` 深度研究并写入 `devflow/requirements/$REQ_ID/research/`
+
+#### Changed
+
+- **flow-init command** - 重组流程，研究部分改由 subagent 执行
+- **INIT_FLOW_TEMPLATE.md** - 精简初始化模板
+- **populate-research-tasks.sh** - 更新 research tasks 填充逻辑
+- **flow-init docs** - 同步更新中英文文档
+
+#### Benefits
+
+- **更省上下文**: 主会话仅保留关键决策与路径
+- **更可追溯**: 研究产物落盘，便于审计与复用
+
+---
+
 ## [2.4.5] - 2026-01-10
 
 ### 🛠️ Skills 增强：新增开发辅助工具

package/docs/commands/flow-init.md

@@ -47,6 +47,9 @@ Stage 1: Prerequisites validation
   ├─ Check devflow/ directory
   └─ Verify REQ-ID uniqueness
   ↓
+Stage 1.2: Git branch creation
+  └─ Create feature/REQ-XXX-english-slug branch (model-translated, not pinyin)
+  ↓
 Stage 1.5: Roadmap & Architecture context loading (NEW)
   ├─ Check ROADMAP.md existence
   ├─ Locate requirement in roadmap
@@ -64,13 +67,15 @@ Stage 2: Directory structure creation
   ├─ Initialize orchestration_status.json
   └─ Create EXECUTION_LOG.md
   ↓
-Stage 2.6: Research task dispatch & decision integration
-  ├─ Generate research tasks
-  ├─ Populate research decisions
-  └─ Consolidate research findings
+Stage 2.3: Brainstorming (skill)
+  └─ Generate devflow/requirements/REQ-XXX/BRAINSTORM.md as the “North Star”
   ↓
-Stage 3: Git branch creation
-  └─ Create feature/REQ-XXX-english-slug branch (model-translated, not pinyin)
+Stage 2.5: Research (subagent, mandatory, context-isolated)
+  ├─ Run internal codebase research → research/internal/codebase-overview.md
+  ├─ Capture external sources into files → research/mcp/YYYYMMDD/**
+  ├─ Produce decisions → research/research-summary.md
+  ├─ Fill tasks → research/tasks.json (decision/rationale/alternatives)
+  └─ Consolidate → research/research.md (validated; no TODO/PLACEHOLDER)
 ```
 
 ## 💡 Examples
@@ -124,10 +129,9 @@ Stage 3: Git branch creation
 
 ## 📂 Output
 
-- `devflow/requirements/REQ-XXX/` complete directory
-- `orchestration_status.json`
-- `EXECUTION_LOG.md`
-- Roadmap and architecture context (if exists)
+- `devflow/requirements/REQ-XXX/` initialized directory (includes `BRAINSTORM.md` + `research/`)
+- `orchestration_status.json` + `EXECUTION_LOG.md`
+- Roadmap and architecture context display (if exists)
 
 ## 🔗 Related Commands
 

package/docs/commands/flow-init.zh-CN.md

@@ -43,6 +43,9 @@ Stage 1: 前置条件验证
   ├─ 检查 devflow/ 目录
   └─ 验证 REQ-ID 唯一性
   ↓
+Stage 1.2: Git 分支创建
+  └─ 创建 feature/REQ-XXX-english-slug 分支（标题英文意译，非拼音）
+  ↓
 Stage 1.5: 路线图与架构上下文加载（NEW）
   ├─ 检查 ROADMAP.md 存在性
   ├─ 定位需求在路线图中的位置
@@ -57,17 +60,19 @@ Stage 1.5: 路线图与架构上下文加载（NEW）
   ↓
 Stage 2: 目录结构创建
   ├─ 创建 devflow/requirements/REQ-123/
-  ├─ 创建子目录 tasks/, research/
+  ├─ 创建子目录 research/
   ├─ 初始化 orchestration_status.json
   └─ 初始化 EXECUTION_LOG.md
   ↓
-Stage 2.6: 调研任务分派与决策整合（FIXED）
-  ├─ 生成研究任务 (generate-research-tasks.sh)
-  ├─ 填充研究决策 (populate-research-tasks.sh)
-  └─ 整合研究结论 (consolidate-research.sh)
+Stage 2.3: 头脑风暴（skill）
+  └─ 生成 devflow/requirements/REQ-XXX/BRAINSTORM.md 作为需求「北极星」
   ↓
-Stage 3: Git 分支创建
-  └─ 创建 feature/REQ-123-user-auth 分支（标题英文意译，非拼音）
+Stage 2.5: 调研（subagent，默认必跑，上下文隔离）
+  ├─ 内部代码库调研 → research/internal/codebase-overview.md
+  ├─ 外部资料落盘 → research/mcp/YYYYMMDD/**
+  ├─ 决策摘要 → research/research-summary.md
+  ├─ 任务回填 → research/tasks.json（decision/rationale/alternatives 完整）
+  └─ 研究整合 → research/research.md（通过校验，无 TODO/PLACEHOLDER）
 ```
 
 ## 💡 示例
@@ -129,7 +134,6 @@ Stage 3: Git 分支创建
 devflow/requirements/REQ-123/
 ├── orchestration_status.json    # 状态管理
 ├── EXECUTION_LOG.md             # 审计轨迹
-├── tasks/                       # 任务产物目录
 ├── research/                    # 研究材料目录
 └── (等待后续阶段生成其他文档)
 ```

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "cc-devflow",
-    "version": "2.4.5",
+    "version": "2.4.6",
     "description": "DevFlow CLI tool",
     "main": "bin/cc-devflow.js",
     "bin": {
@@ -47,4 +47,4 @@
     "engines": {
         "node": ">=18"
     }
-}
+}

package/.claude/tsc-cache/6e64f818-6398-49ca-8623-581a9af85c44/edited-files.log

@@ -1 +0,0 @@
-1766046071	Edit	/Users/dimon/001Area/80-CodeWorld/002-devflow/cc-devflow/package.json	root

package/.claude/tsc-cache/748c64fa-9e5f-4a1d-9db8-efb8415a6183/affected-repos.txt

@@ -1 +0,0 @@
-root

package/.claude/tsc-cache/748c64fa-9e5f-4a1d-9db8-efb8415a6183/edited-files.log

@@ -1 +0,0 @@
-1768013595	Edit	/Users/dimon/001Area/80-CodeWorld/002-devflow/cc-devflow/package.json	root

package/.claude/tsc-cache/777aa1de-497e-411b-a40f-13b74efcec58/edited-files.log

@@ -1,2 +0,0 @@
-1766298649	Edit	/Users/dimon/001Area/80-CodeWorld/002-devflow/cc-devflow/package.json	root
-1766298660	Edit	/Users/dimon/001Area/80-CodeWorld/002-devflow/cc-devflow/package.json	root

package/.claude/tsc-cache/795ba6e3-b98a-423b-bab2-51aa62812569/edited-files.log

@@ -1 +0,0 @@
-1766132827	Edit	/Users/dimon/001Area/80-CodeWorld/002-devflow/cc-devflow/package.json	root

package/.claude/tsc-cache/ae335694-be5a-4ba4-a1a0-b676c09a7906/edited-files.log

@@ -1 +0,0 @@
-1766112103	Edit	/Users/dimon/001Area/80-CodeWorld/002-devflow/cc-devflow/.gitignore	root

package/.claude/tsc-cache/f903e5df-3c39-4958-b26b-724808f32956/affected-repos.txt

@@ -1 +0,0 @@
-root

package/.claude/tsc-cache/f903e5df-3c39-4958-b26b-724808f32956/edited-files.log

@@ -1,2 +0,0 @@
-1768012783	Edit	/Users/dimon/001Area/80-CodeWorld/002-devflow/cc-devflow/package.json	root
-1768012988	Edit	/Users/dimon/001Area/80-CodeWorld/002-devflow/cc-devflow/.gitignore	root