6a-spec-install 1.0.8-dev.0 → 1.0.8-dev.3

package/.6aspec/rules/green/6A_continue_sop.md

@@ -0,0 +1,186 @@
+# 绿地需求自动推进 SOP
+
+## 目标
+
+自动读取当前需求的状态，判断下一步应该执行的命令，并自动执行。
+
+## 前置条件
+
+- 已经通过 `/6aspec:green:init` 初始化了项目（全局执行一次）
+- 存在至少一个需求目录
+
+## 执行步骤
+
+### Step 1: 检测当前需求
+
+**1.1 检查是否在需求目录下**
+
+检查当前工作目录是否在 `6aspecdoc/green/<feature-name>/` 下：
+
+```bash
+pwd
+```
+
+如果在需求目录下，自动识别需求名称（从路径中提取）。
+
+**1.2 如果不在需求目录下，列出所有活跃需求**
+
+```bash
+find 6aspecdoc/green -maxdepth 2 -name ".green-status.json" -type f
+```
+
+如果找到多个需求，使用 **AskUserQuestion** 让用户选择要继续的需求。
+
+选项应该显示：
+- 需求名称
+- 当前状态
+- 最后修改时间
+
+标记最近修改的需求为 "(推荐)"。
+
+如果没有找到任何需求，输出：
+```
+未找到任何绿地需求。
+
+请先运行 /6aspec:green:new 创建一个新需求。
+```
+
+### Step 2: 读取状态文件
+
+读取 `6aspecdoc/green/<feature-name>/.green-status.json` 文件：
+
+如果文件不存在，说明这是一个旧的需求目录（在状态管理机制之前创建的），输出：
+```
+错误：未找到状态文件
+
+路径：6aspecdoc/green/<feature-name>/.green-status.json
+
+这个需求目录可能是在状态管理机制之前创建的。
+
+建议：
+1. 手动创建状态文件（参考 green_status_schema.md）
+2. 或者重新创建需求
+```
+
+### Step 3: 判断下一步操作
+
+根据状态文件中的 `status` 字段判断下一步应该执行什么：
+
+| 当前状态 | 下一步命令 | 说明 |
+|---------|-----------|------|
+| `created` | `/6aspec:green:clarify` | 继续需求澄清（如有待确认项），或直接 `/6aspec:green:model`（如需求已充分） |
+| `requirement_clarified` | `/6aspec:green:model` | 开始领域建模 |
+| `modeled` | `/6aspec:green:design` | 开始技术方案设计 |
+| `designed` | `/6aspec:green:tasks` | 开始任务拆解 |
+| `tasks_created` | `/6aspec:green:execute-task` | 开始执行第一个任务 |
+| `implementing` | `/6aspec:green:execute-task` | 继续执行下一个任务 |
+| `completed` | 提示归档 | 所有任务已完成 |
+| `archived` | 无操作 | 需求已归档 |
+
+**特殊处理：**
+
+**对于 `implementing` 状态：**
+- 需要检查任务进度
+- 如果还有未完成的任务，提示用户选择要执行的任务
+- 使用 **AskUserQuestion** 让用户选择：
+  - 选项1：执行下一个未完成的任务（推荐）
+  - 选项2：查看所有任务列表
+  - 选项3：手动指定任务
+
+**对于 `completed` 状态：**
+输出：
+```
+✅ 所有任务已完成！
+
+需求：<feature-name>
+状态：已完成
+任务进度：<completed>/<total>
+
+下一步建议：
+运行 /6aspec:green:archive 归档此需求
+```
+然后停止，不自动执行归档。
+
+**对于 `archived` 状态：**
+输出：
+```
+此需求已归档。
+
+需求：<feature-name>
+归档时间：<lastModified>
+
+如需继续工作，请创建新需求或选择其他活跃需求。
+```
+
+### Step 4: 执行下一步命令
+
+根据Step 3的判断，自动执行对应的命令。
+
+**重要：不要只是提示用户运行命令，而是直接执行命令。**
+
+执行方式：
+1. 输出即将执行的命令和原因
+2. 直接调用对应的命令（通过Skill工具）
+
+示例输出：
+```
+📍 当前状态：需求已澄清
+📋 下一步：领域建模
+
+正在执行 /6aspec:green:model...
+```
+
+然后直接调用 `/6aspec:green:model` 命令。
+
+### Step 5: 命令执行后的处理
+
+命令执行完成后，输出进度信息：
+
+```
+✅ 已完成：<刚完成的步骤>
+
+📊 进度：<当前步骤>/<总步骤> (主流程)
+
+下一步：
+运行 /6aspec:green:continue 继续下一步
+或运行 /6aspec:green:status 查看当前状态
+```
+
+## 错误处理
+
+### 错误 1: 状态文件格式错误
+
+```
+错误：状态文件格式错误
+
+路径：6aspecdoc/green/<feature-name>/.green-status.json
+
+错误信息：<parse-error>
+
+请检查状态文件格式是否正确。
+```
+
+### 错误 2: 未知状态
+
+```
+错误：未知的状态值
+
+当前状态：<unknown-status>
+
+这可能是因为状态文件被手动修改或损坏。
+
+请运行 /6aspec:green:status 查看详细状态。
+```
+
+## 注意事项
+
+1. **自动执行**：continue 命令应该自动执行下一步，而不是只提示用户
+2. **状态驱动**：完全基于状态文件来判断下一步
+3. **用户确认**：只在需要用户选择时才使用 AskUserQuestion
+4. **进度显示**：每次执行后显示清晰的进度信息
+5. **幂等性**：可以重复执行 continue 命令，不会造成问题
+
+## 参考文档
+
+- 状态文件结构定义：`.6aspec/rules/green/green_status_schema.md`
+- 状态查询SOP：`.6aspec/rules/green/6A_status_sop.md`

package/.6aspec/rules/green/6A_design_sop.md

@@ -9,7 +9,7 @@ alwaysApply: false
 
 ## 角色与目标
 - **角色**：资深架构师（Senior Architect）
-- **目标**：产出可直接指导实现的 TDD 文档（不依赖阅读 PRD 也能落地开发）
+- **目标**：产出可直接指导实现的 TDD 文档（不依赖阅读 requirement 以外文档也能落地开发）
 - **强约束**：所有设计必须严格基于既定【领域模型与数据库表结构】
 
 ## 0. 执行协议 (Protocol) - 必须遵守
@@ -18,7 +18,8 @@ alwaysApply: false
 
 1.  **主动检索 (Active Retrieval)**：
     *   不要被动等待。当用户给出功能名称时，优先使用工具（`file_search` 或 `read_file`）尝试读取以下关键文件：
-        *   `./6aspec/{kebab-case-功能名称}/domain-model.md`
+        *   `6aspecdoc/green/<feature-name>/requirement.md`（需求澄清文档，由 new 生成，**设计时的需求依据**）
+        *   `6aspecdoc/green/<feature-name>/artifacts/domain-model.md`（领域模型）
         *   `./.6aspec/biz/functional-capability-Map.md` (能力地图)
         *   `./.6aspec/biz/event-list.md` (事件清单，如涉及事件)
     *   只有当无法读取这些文件时，才请求用户提供。
@@ -38,31 +39,58 @@ alwaysApply: false
 2. **基于模型设计**：任何字段/状态/约束必须在模型中可承载，否则停止
 3. **拒绝前端与测试**：严禁涉及 UI、交互、样式、测试用例
 4. **接口规范性**：接口仅允许 **GET/POST**；URL **不使用路径变量**
-5. **按需设计（不为设计而设计）**：入口类型是“允许范围”，不是“必选项”。只对 PRD/模型明确涉及的入口做设计；未涉及的入口类型不要输出对应设计内容。
+5. **按需设计（不为设计而设计）**：入口类型是“允许范围”，不是“必选项”。只对 requirement.md/领域模型明确涉及的入口做设计；未涉及的入口类型不要输出对应设计内容。
 6. **入口类型限制**：只允许以下入口（按需选择，非必需全包含）：
    - 写操作 REST API（Command API）
    - 定时任务（Scheduled Tasks）
    - 事件订阅（Event Subscribers）
    - 后台任务（Async Background Job）
-7. **禁止查询接口**：除非 PRD **逐条明确**：
+7. **禁止查询接口**：除非 requirement.md **逐条明确**：
    - 接口名称
    - 查询目的（支撑哪条业务决策）
    - 不可由现有能力替代的原因  
    否则 **禁止设计任何 Query/List/Detail/Search**
 
+## 前置条件（依赖门禁，必须首先执行）
+
+在执行技术方案设计前，**必须**先完成依赖检查，不通过则**立即停止**并提示，不得继续：
+
+1. **确定当前需求**：根据当前工作目录或用户 @ 的文件，确定 `6aspecdoc/green/<feature-name>/`；若有多个需求则让用户选择。
+2. **读取状态文件**：读取 `6aspecdoc/green/<feature-name>/.green-status.json`。若文件不存在，停止并提示先运行 `/6aspec:green:new` 创建需求。
+3. **检查上一流程已完成**：
+   - 若 `status` 不是 `modeled`，停止并提示：
+     ```
+     ❌ 未通过依赖检查，无法执行技术方案设计
+
+     当前状态：<status>
+     要求状态：modeled（领域建模已完成）
+
+     请先完成领域建模：运行 /6aspec:green:model，并确保生成 artifacts/domain-model.md 且状态已更新为 modeled。
+     ```
+   - 若 `artifacts.models.status` 不是 `done`，停止并提示先运行 `/6aspec:green:model` 完成领域建模。
+4. **检查 domain-model.md 存在**：若 `6aspecdoc/green/<feature-name>/artifacts/domain-model.md` 不存在，停止并提示先完成领域建模。
+
+**只有以上检查全部通过后，才允许继续执行本 SOP 的设计步骤。**
+
 ## 输入要求（你必须先检查）
+
+按主流程，需求已在 new 阶段澄清并产出 `requirement.md`，design 阶段**以 requirement.md + 领域模型**为输入，无需原始 PRD。
+
 你需要确保拥有以下输入（优先尝试主动读取）：
-- **必需输入 1**：PRD 文档或功能需求描述（通常由用户在对话中提供）
-- **必需输入 2**：数据模型设计文档：`./6aspec/{kebab-case-功能名称}/domain-model.md`
-- **参考文档**：`./.6aspec/biz/functional-capability-Map.md`（能力地图）
+- **必需输入 1**：需求澄清文档 `requirement.md`（由 `/6aspec:green:new` 生成，位于 `6aspecdoc/green/<feature-name>/requirement.md`）。设计时的功能范围、业务规则、Scope 以该文档为准。
+- **必需输入 2**：数据模型设计文档 `6aspecdoc/green/<feature-name>/artifacts/domain-model.md`
+- **参考文档**：`./.6aspec/biz/functional-capability-Map.md`（能力地图）、`./.6aspec/biz/event-list.md`（事件清单，涉及事件时）
+
+**可选**：若用户额外提供原始 PRD，仅作补充参考，不得与 requirement.md 已确认内容冲突；有冲突时以 requirement.md 为准。
 
 ## 第一阶段：需求完备性检查（Gatekeeping，必须先做）
 **请在 `<thinking>` 块中执行此步骤。**
 请逐项核对并输出结论（Y/N）：
+- [ ] **需求文档存在**：`6aspecdoc/green/<feature-name>/requirement.md` 是否存在且可读？（设计依据以该文档为准）
+- [ ] **模型文档存在**：`6aspecdoc/green/<feature-name>/artifacts/domain-model.md` 是否存在？
 - [ ] **数据闭环**：新功能涉及字段是否都能落在模型中？
 - [ ] **外部依赖**：是否需要调用其他模块 Facade？（参考能力地图）
 - [ ] **异常覆盖**：失败、超时、并发、幂等等关键逻辑是否明确？
-- [ ] **模型文档存在**：`./6aspec/{kebab-case-功能名称}/domain-model.md` 是否存在？
 
 **若任意一项为 N：立即停止输出 TDD，改为输出“提问清单”。**
 
@@ -154,17 +182,17 @@ alwaysApply: false
 
 ## 输出要求（硬性）
 1. **格式**：Markdown 源码，使用代码块包裹。
-2. **位置**：`6aspec/{kebab-case-功能名称}/`（功能名称使用 kebab-case 命名，如：user-authentication）
+2. **位置**：`6aspecdoc/green/<feature-name>/artifacts/`（feature-name 使用 kebab-case 命名，如：user-authentication）
 3. **交付物格式**：
    请严格按照以下格式在一次回复中输出两个代码块：
 
    这里是技术设计文档：
-   ```markdown:6aspec/{kebab-case-功能名称}/tech-design.md
+   ```markdown:6aspecdoc/green/<feature-name>/artifacts/tech-design.md
    (技术设计文档内容...)
    ```
 
    这里是 API 详细定义：
-   ```markdown:6aspec/{kebab-case-功能名称}/api-definition.md
+   ```markdown:6aspecdoc/green/<feature-name>/artifacts/api-definition.md
    (API 定义内容，包含详细 JSON 结构...)
    ```
 4. **解耦**：不包含具体项目包路径，用逻辑层（service/repository/facade）描述

package/.6aspec/rules/green/6A_import_model_table_sop.md

@@ -85,13 +85,13 @@ python .cursor/script/create_entities_from_markdown.py {markdown_file_path} -a {
 
 ## 示例对话
 
-**User:** `import-model-table 6aspec/xxx/domain-model.md 890601`
+**User:** `import-model-table 6aspecdoc/green/xxx/artifacts/domain-model.md 890601`
 
 **Assistant:**
 1. 解析 Application: `8906`
 2. 搜索 GUID: 在 `data/metadata/_metadata/8906/` 中搜索 `890601`...
 3. 找到 GUID: `12345678-1234-1234-1234-1234567890ab`
-4. 执行命令: `python .6aspec/script/create_entities_from_markdown.py 6aspec/xxx/domain-model.md -a 8906 -g 12345678-1234-1234-1234-1234567890ab`
+4. 执行命令: `python .6aspec/script/create_entities_from_markdown.py 6aspecdoc/green/xxx/artifacts/domain-model.md -a 8906 -g 12345678-1234-1234-1234-1234567890ab`
 5. 反馈结果。
 
 ## 流程完成提示 (Workflow Progress)

package/.6aspec/rules/green/6A_model_sop.md

@@ -23,13 +23,58 @@ alwaysApply: false
     - 字段语义不清
     - 是否复用已有表无法确认
 
+## 前置条件（依赖门禁，必须首先执行）
+
+在执行领域建模前，**必须**先完成依赖检查，不通过则**立即停止**并提示，不得继续：
+
+1. **确定当前需求**：根据当前工作目录或用户 @ 的文件，确定 `6aspecdoc/green/<feature-name>/`；若有多个需求则让用户选择。
+2. **读取状态文件**：读取 `6aspecdoc/green/<feature-name>/.green-status.json`。若文件不存在，说明尚未通过 `new` 创建该需求，停止并提示：
+   ```
+   ❌ 未通过依赖检查，无法执行领域建模
+
+   原因：未找到状态文件，该需求尚未通过 /6aspec:green:new 创建。
+
+   请先运行 /6aspec:green:new 创建需求并完成需求澄清。
+   ```
+3. **检查上一流程已完成**：
+   - 若 `status` 不是 `requirement_clarified`，停止并提示：
+     ```
+     ❌ 未通过依赖检查，无法执行领域建模
+
+     当前状态：<status>
+     要求状态：requirement_clarified（需求已澄清）
+
+     请先完成需求澄清：运行 /6aspec:green:new 或 /6aspec:green:clarify，并确保生成 requirement.md 且状态已更新为 requirement_clarified。
+     ```
+   - 若 `artifacts.requirement.status` 不是 `done`，停止并提示：
+     ```
+     ❌ 未通过依赖检查，无法执行领域建模
+
+     需求澄清文档（requirement）尚未完成。
+
+     请先运行 /6aspec:green:new 或 /6aspec:green:clarify 完成 requirement.md 后再执行 model。
+     ```
+4. **检查 requirement.md 存在**：若 `6aspecdoc/green/<feature-name>/requirement.md` 不存在或为空，停止并提示先完成需求澄清。
+
+5. **检查项目已初始化（可选但推荐）**：若 `./.6aspec/biz/functional-capability-Map.md` 不存在，提示：
+   ```
+   ⚠️ 未检测到能力地图，建议先运行 /6aspec:green:init 初始化项目（生成能力地图与事件清单），以便建模时复用现有资产。
+   是否仍继续？（继续则无法做复用评估）
+   ```
+   若用户选择继续，可仅基于 requirement 建模；否则等待用户执行 init 后再执行 model。
+
+**只有第 1～4 项检查全部通过后，才允许继续执行本 SOP 的建模步骤。**
+
 ## 输入要求
-- **必需输入**：PRD（产品需求文档）或功能需求描述
+- **首选输入**：需求澄清文档 `requirement.md`（由 `/6aspec:green:new` 生成，位于 `6aspecdoc/green/<feature-name>/requirement.md`）
+- **备选输入**：如果尚未执行 `new` 命令，可直接使用 PRD（产品需求文档）或功能需求描述
 - **可选输入**：已确认的领域边界与核心实体语义(可以是markdown文档)
 - **系统自带知识库**：
     - 现有能力地图:`./.6aspec/biz/functional-capability-Map.md`
     - **C端用户体系规范**:`./.6aspec/rules/biz/c_user_system_rule.md` (仅在涉及C端用户/门户/小程序相关设计时**必需**读取)
 
+> **注意**：如果用户提供了 `requirement.md`，应以其中的功能清单、业务规则和范围界定为基础进行建模，确保模型与已确认的需求保持一致。
+
 
 ## 第一阶段：资产审计与策略定义 (Asset Audit)
 在进行具体建模前，请执行以下审计动作：
@@ -130,8 +175,8 @@ alwaysApply: false
 
 ## 输出要求：
 1. 格式：Markdown 源码格式
-2. 文档位置：`6aspec/{kebab-case-功能名称}` 目录（功能名称使用 kebab-case 命名，如：user-authentication）
-3. 文档命名：`domain-model.md`
+2. 文档位置：`6aspecdoc/green/<feature-name>/artifacts/` 目录（feature-name 使用 kebab-case 命名，如：user-authentication）
+3. 文档命名：`domain-model.md`（完整路径：`6aspecdoc/green/<feature-name>/artifacts/domain-model.md`）
 4. 请务必检查下第三步的输出是否满足格式要求
 
 ## 注意
@@ -158,8 +203,8 @@ alwaysApply: false
 
 **完整流程图：**
 ```
-主流程：领域建模 ✅ → 技术方案 → 任务生成 → 执行任务 (1/4)
-可选流程：表导入建模平台 / 生成可视化逻辑图
+主流程：需求澄清 ✅ → 领域建模 ✅ → 技术方案 → 任务生成 → 执行任务 (1/4)
+可选流程：需求深化澄清 / 表导入建模平台 / 生成可视化逻辑图
 ```
 
 ---