ironweave 1.1.0 → 1.1.2

package/AGENTS.md

@@ -15,7 +15,7 @@ For any development task, start by reading the orchestrator skill. It will guide
 
 All skills are in `skills/`. Each has a `SKILL.md` with YAML frontmatter (`name`, `description`).
 
-Key skills: `orchestrator`, `requirement-qa`, `brainstorm`, `spec-writing`, `tech-stack`, `engineering-principles`, `api-contract-design`, `code-scaffold`, `error-handling-strategy`, `performance-arch-design`, `observability-design`, `integration-test-design`, `implementation-complexity-analysis`, `task-difficulty`, `project-context`, `docs-output`, `skill-creator`.
+Key skills: `orchestrator`, `requirement-qa`, `brainstorm`, `spec-writing`, `tech-stack`, `engineering-principles`, `api-contract-design`, `code-scaffold`, `error-handling-strategy`, `performance-arch-design`, `observability-design`, `integration-test-design`, `implementation-complexity-analysis`, `task-difficulty`, `project-context`, `docs-output`.
 
 ## Contributing
 

package/CLAUDE.md

@@ -15,7 +15,7 @@ For any development task, start by reading the orchestrator skill. It will guide
 
 All skills are in `skills/`. Each has a `SKILL.md` with YAML frontmatter (`name`, `description`).
 
-Key skills: `orchestrator`, `requirement-qa`, `brainstorm`, `spec-writing`, `tech-stack`, `engineering-principles`, `api-contract-design`, `code-scaffold`, `error-handling-strategy`, `performance-arch-design`, `observability-design`, `integration-test-design`, `implementation-complexity-analysis`, `task-difficulty`, `project-context`, `docs-output`, `skill-creator`.
+Key skills: `orchestrator`, `requirement-qa`, `brainstorm`, `spec-writing`, `tech-stack`, `engineering-principles`, `api-contract-design`, `code-scaffold`, `error-handling-strategy`, `performance-arch-design`, `observability-design`, `integration-test-design`, `implementation-complexity-analysis`, `task-difficulty`, `project-context`, `docs-output`.
 
 ## Contributing
 

package/README.md

@@ -95,16 +95,18 @@ User Request
 - `task-difficulty` — Multi-dimensional difficulty scoring (1-10)
 - `project-context` — Project structure awareness & cross-session persistence
 - `docs-output` — Document output management (modular docs/ organization)
-- `skill-creator` — Create, modify, and evaluate agent skills
 
 ## Installation
 
 ### Via skills.sh (Recommended)
 
 ```bash
-# Install all skills
+# Install all skills (Chinese, default)
 npx skills add YuluoY/ironware
 
+# Install English skills
+npx skills add YuluoY/ironware --lang en
+
 # Install specific skills
 npx skills add YuluoY/ironware --skill orchestrator --skill brainstorm
 
@@ -112,6 +114,16 @@ npx skills add YuluoY/ironware --skill orchestrator --skill brainstorm
 npx skills add YuluoY/ironware --list
 ```
 
+Or via npm:
+
+```bash
+# Install with Chinese skills (default)
+npx ironweave init
+
+# Install with English skills
+npx ironweave init --lang en
+```
+
 Supports **40+ agents**: Claude Code, GitHub Copilot, Cursor, Codex, Windsurf, Cline, OpenCode, Gemini CLI, Trae, CodeBuddy, and more.
 
 ### Per-Agent Manual Installation
@@ -206,7 +218,7 @@ Copy the `skills/` directory into your project. Then add the following to your a
 
 ```
 ironweave/
-├── skills/
+├── skills/                          # Skills (Chinese)
 │   ├── orchestrator/              # Flow orchestrator
 │   │   ├── SKILL.md              # Orchestrator logic
 │   │   └── references/           # Methodology docs
@@ -214,7 +226,8 @@ ironweave/
 │   ├── spec-writing/
 │   ├── code-scaffold/
 │   ├── ...                        # 16 more skills
-│   └── skill-creator/
+│   └── docs-output/
+├── skills-en/                       # Skills (English)
 ├── CLAUDE.md                      # Claude Code instructions
 ├── AGENTS.md                      # Codex instructions
 ├── GEMINI.md                      # Gemini CLI instructions
@@ -243,7 +256,7 @@ ironweave/
 
 ## Contributing
 
-See [CONTRIBUTING.md](./CONTRIBUTING.md). Skills live directly in this repository. Follow `skills/skill-creator` for creating and testing new skills.
+See [CONTRIBUTING.md](./CONTRIBUTING.md). Skills live directly in this repository.
 
 ## License
 

package/README_CN.md

@@ -93,16 +93,18 @@ Ironweave 是一套完整的软件开发工作流，由一组可自由组合的
 - `task-difficulty` — 多维度难度评分（1-10）
 - `project-context` — 项目结构感知与跨会话持久化
 - `docs-output` — 文档产出管理（模块化 docs/ 组织）
-- `skill-creator` — 创建、修改、评测 Agent Skills
 
 ## 安装
 
 ### 通过 skills.sh（推荐）
 
 ```bash
-# 安装全部技能
+# 安装全部技能（中文，默认）
 npx skills add YuluoY/ironware
 
+# 安装英文版技能
+npx skills add YuluoY/ironware --lang en
+
 # 安装指定技能
 npx skills add YuluoY/ironware --skill orchestrator --skill brainstorm
 
@@ -110,6 +112,16 @@ npx skills add YuluoY/ironware --skill orchestrator --skill brainstorm
 npx skills add YuluoY/ironware --list
 ```
 
+或通过 npm 安装：
+
+```bash
+# 安装中文技能（默认）
+npx ironweave init
+
+# 安装英文版技能
+npx ironweave init --lang en
+```
+
 支持 **40+ 个 Agent**：Claude Code、GitHub Copilot、Cursor、Codex、Windsurf、Cline、OpenCode、Gemini CLI、Trae、CodeBuddy 等。
 
 ### 各 Agent 手动安装
@@ -204,7 +216,7 @@ git clone https://github.com/YuluoY/ironware.git
 
 ```
 ironweave/
-├── skills/
+├── skills/                          # 技能（中文）
 │   ├── orchestrator/              # 流程编排器
 │   │   ├── SKILL.md              # 编排器逻辑
 │   │   └── references/           # 方法论文档
@@ -212,7 +224,8 @@ ironweave/
 │   ├── spec-writing/
 │   ├── code-scaffold/
 │   ├── ...                        # 另外 16 个技能
-│   └── skill-creator/
+│   └── docs-output/
+├── skills-en/                       # 技能（英文）
 ├── CLAUDE.md                      # Claude Code 指令
 ├── AGENTS.md                      # Codex 指令
 ├── GEMINI.md                      # Gemini CLI 指令
@@ -241,7 +254,7 @@ ironweave/
 
 ## 贡献
 
-请参阅 [CONTRIBUTING.md](./CONTRIBUTING.md)。技能直接存放在本仓库中。创建和测试新技能请参考 `skills/skill-creator`。
+请参阅 [CONTRIBUTING.md](./CONTRIBUTING.md)。技能直接存放在本仓库中。
 
 ## 许可证
 

package/bin/cli.js

@@ -18,6 +18,7 @@ Options:
   --agent <name>    Only install config for specific agent
                     (claude, copilot, cursor, windsurf, cline, codex, gemini, all)
                     Default: all
+  --lang <lang>     Language for skills: zh (Chinese, default) or en (English)
   --skills-only     Only copy skills/, skip agent config files
   --force           Overwrite existing files (default: skip existing)
   --help            Show this help message
@@ -26,11 +27,14 @@ Options:
 }
 
 if (command === 'list') {
-  const skillsDir = path.join(__dirname, '..', 'skills');
+  const langIdx = args.indexOf('--lang');
+  const listLang = langIdx !== -1 ? args[langIdx + 1] : 'zh';
+  const skillsSrc = listLang === 'en' ? 'skills-en' : 'skills';
+  const skillsDir = path.join(__dirname, '..', skillsSrc);
   const skills = fs.readdirSync(skillsDir).filter(f => {
     return fs.statSync(path.join(skillsDir, f)).isDirectory();
   });
-  console.log(`\nIronweave Skills (${skills.length}):\n`);
+  console.log(`\nIronweave Skills [${listLang}] (${skills.length}):\n`);
   skills.forEach(s => console.log(`  - ${s}`));
   console.log('');
   process.exit(0);
@@ -42,14 +46,17 @@ if (command === 'init') {
 
   const agentFlag = args.indexOf('--agent');
   const agent = agentFlag !== -1 ? args[agentFlag + 1] : 'all';
+  const langFlag = args.indexOf('--lang');
+  const lang = langFlag !== -1 ? args[langFlag + 1] : 'zh';
   const skillsOnly = args.includes('--skills-only');
   const force = args.includes('--force');
 
   // Copy skills/ and hooks/
-  const srcSkills = path.join(pkgDir, 'skills');
+  const skillsSrc = lang === 'en' ? 'skills-en' : 'skills';
+  const srcSkills = path.join(pkgDir, skillsSrc);
   const dstSkills = path.join(targetDir, 'skills');
   copyDirRecursive(srcSkills, dstSkills, force);
-  console.log('✓ skills/ copied');
+  console.log(`✓ skills/ copied (${lang === 'en' ? 'English' : 'Chinese'})`);
 
   const srcHooks = path.join(pkgDir, 'hooks');
   const dstHooks = path.join(targetDir, 'hooks');

package/hooks/session-start

@@ -22,7 +22,7 @@ escape_for_json() {
 }
 
 orchestrator_escaped=$(escape_for_json "$orchestrator_content")
-session_context="<IMPORTANT>\nYou have Ironweave skills.\n\nIronweave is a complete software development workflow with built-in quality gates. The orchestrator skill is your main entry point — it auto-senses context, scores difficulty, selects the right route, and runs Plan > Execute > Validate > Deliver.\n\nAll skills are in the skills/ directory, each with a SKILL.md. For any development task, start by reading skills/orchestrator/SKILL.md.\n\nKey skills: orchestrator, requirement-qa, brainstorm, spec-writing, tech-stack, engineering-principles, api-contract-design, code-scaffold, error-handling-strategy, performance-arch-design, observability-design, integration-test-design, implementation-complexity-analysis, task-difficulty, project-context, docs-output, skill-creator.\n</IMPORTANT>"
+session_context="<IMPORTANT>\nYou have Ironweave skills.\n\nIronweave is a complete software development workflow with built-in quality gates. The orchestrator skill is your main entry point — it auto-senses context, scores difficulty, selects the right route, and runs Plan > Execute > Validate > Deliver.\n\nAll skills are in the skills/ directory, each with a SKILL.md. For any development task, start by reading skills/orchestrator/SKILL.md.\n\nKey skills: orchestrator, requirement-qa, brainstorm, spec-writing, tech-stack, engineering-principles, api-contract-design, code-scaffold, error-handling-strategy, performance-arch-design, observability-design, integration-test-design, implementation-complexity-analysis, task-difficulty, project-context, docs-output.\n</IMPORTANT>"
 
 # Output context injection as JSON.
 # Cursor hooks expect additional_context (snake_case).

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "ironweave",
-  "version": "1.1.0",
+  "version": "1.1.2",
   "description": "Agentic skills framework for AI coding agents — orchestrated workflows with adaptive routing, quality gates, and 17 composable skills.",
   "keywords": [
     "agent-skills",
@@ -32,6 +32,7 @@
   },
   "files": [
     "skills/",
+    "skills-en/",
     "hooks/",
     "bin/",
     "CLAUDE.md",

package/skills/requirement-qa/SKILL.md

@@ -1,27 +1,61 @@
 ---
 name: requirement-qa
 description: >-
-  通过多轮 QA 对话引导用户逐步明确需求或技术选型决策。采用“发散→收敛”模式：先开放提问扩展需求边界，再定向追问收敛到可落地的结论。最终输出结构化的需求摘要或技术决策摘要。
+  通过"方向定调 → 增量产出 → 用户 Review → 确认修正"的循环，帮助用户从模糊想法走向完整需求。不同于纯问答模式，本 skill 每轮都产出可 Review 的文档片段到 docs/01-requirement/，用户只需判断"对不对"而非从零表达需求。
   务必在以下场景使用本 skill：用户的需求描述模糊或不完整（如"我想做一个 XX 系统"）、用户不确定技术方案该怎么选、用户要求进行需求分析、需求调研、需求访谈、需求梳理、需求沟通、技术方案讨论、架构讨论，或者用户说"帮我想想还缺什么"、"帮我理一下需求"、"我们聊聊这个项目"。当输入信息不足以直接输出完整文档时，应先进入本 skill 的 QA 流程，而不是凭猜测交付半成品。
 ---
 
 # 需求引导对话（Requirement QA）
 
-本 Skill 通过结构化的多轮对话，帮助用户从模糊想法走向明确、完整、可落地的需求描述或技术决策。它解决的核心问题是：用户脑中有需求，但表达出来的往往只是冰山一角——本 skill 的目标是把水面下的部分也挖出来。
+本 Skill 通过**增量产出 + 用户 Review** 的循环，帮助用户从模糊想法走向明确、完整、可落地的需求描述。
 
-## 核心方法论：发散→收敛
+**核心理念**：用户不需要"说清楚需求"，只需要判断"Agent 产出的内容对不对"。把信息质量的压力从用户转移到 Agent，用户的角色从"回答者"变成"审核者"。
 
-每个话题都经历两个阶段：
+## 产出目标
 
-1. **发散阶段**：开放式提问，探索可能性边界
-   - "还有哪些用户角色会用到这个功能？"
-   - "如果不做这个限制，会发生什么？"
-   - "有没有类似的产品可以参考？"
+每轮 QA 循环直接产出或更新 `docs/01-requirement/` 下的模块化文件：
 
-2. **收敛阶段**：定向追问，锁定具体决策
-   - "在这三个方案中，你倾向哪个？为什么？"
-   - "这个功能的优先级是 P0 还是可以后做？"
-   - "我理解你的意思是 X，对吗？"
+```
+docs/01-requirement/
+├── project-profile.md      ← 项目画像（定位、用户、目标）
+├── feature-scope.md        ← 功能范围（功能列表 + MoSCoW 优先级）
+├── business-rules.md       ← 业务规则（核心规则 + 边界条件）
+├── non-functional.md       ← 非功能要求（性能、安全、合规）
+└── tech-constraints.md     ← 技术约束（技术栈、部署、集成）
+```
+
+这些文件是 `spec-writing` 等后续 skill 的输入。requirement-qa 解决 **What**（做什么），spec-writing 解决 **How**（怎么做到）。
+
+## 核心循环：产出 → Review → 修正
+
+每个模块的处理都遵循同一个三步循环：
+
+### Step 1：用户定方向
+
+用户给出高层级方向或已有信息，可以很简短：
+- "我想做一个在线教育平台"
+- "给内部团队用的项目管理工具"
+- 甚至只是"帮我想想这个系统还缺什么"
+
+Agent 基于已有信息（用户输入 + 仓库工程事实），推断尽可能多的细节。
+
+### Step 2：Agent 产出 + 推荐选项
+
+Agent 做两件事：
+
+1. **直接产出文档片段**：把能推断的内容写成结构化文档，创建或更新到 `docs/01-requirement/` 对应文件
+2. **对不确定的点给出推荐选项**：遵循选项规则（2-5 个选项，标记一个推荐项，最后一个为自由输入）
+
+关键：**先产出再提问**。不要空手来问"你想做什么"——先基于已知信息写一版草稿，再针对草稿中不确定的点提问。
+
+### Step 3：用户 Review + 确认
+
+用户看到的是一个**可 Review 的文档**，不是一堆问题。用户可以：
+- 确认："对，就是这样"→ Agent 进入下一个模块
+- 标注修正："角色描述不对，应该是 XX"→ Agent 更新文件
+- 补充信息："还有一个场景你漏了"→ Agent 补充到文件
+
+Agent 确认用户 Review 结果后，**原地更新**文件（不删除重建），然后进入下一个模块或更深层的追问。
 
 ## 交互方式：优先使用结构化选项
 
@@ -33,10 +67,15 @@ description: >-
 
 详细的选项设计规则、推荐项标记规则、宿主适配方式见 [references/option-rules.md](references/option-rules.md)。
 
-每轮对话结束时做一次**小结确认**，确保双方理解一致后再进入下一个话题。
-
 ## 提问节奏控制
 
+### 先产出再提问
+
+每轮的核心产出是**文档片段**，问题只是文档中不确定点的澄清。比起"问 5 个问题等回答"，更好的做法是：
+- 写一版草稿（80% 推断 + 20% 待确认）
+- 在草稿中用 `<!-- 待确认 -->` 或 **加粗标注** 标记不确定点
+- 针对最关键的 1-3 个不确定点提问
+
 ### 按需产生问题
 
 每轮问多少个问题取决于当前实际需要澄清的未知项：
@@ -58,230 +97,145 @@ description: >-
 
 ### 从工程事实出发
 
-如果当前仓库已经是 Vue 3 项目，不要问"你想用 React 还是 Vue？"——先读事实，再问真正未知的东西。
-
-## 状态跟踪
+如果当前仓库已经是 Vue 3 项目，不要问"你想用 React 还是 Vue？"——先读事实，直接写入 tech-constraints.md，再问真正未知的东西。
 
-每轮问答后，内部维护两个状态：
+## 模块推进流程
 
-- **当前理解**（current understanding）：基于本轮问答后，已经稳定成立的理解
-- **草稿产出**（draft output）：如果此刻就要产出，能交付什么雏形
+### 模块 1：项目画像（project-profile.md）
 
-这两个状态的作用是：让后续轮次围绕"还缺什么"推进，而不是每轮都从零理解。每轮小结时可以展示给用户，让用户看到需求在逐步成形。
+**产出内容**：项目定位、目标用户角色及核心诉求、核心痛点、成功标准、时间约束。
 
-## 对话流程
+**Agent 的做法**：
+1. 读取用户输入 + 扫描仓库（README、package.json、已有文档等）
+2. 基于已知信息，**直接写出** `project-profile.md` 草稿
+3. 对不确定的点提问（如目标用户角色、成功标准）
+4. 用户 Review → 更新文件 → 确认后进入下一模块
 
-### 第一轮：项目画像（必问）
+**产出模板**：
 
-目标：建立项目全貌，5-8 个问题以内完成。
-
-**需求方向的核心问题：**
-- 这个产品/功能是给谁用的？（目标用户角色）
-- 它要解决什么问题？（核心痛点）
-- 用户目前是怎么解决这个问题的？（现状与替代方案）
-- 成功的标准是什么？（可量化的业务目标）
-- 项目的时间约束？（MVP 期限、里程碑）
-
-**技术方向的核心问题：**
-- 团队技术栈现状？（已有项目用了什么、团队熟悉什么）
-- 有没有已定的技术约束？（如必须用内网部署、必须兼容 IE）
-- 预期用户规模？（影响架构选择和性能设计）
-- 部署环境？（云 / 私有化 / 混合）
-- 预算和人力限制？
+```markdown
+# 项目画像：{项目名称}
 
-> **提问原则**：每次最多问 3 个问题。问得太多用户会疲劳，信息质量反而下降。根据用户回答的详细程度调整节奏——回答详细就少问，回答简略就多追问。
+## 项目定位
+{一两句话描述这个产品解决什么问题}
 
-### 第二轮：功能边界探索（发散为主）
+## 目标用户
+| 角色 | 核心诉求 | 使用频率 |
+|------|----------|----------|
+| ... | ... | ... |
 
-目标：穷举功能点、用户场景、边界条件。
+## 核心痛点
+- 用户目前怎么解决这个问题
+- 现有方案的主要不满
 
-**提问策略：**
-- **角色维度**：除了主要用户，还有管理员、审计员、第三方系统吗？
-- **场景维度**：正常流程之外，异常情况怎么处理？批量操作？并发场景？
-- **数据维度**：需要哪些数据输入输出？数据量级？数据生命周期？
-- **集成维度**：需要与哪些外部系统对接？认证方式？数据格式？
-- **非功能维度**：性能要求？安全合规要求？可用性要求？
+## 成功标准
+- {可量化的业务目标}
 
-**避免的反模式：**
-- 不要在这一轮就开始讨论实现方案
-- 不要因为某个功能"很难实现"就引导用户放弃——先记录，后面再讨论优先级
-- 不要一次性把所有问题抛出来——根据用户上一轮的回答动态选择下一个问题
+## 时间约束
+- MVP 期限：
+- 关键里程碑：
+```
 
-### 第三轮：优先级与范围收敛
+### 模块 2：功能范围（feature-scope.md）
 
-目标：从发散出的功能列表中，确定 MVP 范围。
+**产出内容**：功能列表（按 MoSCoW 分类），每个功能附简要验收标准。
 
-**收敛策略：**
-- 按 **MoSCoW** 分类（Must / Should / Could / Won't）
-- 对每个 Must 功能追问验收标准："这个功能做到什么程度算 OK？"
-- 对 Won't 功能确认："这个确定本期不做？以后可能做吗？"
-- 标注依赖关系："功能 A 依赖功能 B，所以 B 也得是 Must"
+**Agent 的做法**：
+1. 基于项目画像，**主动推断**可能的功能列表
+2. 写出 `feature-scope.md` 草稿，按 MoSCoW 分类
+3. 提问："以下功能列表是否完整？优先级是否正确？"
+4. 用户 Review → 增删改 → 更新文件
 
-### 第四轮：技术约束收敛（如果涉及技术选型）
+**产出模板**：
 
-目标：确定关键技术决策点。
+```markdown
+# 功能范围：{项目名称}
 
-**收敛策略：**
-- 把前面收集到的约束汇总成对比表
-- 对每个决策点给出 2-3 个选项 + 利弊分析
-- 让用户做选择，记录选择理由
-- 标注"待验证"的技术风险点
+## Must（MVP 必做）
+- [ ] {功能点} — 验收标准：{简述}
+- [ ] ...
 
-### 第五轮：完整性检查与输出
+## Should（重要但可延后）
+- [ ] ...
 
-目标：确认没有遗漏，输出结构化摘要。
+## Could（锦上添花）
+- [ ] ...
 
-**检查清单：**
-- [ ] 所有用户角色已识别
-- [ ] 核心业务流程已明确
-- [ ] 异常和边界场景已讨论
-- [ ] 优先级已排定（MoSCoW）
-- [ ] 验收标准已定义（至少 Must 项）
-- [ ] 技术约束已记录（如有）
-- [ ] 明确"本期不做"的边界
-- [ ] 与外部系统的集成点已识别
+## Won't（明确不做）
+- [ ] ...
 
-## 对话技巧
+## 功能依赖关系
+- {功能 A} 依赖 {功能 B}
+```
 
-### 应对不同类型的用户
+### 模块 3：业务规则（business-rules.md）
 
-- **话多的用户**：适时打断做小结，"让我确认一下我理解对了……"；帮助聚焦到待讨论的问题上
-- **话少的用户**：提供具体选项而非开放式问题，"你需要的是 A 还是 B？"；用是/否问题确认
-- **犹豫不决的用户**：给出推荐方案 + 理由，"根据你描述的场景，我建议先做 X，原因是……"
-- **过于发散的用户**：温和拉回，"这个想法很好，我先记下来。我们先把核心流程确认完？"
+**产出内容**：核心业务规则、边界条件、异常处理策略。
 
-### 小结模板
+**Agent 的做法**：
+1. 从功能范围中提取隐含的业务规则
+2. **主动推断**常见的边界条件和异常场景
+3. 写出 `business-rules.md`，标注哪些是推断的
+4. 用户 Review → 修正/补充 → 更新文件
 
-每完成一个话题的讨论后，用简洁的结构做一次确认：
+### 模块 4：非功能要求（non-functional.md）
 
-```
-【小结确认】
-话题：用户登录
-已确认：
-- 支持手机号+验证码、邮箱+密码两种方式
-- 暂不做第三方登录（微信、GitHub）
-- 登录失败 5 次锁定 30 分钟
-待确认：
-- 验证码有效期（建议 5 分钟，待确认）
-- 是否需要"记住我"功能
-```
+**产出内容**：性能、安全、可用性、合规等要求。
 
-## 输出格式
+**Agent 的做法**：
+1. 根据项目类型和用户规模，**主动推断**合理的非功能指标
+2. 写出 `non-functional.md`，给出推荐值
+3. 提问：重点确认性能指标和安全合规要求
+4. 用户 Review → 更新文件
 
-对话完成后，输出**结构化需求摘要**或**技术决策摘要**。
+### 模块 5：技术约束（tech-constraints.md）（如涉及技术选型）
 
-### 需求摘要模板
+**产出内容**：技术栈、部署环境、集成点、团队约束。
 
-```markdown
-# 需求摘要：[项目/功能名称]
+**Agent 的做法**：
+1. 扫描仓库获取已有技术栈信息
+2. **直接写入**已确定的事实（不问已经能从代码里看到的东西）
+3. 对需要决策的点给出对比表 + 推荐
+4. 用户 Review → 更新文件
 
-## 项目定位
-[一两句话描述]
+## 对话技巧
 
-## 目标用户
-| 角色 | 核心诉求 |
-|------|----------|
-| ... | ... |
-
-## 功能范围（MoSCoW）
-### Must（MVP 必做）
-- [ ] 功能点 + 验收标准简述
-### Should（重要但可延后）
-- [ ] ...
-### Could（锦上添花）
-- [ ] ...
-### Won't（明确不做）
-- [ ] ...
+### 应对不同类型的用户
 
-## 关键业务规则
-- 规则 1
-- 规则 2
+- **话多的用户**：适时做文档更新，让用户看到信息被结构化了；避免信息在聊天中散落
+- **话少的用户**：多产出、少提问；写出更完整的草稿，让用户只需确认"对/不对"
+- **犹豫不决的用户**：给出推荐方案 + 理由，"根据你描述的场景，我建议先做 X，原因是……"
+- **过于发散的用户**：先记录到文档的 Could/Won't 区域，温和拉回核心流程
 
-## 非功能要求
-- 性能：...
-- 安全：...
+### Review 确认模板
 
-## 待确认事项
-- [ ] ...
+每完成一个模块的文档更新后：
 
-## 技术约束（如有）
-- ...
 ```
+已更新 docs/01-requirement/project-profile.md
 
-### 技术决策摘要模板
-
-```markdown
-# 技术决策摘要：[项目名称]
-
-## 项目约束
-- 团队规模：...
-- 时间线：...
-- 部署环境：...
-
-## 已定决策
-| 决策点 | 选择 | 理由 |
-|--------|------|------|
-| ... | ... | ... |
-
-## 待验证风险
-- [ ] ...
+待确认点：
+1. 目标用户是否只有"学生"和"教师"两个角色？
+2. 成功标准中"日活 1000"是否合理？
 
-## 版本约束
-- Node.js: ...
-- pnpm: ...
+请 Review 文件内容，告诉我哪里需要修正。确认后我进入下一模块（功能范围）。
 ```
 
 ## 执行方式
 
 1. **判断进入条件**：用户的输入信息不足以直接输出完整文档时，进入 QA 流程
-2. **按轮次推进**：不需要严格按五轮走，根据实际情况灵活调整；信息够了就提前结束
-3. **每轮小结**：确保双方理解一致后再继续
-4. **适时退出**：当检查清单大部分打勾、用户表示"差不多了"时，输出结构化摘要
-5. **输出摘要**：摘要输出后，提示用户可以用该摘要生成正式文档
+2. **从项目画像开始**：无论信息多少，先产出 project-profile.md 草稿
+3. **按模块推进**：每个模块走"产出 → Review → 修正"循环；信息够了就跳过某些模块
+4. **原地更新**：每次修正都更新同一个文件，不创建新文件
+5. **适时退出**：当所有 Must 模块完成 Review，用户表示满意时，输出完成总结
+6. **衔接后续**：提示用户可以用 `docs/01-requirement/` 的产出进入 spec-writing 生成详细需求文档
 
 ## 完成信号
 
-默认只有以下情况可以结束 QA 并输出摘要：
+默认只有以下情况可以结束 QA：
 - 用户明确说"开始产出""可以写文档了""按这个做"等
-- 检查清单中所有 Must 项已确认
+- project-profile.md 和 feature-scope.md 至少已完成 Review
 
-如果用户说"继续问""先别开始"，优先视为继续澄清。即使用户要求立即结束但信息不完整，在输出摘要中**显式列出假设**。
+如果用户说"继续问""先别开始"，优先视为继续澄清。即使用户要求立即结束但信息不完整，在文档中**显式列出假设**，标注为"未经用户确认，基于推断"。
 
 完整的信号列表和最低结束标准见 [references/completion-signals.md](references/completion-signals.md)。
-
-## 文档持久化
-
-每轮问答应落盘到 Markdown 文件，不依赖模型记忆。使用 `scripts/qa_session.py` 管理会话文档：
-
-```bash
-# 开始新会话
-python3 skills/requirement-qa/scripts/qa_session.py start \
-  --topic "用户登录功能" \
-  --initial-request "我要做一个登录功能"
-
-# 记录每轮问答
-python3 skills/requirement-qa/scripts/qa_session.py append-turn \
-  --doc-path "<doc_path>" \
-  --question "支持哪些登录方式？" \
-  --answer "手机号+验证码、邮箱+密码" \
-  --confirmed "支持手机号+验证码" \
-  --confirmed "支持邮箱+密码" \
-  --open-item "是否需要第三方登录" \
-  --current-understanding "核心登录方式已确认"
-
-# 结束会话
-python3 skills/requirement-qa/scripts/qa_session.py finalize \
-  --doc-path "<doc_path>" \
-  --final-summary "登录功能需求已收敛" \
-  --deliverable "需求摘要文档"
-```
-
-文档存放在 `docs/qa/` 目录下，每个会话一个文件。
-
-## 资源
-
-| 路径 | 说明 |
-|------|------|
-| `references/option-rules.md` | 选项设计规则、推荐项标记规则、宿主适配方式 |
-| `references/completion-signals.md` | 完成信号列表、继续意图保护、最低结束标准 |
-| `scripts/qa_session.py` | QA 会话文档的创建、追加、结束 |