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

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

@@ -0,0 +1,280 @@
+# 绿地需求状态文件结构定义
+
+## 概述
+
+每个绿地需求都有一个状态文件 `.green-status.json`，用于跟踪需求的生命周期状态、工件完成情况和任务进度。
+
+## 文件位置
+
+```
+6aspec/green/<feature-name>/.green-status.json
+```
+
+## 状态文件结构
+
+```json
+{
+  "name": "string",              // 需求名称（kebab-case）
+  "status": "string",            // 当前生命周期状态
+  "created": "ISO8601",          // 创建时间
+  "lastModified": "ISO8601",     // 最后修改时间
+  "artifacts": {                 // 工件完成情况
+    "requirement": {
+      "status": "string",        // 工件状态：pending/ready/done/blocked
+      "path": "string",          // 工件路径
+      "completedAt": "ISO8601"   // 完成时间（可选）
+    },
+    "models": {
+      "status": "string",
+      "path": "string",
+      "completedAt": "ISO8601",
+      "files": ["string"]        // 模型文件列表（可选）
+    },
+    "design": {
+      "status": "string",
+      "path": "string",
+      "completedAt": "ISO8601"
+    },
+    "tasks": {
+      "status": "string",
+      "path": "string",
+      "completedAt": "ISO8601",
+      "files": ["string"]        // 任务文件列表（可选）
+    }
+  },
+  "tasks": {                     // 任务进度
+    "total": 0,                  // 总任务数
+    "completed": 0,              // 已完成任务数
+    "remaining": 0,              // 剩余任务数
+    "lastExecuted": "string"     // 最后执行的任务文件名（可选）
+  },
+  "nextAction": {                // 下一步建议（可选）
+    "command": "string",         // 建议的命令
+    "description": "string"      // 描述
+  }
+}
+```
+
+## 生命周期状态
+
+| 状态 | 说明 | 下一步命令 |
+|------|------|-----------|
+| `created` | 已创建，等待需求澄清 | `/6aspec:green:new` 或 `/6aspec:green:clarify` |
+| `requirement_clarified` | 需求已澄清 | `/6aspec:green:model`（可选：`/6aspec:green:clarify` 继续深化） |
+| `modeled` | 领域建模完成 | `/6aspec:green:design` |
+| `designed` | 技术方案完成 | `/6aspec:green:tasks` |
+| `tasks_created` | 任务已拆解 | `/6aspec:green:execute-task` |
+| `implementing` | 实施中 | `/6aspec:green:execute-task` |
+| `completed` | 已完成 | `/6aspec:green:archive` |
+| `archived` | 已归档 | - |
+
+## 工件状态
+
+| 状态 | 说明 |
+|------|------|
+| `pending` | 等待创建 |
+| `ready` | 准备就绪，可以创建 |
+| `done` | 已完成 |
+| `blocked` | 被阻塞，等待依赖工件完成 |
+
+## 工件依赖关系
+
+```
+requirement (需求澄清文档)
+  ↓
+models (领域模型)
+  ↓
+design (技术方案)
+  ↓
+tasks (任务列表)
+```
+
+## 状态转换规则
+
+1. **created → requirement_clarified**
+   - 条件：requirement 工件状态为 done
+   - 触发：完成需求澄清文档
+
+2. **requirement_clarified → modeled**
+   - 条件：models 工件状态为 done
+   - 触发：完成领域建模
+
+3. **modeled → designed**
+   - 条件：design 工件状态为 done
+   - 触发：完成技术方案
+
+4. **designed → tasks_created**
+   - 条件：tasks 工件状态为 done
+   - 触发：完成任务拆解
+
+5. **tasks_created → implementing**
+   - 条件：开始执行任务
+   - 触发：执行第一个任务
+
+6. **implementing → completed**
+   - 条件：所有任务完成（tasks.completed == tasks.total）
+   - 触发：完成最后一个任务
+
+7. **completed → archived**
+   - 条件：用户确认归档
+   - 触发：执行归档命令
+
+## 示例
+
+### 初始状态（刚创建）
+
+```json
+{
+  "name": "user-authentication",
+  "status": "created",
+  "created": "2026-02-16T03:00:00Z",
+  "lastModified": "2026-02-16T03:00:00Z",
+  "artifacts": {
+    "requirement": {
+      "status": "pending",
+      "path": "6aspec/green/user-authentication/requirement.md"
+    },
+    "models": {
+      "status": "blocked",
+      "path": "6aspec/green/user-authentication/artifacts/"
+    },
+    "design": {
+      "status": "blocked",
+      "path": "6aspec/green/user-authentication/artifacts/"
+    },
+    "tasks": {
+      "status": "blocked",
+      "path": "6aspec/green/user-authentication/tasks/"
+    }
+  },
+  "tasks": {
+    "total": 0,
+    "completed": 0,
+    "remaining": 0
+  },
+  "nextAction": {
+    "command": "new",
+    "description": "开始需求澄清"
+  }
+}
+```
+
+### 需求澄清完成后
+
+```json
+{
+  "name": "user-authentication",
+  "status": "requirement_clarified",
+  "created": "2026-02-16T03:00:00Z",
+  "lastModified": "2026-02-16T03:15:00Z",
+  "artifacts": {
+    "requirement": {
+      "status": "done",
+      "path": "6aspec/green/user-authentication/requirement.md",
+      "completedAt": "2026-02-16T03:15:00Z"
+    },
+    "models": {
+      "status": "ready",
+      "path": "6aspec/green/user-authentication/artifacts/"
+    },
+    "design": {
+      "status": "blocked",
+      "path": "6aspec/green/user-authentication/artifacts/"
+    },
+    "tasks": {
+      "status": "blocked",
+      "path": "6aspec/green/user-authentication/tasks/"
+    }
+  },
+  "tasks": {
+    "total": 0,
+    "completed": 0,
+    "remaining": 0
+  },
+  "nextAction": {
+    "command": "model",
+    "description": "开始领域建模"
+  }
+}
+```
+
+### 实施中
+
+```json
+{
+  "name": "user-authentication",
+  "status": "implementing",
+  "created": "2026-02-16T03:00:00Z",
+  "lastModified": "2026-02-16T05:30:00Z",
+  "artifacts": {
+    "requirement": {
+      "status": "done",
+      "path": "6aspec/green/user-authentication/requirement.md",
+      "completedAt": "2026-02-16T03:15:00Z"
+    },
+    "models": {
+      "status": "done",
+      "path": "6aspec/green/user-authentication/artifacts/",
+      "completedAt": "2026-02-16T03:45:00Z",
+      "files": ["domain-model.md"]
+    },
+    "design": {
+      "status": "done",
+      "path": "6aspec/green/user-authentication/artifacts/",
+      "completedAt": "2026-02-16T04:15:00Z"
+    },
+    "tasks": {
+      "status": "done",
+      "path": "6aspec/green/user-authentication/tasks/",
+      "completedAt": "2026-02-16T04:30:00Z",
+      "files": ["task_01_user_model.md", "task_02_auth_api.md", "task_03_session.md"]
+    }
+  },
+  "tasks": {
+    "total": 8,
+    "completed": 5,
+    "remaining": 3,
+    "lastExecuted": "task_05_session_management.md"
+  },
+  "nextAction": {
+    "command": "execute-task",
+    "description": "继续执行剩余 3 个任务"
+  }
+}
+```
+
+## 使用说明
+
+### 读取状态
+
+所有命令在执行前应该读取状态文件，了解当前状态：
+
+```javascript
+const statusPath = '6aspec/green/<feature-name>/.green-status.json';
+const status = JSON.parse(fs.readFileSync(statusPath, 'utf8'));
+```
+
+### 更新状态
+
+命令执行后应该更新状态文件：
+
+```javascript
+status.lastModified = new Date().toISOString();
+status.artifacts.requirement.status = 'done';
+status.artifacts.requirement.completedAt = new Date().toISOString();
+status.status = 'requirement_clarified';
+fs.writeFileSync(statusPath, JSON.stringify(status, null, 2));
+```
+
+### 状态检查
+
+在执行命令前，检查状态是否符合预期：
+
+```javascript
+if (status.status !== 'requirement_clarified') {
+  console.error('错误：当前状态不允许执行此命令');
+  console.error(`当前状态：${status.status}`);
+  console.error(`期望状态：requirement_clarified`);
+  process.exit(1);
+}
+```

package/.claude/commands/6aspec/green/archive.md

@@ -0,0 +1,8 @@
+---
+description: 归档已完成的绿地需求
+---
+
+1. Immediate response upon activation: archive workflow has been activated
+2. Read file: `.6aspec/rules/green/6A_archive_sop.md`
+3. Strictly follow the "Archive Workflow SOP" defined in that file
+4. Archive the completed requirement

package/.claude/commands/6aspec/green/clarify.md

@@ -0,0 +1,13 @@
+---
+description: 深化需求澄清（对已有需求进行更细节的澄清和补充）
+---
+
+1. Immediate response upon activation: clarify workflow has been activated
+2. **You must first read and strictly abide by the principles in the constitutional documents**：`.6aspec/rules/green/6A_constitution.md`
+3. **Context Restriction**: 
+   - Do NOT perform `codebase_search`.
+   - Do NOT read any files unless they are explicitly provided by the user (via '@') or explicitly listed in the SOP steps.
+   - Stop and ask the user if you think you need more information.
+4. Read file: `.6aspec/rules/green/6A_clarify_sop.md`
+5. Strictly follow the "Requirement Clarification SOP" defined in that file
+6. Update the requirement document with clarified details

package/.claude/commands/6aspec/green/continue.md

@@ -0,0 +1,8 @@
+---
+description: 自动执行绿地需求的下一步工作流
+---
+
+1. Immediate response upon activation: continue workflow has been activated
+2. Read file: `.6aspec/rules/green/6A_continue_sop.md`
+3. Strictly follow the "Continue Workflow SOP" defined in that file
+4. Automatically execute the next step based on current status

package/.claude/commands/6aspec/green/new.md

@@ -0,0 +1,13 @@
+---
+description: 开始一个新的绿地需求（需求澄清与结构化）
+---
+
+1. Immediate response upon activation: new feature workflow has been activated
+2. **You must first read and strictly abide by the principles in the constitutional documents**：`.6aspec/rules/green/6A_constitution.md`
+3. **Context Restriction**: 
+   - Do NOT perform `codebase_search`.
+   - Do NOT read any files unless they are explicitly provided by the user (via '@') or explicitly listed in the SOP steps.
+   - Stop and ask the user if you think you need more information.
+4. Read file: `.6aspec/rules/green/6A_new_sop.md`
+5. Strictly follow the "New Feature Requirement SOP" defined in that file
+6. Output the structured requirement document

package/.claude/commands/6aspec/green/status.md

@@ -0,0 +1,8 @@
+---
+description: 查看绿地需求的当前状态和进度
+---
+
+1. Immediate response upon activation: status workflow has been activated
+2. Read file: `.6aspec/rules/green/6A_status_sop.md`
+3. Strictly follow the "Status Query SOP" defined in that file
+4. Output the current status and progress

package/.claude/settings.local.json

@@ -0,0 +1,8 @@
+{
+  "permissions": {
+    "allow": [
+      "Bash(ls -la .claude/commands/6aspec/green/*.md)",
+      "Bash(xargs -I {} basename {})"
+    ]
+  }
+}

package/.cursor/commands/6aspec/green/archive.md

@@ -0,0 +1,9 @@
+---
+description: 归档已完成的绿地需求
+alwaysApply: false
+---
+
+1. Immediate response upon activation: archive workflow has been activated
+2. Read file: `.6aspec/rules/green/6A_archive_sop.md`
+3. Strictly follow the "Archive Workflow SOP" defined in that file
+4. Archive the completed requirement

package/.cursor/commands/6aspec/green/clarify.md

@@ -0,0 +1,14 @@
+---
+description: 深化需求澄清（对已有需求进行更细节的澄清和补充）
+alwaysApply: false
+---
+
+1. Immediate response upon activation: clarify workflow has been activated
+2. **You must first read and strictly abide by the principles in the constitutional documents**：`.6aspec/rules/green/6A_constitution.md`
+3. **Context Restriction**: 
+   - Do NOT perform `codebase_search`.
+   - Do NOT read any files unless they are explicitly provided by the user (via '@') or explicitly listed in the SOP steps.
+   - Stop and ask the user if you think you need more information.
+4. Read file: `.6aspec/rules/green/6A_clarify_sop.md`
+5. Strictly follow the "Requirement Clarification SOP" defined in that file
+6. Update the requirement document with clarified details

package/.cursor/commands/6aspec/green/continue.md

@@ -0,0 +1,9 @@
+---
+description: 自动执行绿地需求的下一步工作流
+alwaysApply: false
+---
+
+1. Immediate response upon activation: continue workflow has been activated
+2. Read file: `.6aspec/rules/green/6A_continue_sop.md`
+3. Strictly follow the "Continue Workflow SOP" defined in that file
+4. Automatically execute the next step based on current status

package/.cursor/commands/6aspec/green/new.md

@@ -0,0 +1,14 @@
+---
+description: 开始一个新的绿地需求（需求澄清与结构化）
+alwaysApply: false
+---
+
+1. Immediate response upon activation: new feature workflow has been activated
+2. **You must first read and strictly abide by the principles in the constitutional documents**：`.6aspec/rules/green/6A_constitution.md`
+3. **Context Restriction**: 
+   - Do NOT perform `codebase_search`.
+   - Do NOT read any files unless they are explicitly provided by the user (via '@') or explicitly listed in the SOP steps.
+   - Stop and ask the user if you think you need more information.
+4. Read file: `.6aspec/rules/green/6A_new_sop.md`
+5. Strictly follow the "New Feature Requirement SOP" defined in that file
+6. Output the structured requirement document

package/.cursor/commands/6aspec/green/status.md

@@ -0,0 +1,9 @@
+---
+description: 查看绿地需求的当前状态和进度
+alwaysApply: false
+---
+
+1. Immediate response upon activation: status workflow has been activated
+2. Read file: `.6aspec/rules/green/6A_status_sop.md`
+3. Strictly follow the "Status Query SOP" defined in that file
+4. Output the current status and progress

package/package.json

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