6a-spec-install 1.0.9-dev.0 → 1.0.9-dev.1

package/.6aspec/rules/brown/brown_constitution.md

@@ -1,104 +1,20 @@
 # 棕地需求工作流总纲（Brown Field Constitution）
 
-## 核心原则
+本文件定义适用于**所有阶段**的全局规则，当与具体 SOP 冲突时以本文件为准。各阶段的具体流程、产出模板、防护措施见对应的 SOP 文件。
 
-### 语言要求
-**重要：所有生成的文档内容必须使用中文，包括标题、字段名、描述等所有文本内容。**
+## 语言要求
 
-### 设计哲学
-棕地需求工作流（6aspec:brown）专门为**复杂业务系统的变更需求**（从1→100）设计，核心理念：**影响面优先 + 分层渐进 + 风险控制**。
+**所有生成的文档内容必须使用中文**，包括标题、字段名、描述等所有文本内容。
 
-### 六大设计原则
+## 核心行为规则
 
-| 原则 | 说明 |
-|------|------|
-| **影响面优先** | 不仅关注"要做什么"，更关注"会影响什么" |
-| **分层渐进** | 根据需求复杂度选择合适的分析深度 |
-| **人工校准** | 每个阶段结束都有人工检查点 |
-| **风险控制** | 通过深入分析降低实施风险 |
-| **知识沉淀** | 持续积累团队经验和最佳实践 |
-| **灵活适配** | 根据需求特点选择流程深度 |
-
-## 流程深度
-
-### 轻量级（Lightweight）
-- **阶段**：proposal → design → tasks → implement
-- **产出**：proposal.md, design.md, tasks.md
-- **适用**：需求明确、快速迭代、小范围变更
-
-### 标准级（Standard）
-- **阶段**：understand → specs → impact → design → tasks → implement
-- **产出**：understanding.md, specs.md, impact-analysis.md, design.md, tasks.md
-- **适用**：复杂业务变更、多表联动、需要风险控制
-
-### 完整级（Complete）
-- **阶段**：understand → specs → impact → design → tasks → implement → verify → review
-- **产出**：understanding.md, specs.md, impact-analysis.md, design.md, tasks.md, verification-report.md, post-implementation-review.md
-- **适用**：关键变更、需要完整追踪和评估
-
-### 快速通道（Quick）
-- **阶段**：直接实现
-- **产出**：requirement.md（最小化）
-- **适用**：Bug修复、文案调整、单文件改动
-
-## 目录结构约定
-
-```
-6aspecdoc/brown/
-├── <需求名称>/
-│   ├── status.json                    # 需求状态
-│   ├── requirement.md                 # 需求索引页
-│   ├── artifacts/                     # 各阶段产出文档
-│   │   ├── proposal.md               # 轻量级：需求提案
-│   │   ├── 01-understanding.md       # 标准级/完整级：需求理解
-│   │   ├── 01.5-specs.md             # 标准级/完整级：需求规格
-│   │   ├── 02-impact-analysis.md     # 标准级/完整级：影响面分析
-│   │   ├── 03-technical-design.md    # 所有流程：技术方案
-│   │   ├── 04-tasks-overview.md      # 所有流程：任务拆解
-│   │   ├── 05-verification-report.md # 完整级：验证报告
-│   │   ├── 06-post-implementation-review.md # 完整级：实施后评估
-│   │   └── ADR-<name>.md             # P0需求：架构决策记录
-│   └── tasks/                         # 任务详情
-│       ├── TASK-001.md
-│       └── ...
-└── .archived/                         # 归档的需求
-    └── <timestamp>-<需求名称>/
-```
-
-## 状态管理约定
-
-### status.json 基本结构
-
-```json
-{
-  "name": "<name>",
-  "flowDepth": "lightweight|standard|complete|quick",
-  "status": "<current_phase>_pending",
-  "createdAt": "<timestamp>",
-  "lastModified": "<timestamp>",
-  "phases": {},
-  "artifacts": []
-}
-```
-
-### 阶段状态值
-- `pending` - 待执行（当前阶段）
-- `done` - 已完成
-- `blocked` - 阻塞（前置阶段未完成）
-
-## 通用防护规则
-
-1. **阶段化推进**：每个阶段完成后必须停止，等待用户确认，不要自动进入下一阶段
-2. **前置检查**：每个阶段开始前必须检查前置阶段是否完成
-3. **状态一致性**：每个阶段完成后必须更新 status.json
-4. **不猜测**：如果信息不明确，必须询问用户，不要猜测
-5. **Mermaid 图表**：图表中避免使用双引号和 emoji
-6. **需求命名**：使用 kebab-case 格式（例如：add-user-auth）
-
-## 命令调用格式
-
-所有命令通过 `/6aspec:brown:<command>` 格式调用：
-- `/6aspec:brown:new` - 开始新需求
-- `/6aspec:brown:continue` - 继续下一阶段
-- `/6aspec:brown:status` - 查看状态
-- 其他命令详见各 SOP 文件
+1. **阶段化推进**：每个阶段完成后必须停止，等待用户通过显式命令推进
+2. **阶段切换纪律**（最重要的规则）：
+   - **只有显式命令才能触发阶段切换**：必须通过 `/6aspec:brown:continue` 或具体的阶段命令（如 `/6aspec:brown:specs`）才能进入下一阶段
+   - **用户的普通回复不是阶段切换信号**：回答问题、补充信息、讨论 — 这些都属于当前阶段的交互
+   - **收到用户补充信息时的正确行为**：更新当前阶段文档 → 展示变更摘要 → 再次提示可继续补充或用命令推进
+3. **前置检查**：每个阶段开始前必须检查前置阶段是否完成
+4. **状态一致性**：每个阶段完成后必须更新 status.json
+5. **不猜测**：信息不明确时必须询问用户，不要假设
+6. **Mermaid 图表**：避免使用双引号和 emoji
+7. **需求命名**：使用 kebab-case 格式（例如：`add-user-auth`）

package/.6aspec/rules/brown/brown_design_sop.md

@@ -135,10 +135,19 @@ Phase 3: 技术方案设计
 - 6aspecdoc/brown/<name>/artifacts/ADR-<name>.md (P0)
 
 ### 下一步
-- 运行 `/6aspec:brown:tasks` 进行任务拆解
-- 或运行 `/6aspec:brown:continue` 自动进入下一阶段
+- 直接回复修正设计方案或补充细节 → 我会更新本阶段文档（03-technical-design.md）
+- 运行 `/6aspec:brown:tasks` → 进入任务拆解阶段
+- 运行 `/6aspec:brown:continue` → 自动进入下一阶段
 ```
 
+**用户补充信息时的处理**
+
+当用户修正设计方案、补充技术细节、或对设计决策提出异议时（未使用阶段命令）：
+1. 将用户的修正/补充整合到 `03-technical-design.md` 的对应章节
+2. 展示变更摘要
+3. 再次提示：可以继续补充，或通过命令进入下一阶段
+4. **禁止**：不得自动进入下一阶段
+
 **防护措施**
 - 必须先完成 Phase 2
 - P0 需求必须创建 ADR

package/.6aspec/rules/brown/brown_impact_sop.md

@@ -245,7 +245,7 @@ Phase 2: 影响面分析与非功能需求评估
    }
    ```
 
-9. **停止并等待用户确认**
+9. **停止并等待用户指令**
 
 **输出**
 
@@ -274,10 +274,19 @@ Phase 2: 影响面分析与非功能需求评估
 6aspecdoc/brown/<name>/artifacts/02-impact-analysis.md
 
 ### 下一步
-- 运行 `/6aspec:brown:design` 进行技术方案设计
-- 或运行 `/6aspec:brown:continue` 自动进入下一阶段
+- 直接回复补充遗漏的影响点或修正分析 → 我会更新本阶段文档（02-impact-analysis.md）
+- 运行 `/6aspec:brown:design` → 进入技术方案设计阶段
+- 运行 `/6aspec:brown:continue` → 自动进入下一阶段
 ```
 
+**用户补充信息时的处理**
+
+当用户指出遗漏的影响点、修正分析结论、或补充业务规则时（未使用阶段命令）：
+1. 将用户的补充整合到 `02-impact-analysis.md` 的对应章节
+2. 展示变更摘要
+3. 再次提示：可以继续补充，或通过命令进入下一阶段
+4. **禁止**：不得自动进入下一阶段
+
 **防护措施**
 - 必须先完成 Phase 1 才能执行 Phase 2
 - 必须获得关键业务规则的答案

package/.6aspec/rules/brown/brown_implement_sop.md

@@ -130,4 +130,4 @@
 - 如果实现发现设计问题，暂停并建议更新 artifacts
 - 保持代码变更最小化和聚焦
 - 立即更新任务状态
-- 遇到错误时暂停，不要猜测
+- 遇到错误时暂停并报告

package/.6aspec/rules/brown/brown_new_sop.md

@@ -2,16 +2,25 @@
 
 开始一个新的需求分析流程。
 
-**输入**：`/6aspec:brown:new` 后的参数是需求名称（kebab-case）或需求描述。
+**输入**：`/6aspec:brown:new` 后的参数支持三种形式：
+- **需求名称**：kebab-case 名称（例如：`add-user-auth`）
+- **需求描述**：直接的文字描述（例如："在项目中添加用户认证功能"）
+- **文件引用**：通过 @文件路径 引用需求文档（例如：`@docs/prd-user-auth.md`）
 
 **步骤**
 
-1. **如果没有提供输入，询问需求内容**
+1. **获取需求内容并识别输入类型**
 
-   询问用户（开放式问题）：
-   > "你想分析什么需求？请描述要实现的功能或要解决的问题。"
+   根据用户输入判断类型：
 
-   从描述中提取 kebab-case 名称（例如："添加用户认证" → `add-user-auth`）。
+   **情况A：无输入** — 询问用户（开放式问题）：
+   > "你想分析什么需求？请描述要实现的功能或要解决的问题，也可以 @引用 一个需求文档。"
+
+   **情况B：直接文字描述** — 记录原始描述文本，标记 `inputSource.type = "text"`。
+
+   **情况C：文件引用（@文件路径）** — 读取文件确认存在且内容相关，标记 `inputSource.type = "file"`，记录文件路径。
+
+   从描述/文件内容中提取 kebab-case 名称（例如："添加用户认证" → `add-user-auth`）。
 
    **重要**：必须理解用户想做什么才能继续。
 
@@ -74,6 +83,10 @@
      "status": "proposal_pending",
      "createdAt": "<timestamp>",
      "lastModified": "<timestamp>",
+     "inputSource": {
+       "type": "text | file",
+       "filePath": "<仅 type=file 时填写>"
+     },
      "phases": {
        "proposal": "pending",
        "design": "blocked",
@@ -92,6 +105,10 @@
      "status": "understanding_pending",
      "createdAt": "<timestamp>",
      "lastModified": "<timestamp>",
+     "inputSource": {
+       "type": "text | file",
+       "filePath": "<仅 type=file 时填写>"
+     },
      "phases": {
        "understand": "pending",
        "specs": "blocked",
@@ -112,6 +129,10 @@
      "status": "understanding_pending",
      "createdAt": "<timestamp>",
      "lastModified": "<timestamp>",
+     "inputSource": {
+       "type": "text | file",
+       "filePath": "<仅 type=file 时填写>"
+     },
      "phases": {
        "understand": "pending",
        "specs": "blocked",
@@ -126,7 +147,7 @@
    }
    ```
 
-   创建需求索引文件 `6aspecdoc/brown/<name>/requirement.md`（方案B：简化为索引页）：
+   创建需求索引文件 `6aspecdoc/brown/<name>/requirement.md`：
    ```markdown
    # <需求标题>
 
@@ -136,6 +157,18 @@
    > **创建时间**: <timestamp>
    > **最后修改**: <timestamp>
 
+   ## 原始需求
+
+   <!-- 根据输入类型选择以下其一 -->
+
+   <!-- 情况A：直接文字描述（inputSource.type = "text"） -->
+   <用户输入的原始需求描述，原文记录，不做加工>
+
+   <!-- 情况B：文件引用（inputSource.type = "file"） -->
+   > **需求来源文件**：`<文件路径>`
+   >
+   > 完整需求内容请参考上述文件。
+
    ## 快速导航
 
    **需求详情**：
@@ -177,10 +210,6 @@
    ## 查看详细信息
 
    运行 `/6aspec:brown:status <name>` 查看完整状态和所有文档。
-
-   ---
-
-   **说明**：本文件是需求的索引页，只包含元信息和导航链接。需求的详细内容在第一个 artifact 中（proposal.md 或 understanding.md）。
    ```
 
    **快速通道**：

package/.6aspec/rules/brown/brown_proposal_sop.md

@@ -16,8 +16,11 @@
 
 2. **收集需求信息**
 
-   如果用户在对话中已提供需求信息，直接使用。
-   否则，询问用户：
+   首先读取 `6aspecdoc/brown/<name>/requirement.md` 中的"原始需求"部分：
+   - 如果 `inputSource.type = "text"`：直接使用其中记录的需求描述。
+   - 如果 `inputSource.type = "file"`：读取记录的来源文件路径，获取完整需求内容。
+
+   如果原始需求信息不足以生成提案，再询问用户补充：
    - 为什么需要这个变更？（Why）
    - 要做什么？（What）
    - 预期影响是什么？（Impact）
@@ -115,7 +118,7 @@
    }
    ```
 
-5. **停止并等待用户确认**
+5. **停止并等待用户指令**
 
 **输出**
 
@@ -137,10 +140,19 @@
 6aspecdoc/brown/<name>/artifacts/proposal.md
 
 ### 下一步
-- 运行 `/6aspec:brown:design` 进行技术方案设计
-- 或运行 `/6aspec:brown:continue` 自动进入下一阶段
+- 直接回复补充或修正提案内容 → 我会更新本阶段文档（proposal.md）
+- 运行 `/6aspec:brown:design` → 进入技术方案设计阶段
+- 运行 `/6aspec:brown:continue` → 自动进入下一阶段
 ```
 
+**用户补充信息时的处理**
+
+当用户补充需求细节、修正提案内容时（未使用阶段命令）：
+1. 将用户的补充整合到 `proposal.md` 的对应章节
+2. 展示变更摘要
+3. 再次提示：可以继续补充，或通过命令进入下一阶段
+4. **禁止**：不得自动进入下一阶段
+
 **防护措施**
 - 仅适用于轻量级流程
 - 如果需求信息不明确，必须询问用户

package/.6aspec/rules/brown/brown_specs_sop.md

@@ -207,13 +207,21 @@ Phase 1.5: 需求规格定义
 6aspecdoc/brown/<name>/artifacts/01.5-specs.md
 
 ### 下一步
-- 运行 `/6aspec:brown:impact` 进行影响面分析
-- 或运行 `/6aspec:brown:continue` 自动进入下一阶段
+- 直接回复补充或修正需求规格 → 我会更新本阶段文档（01.5-specs.md）
+- 运行 `/6aspec:brown:impact` → 进入影响面分析阶段
+- 运行 `/6aspec:brown:continue` → 自动进入下一阶段
 ```
 
+**用户补充信息时的处理**
+
+当用户补充需求细节、修正功能需求、或回答问题时（未使用阶段命令）：
+1. 将用户的补充整合到 `01.5-specs.md` 的对应章节（功能需求、非功能需求、验收标准等）
+2. 展示变更摘要
+3. 再次提示：可以继续补充，或通过命令进入下一阶段
+4. **禁止**：不得自动进入下一阶段
+
 **防护措施**
 - 必须先完成 Phase 1（understand）
 - 只适用于标准级和完整级流程
 - 功能需求必须从用户视角描述，避免技术实现细节
 - 验收标准必须具体、可验证
-- 如果问题答案不明确，必须询问用户，不要猜测

package/.6aspec/rules/brown/brown_understand_sop.md

@@ -23,7 +23,9 @@ Phase 1: 需求理解与现状分析
 
 3. **读取需求描述**
 
-   读取 `6aspecdoc/brown/<name>/requirement.md` 了解需求背景。
+   读取 `6aspecdoc/brown/<name>/status.json` 中的 `inputSource` 字段判断输入类型：
+   - `type = "text"`：读取 `requirement.md` 中的"原始需求"部分获取需求描述。
+   - `type = "file"`：读取 `requirement.md` 中记录的来源文件路径，然后读取该文件获取完整需求内容。
 
 4. **分析现有系统**
 
@@ -161,7 +163,7 @@ Phase 1: 需求理解与现状分析
    }
    ```
 
-8. **停止并等待用户确认**
+8. **停止并等待用户指令**
 
 **输出**
 
@@ -188,15 +190,22 @@ Phase 1: 需求理解与现状分析
 6aspecdoc/brown/<name>/artifacts/01-understanding.md
 
 ### 下一步
-请回答待明确问题清单中的问题，然后：
-- 运行 `/6aspec:brown:specs` 定义需求规格
-- 或运行 `/6aspec:brown:continue` 自动进入下一阶段
+- 直接回答上述待明确问题 → 我会更新本阶段文档（01-understanding.md）
+- 运行 `/6aspec:brown:specs` → 进入需求规格定义阶段
+- 运行 `/6aspec:brown:continue` → 自动进入下一阶段
 ```
 
+**用户补充信息时的处理**
+
+当用户回答待明确问题或补充需求信息时（未使用阶段命令）：
+1. 将用户的回答整合到 `01-understanding.md` 中对应的问题项（将"[待确认]"替换为实际答案）
+2. 如果回答引发新的发现或问题，同步更新文档的相关章节
+3. 展示变更摘要（更新了哪些问题的答案、新增了哪些发现）
+4. 再次提示：可以继续补充，或通过命令进入下一阶段
+5. **禁止**：不得自动进入下一阶段
+
 **防护措施**
 - 必须先读取需求描述再开始分析
 - 如果找不到相关代码，询问用户提供更多关键词
-- 图表中避免使用双引号和 emoji
 - 如果分析不充分，不要强行生成文档，而是询问用户
 - 待明确问题必须具体，避免模糊问题
-- 每个阶段完成后必须停止，不要自动进入下一阶段

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "6a-spec-install",
-  "version": "1.0.9-dev.0",
+  "version": "1.0.9-dev.1",
   "description": "6A-spec 驱动开发提示词安装工具，支持 Cursor 和 Claude",
   "main": "lib/installer.js",
   "bin": {