6a-spec-install 1.0.8-dev.4 → 1.0.9-dev.0

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

@@ -0,0 +1,148 @@
+# 棕地需求 - Proposal SOP
+
+创建需求提案 - 轻量级流程的第一阶段。
+
+**适用流程**：轻量级（类似OpenSpec）
+
+**输入**：`/6aspec:brown:proposal` 后可选需求名称。
+
+**步骤**
+
+1. **选择需求并检查状态**
+
+   - 读取 `6aspecdoc/brown/<name>/status.json`
+   - 确认 `flowDepth` 为 "lightweight"
+   - 如果不是轻量级流程，提示使用 `/6aspec:brown:understand`
+
+2. **收集需求信息**
+
+   如果用户在对话中已提供需求信息，直接使用。
+   否则，询问用户：
+   - 为什么需要这个变更？（Why）
+   - 要做什么？（What）
+   - 预期影响是什么？（Impact）
+
+3. **创建提案文档**
+
+   创建 `6aspecdoc/brown/<name>/artifacts/proposal.md`：
+   ```markdown
+   # 需求提案：<需求标题>
+
+   > **需求**: <name>
+   > **流程**: 轻量级
+   > **阶段**: Proposal
+   > **状态**: ✅ 已完成
+   > **创建时间**: <timestamp>
+
+   ## 为什么做（Why）
+
+   ### 业务背景
+   <业务背景描述>
+
+   ### 要解决的问题
+   <要解决的问题>
+
+   ### 预期收益
+   <预期收益>
+
+   ## 要做什么（What）
+
+   ### 功能概述
+   <功能概述>
+
+   ### 功能需求
+
+   #### FR-001: <功能名称>
+   **描述**：<功能描述>
+
+   **验收标准**：
+   - <验收标准1>
+   - <验收标准2>
+
+   #### FR-002: <功能名称>
+   **描述**：<功能描述>
+
+   **验收标准**：
+   - <验收标准1>
+   - <验收标准2>
+
+   ### 范围界定
+   **包含**：
+   - <包含的内容>
+
+   **不包含**：
+   - <不包含的内容>
+
+   ### 整体验收标准
+   - AC-001: <整体验收标准1>
+   - AC-002: <整体验收标准2>
+
+   ## 预期影响（Impact）
+
+   ### 技术影响
+   - 数据库：<影响描述>
+   - 后端代码：<影响描述>
+   - 前端代码：<影响描述>
+   - API接口：<影响描述>
+
+   ### 业务影响
+   - 用户体验：<影响描述>
+   - 业务流程：<影响描述>
+
+   ### 风险评估
+   - 技术风险：<风险描述>
+   - 业务风险：<风险描述>
+
+   ## 下一步
+
+   运行 `/6aspec:brown:design` 进行技术方案设计。
+   ```
+
+4. **更新状态**
+
+   更新 `6aspecdoc/brown/<name>/status.json`：
+   ```json
+   {
+     "status": "design_pending",
+     "flowDepth": "lightweight",
+     "phases": {
+       "proposal": "done",
+       "design": "pending",
+       "tasks": "blocked",
+       "implement": "blocked"
+     },
+     "artifacts": ["proposal.md"]
+   }
+   ```
+
+5. **停止并等待用户确认**
+
+**输出**
+
+```
+## Proposal 完成：<name>
+
+**流程**: 轻量级
+**进度**: 1/4 阶段完成
+
+### 提案概要
+- 业务目标：<简述>
+- 核心能力：<数量> 个
+- 预期影响：<简述>
+
+### 关键风险
+<列出关键风险>
+
+### 文档位置
+6aspecdoc/brown/<name>/artifacts/proposal.md
+
+### 下一步
+- 运行 `/6aspec:brown:design` 进行技术方案设计
+- 或运行 `/6aspec:brown:continue` 自动进入下一阶段
+```
+
+**防护措施**
+- 仅适用于轻量级流程
+- 如果需求信息不明确，必须询问用户
+- 提案必须包含Why、What、Impact三个核心部分
+- 风险评估不能省略

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

@@ -0,0 +1,134 @@
+# 棕地需求 - Quick SOP
+
+P2 需求快速通道 - 适用于简单修复和小改动。
+
+**输入**：`/6aspec:brown:quick` 后的参数是需求名称（kebab-case）或需求描述。
+
+**适用场景**：
+- Bug 修复
+- 文案调整
+- 简单重构
+- 单文件修改
+- 无架构影响的小改动
+
+**步骤**
+
+1. **如果没有提供输入，询问需求内容**
+
+   询问用户：
+   > "你想快速处理什么需求？请描述要修复的问题或要做的改动。"
+
+   从描述中提取 kebab-case 名称。
+
+2. **创建简化的需求目录**
+
+   ```bash
+   mkdir -p "6aspecdoc/brown/<name>"
+   ```
+
+   创建状态文件 `6aspecdoc/brown/<name>/status.json`：
+   ```json
+   {
+     "name": "<name>",
+     "priority": "P2",
+     "status": "quick_track",
+     "createdAt": "<timestamp>",
+     "lastModified": "<timestamp>",
+     "quickTrack": true
+   }
+   ```
+
+   创建需求描述文件 `6aspecdoc/brown/<name>/requirement.md`：
+   ```markdown
+   # <需求标题>
+
+   > **需求ID**: <name>
+   > **优先级**: P2（快速通道）
+   > **状态**: 🚀 快速处理中
+   > **创建时间**: <timestamp>
+
+   ## 需求描述
+
+   <用户提供的需求描述>
+
+   ## 快速分析
+
+   ### 影响范围
+   - 影响文件：<列出>
+   - 影响类型：Bug修复 / 文案调整 / 简单重构
+
+   ### 实现方案
+   <简要说明实现方案>
+
+   ### 验收标准
+   - [ ] <标准1>
+   - [ ] <标准2>
+   ```
+
+3. **快速分析**
+
+   执行简化的分析：
+   - 找到需要修改的文件
+   - 理解当前代码逻辑
+   - 确定修改方案
+
+4. **直接实现**
+
+   - 执行代码修改
+   - 保持变更最小化
+   - 确保不引入新问题
+
+5. **快速验证**
+
+   - 检查代码语法
+   - 运行相关测试（如有）
+   - 确认修改符合需求
+
+6. **更新状态**
+
+   更新 `6aspecdoc/brown/<name>/status.json`：
+   ```json
+   {
+     "status": "completed",
+     "completedAt": "<timestamp>",
+     "quickTrack": true
+   }
+   ```
+
+   在 `requirement.md` 中更新验收标准为已完成。
+
+**输出**
+
+```
+## 快速处理完成：<name>
+
+**优先级**: P2（快速通道）
+**处理时间**: <时间戳>
+
+### 修改内容
+- 修改文件：<文件列表>
+- 修改类型：<类型>
+
+### 验收标准
+- [x] <标准1>
+- [x] <标准2>
+
+### 下一步
+- 提交代码：使用 git 提交修改
+- 或归档：运行 `/6aspec:brown:archive` 归档此需求
+
+### 注意
+P2 需求使用快速通道，跳过了详细的分析和设计阶段。
+如果发现需求比预期复杂，建议使用完整流程（/6aspec:brown:new）。
+```
+
+**防护措施**
+- 如果需求比预期复杂，警告用户并建议使用完整流程
+- 保持修改最小化
+- 不要跳过必要的验证
+- 如果不确定影响范围，建议使用完整流程
+- 快速通道不适用于：
+  - 多表联动
+  - 复杂业务逻辑
+  - 架构变更
+  - 新功能开发

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

@@ -0,0 +1,270 @@
+# 棕地需求 - Review SOP
+
+Phase 7: 实施后评估
+
+**输入**：`/6aspec:brown:review` 后可选需求名称。
+
+**注意**：此阶段通常在需求上线后 1 周或 1 个月执行，用于评估实施效果。
+
+**步骤**
+
+1. **选择需求并检查状态**
+
+   - 读取 `6aspecdoc/brown/<name>/status.json`
+   - 确认 `phases.verify` 为 "done"
+   - 如果未完成 Phase 6，提示先运行 `/6aspec:brown:verify`
+
+2. **读取历史文档**
+
+   读取以下文档：
+   - `6aspecdoc/brown/<name>/requirement.md` - 原始需求
+   - `6aspecdoc/brown/<name>/artifacts/02-impact-analysis.md` - 预期影响
+   - `6aspecdoc/brown/<name>/artifacts/03-technical-design.md` - 技术方案
+   - `6aspecdoc/brown/<name>/artifacts/ADR-<name>.md` - 架构决策（P0）
+
+3. **参考相关归档需求（可选）**
+
+   如果有相关的归档需求，可以参考其经验教训：
+
+   **如何参考**：
+   - 使用 `@` 手动加载归档需求的 `post-implementation-review.md`
+   - 例如：`@6aspecdoc/brown/.archived/2026-02-10-add-business-field/artifacts/06-post-implementation-review.md`
+
+   **应该参考的内容**：
+   - ✅ 经验教训：做得好的地方、需要改进的地方
+   - ✅ 最佳实践：可复用的方案和模式
+   - ✅ 关键成功因素：什么因素导致了成功或失败
+   - ✅ 改进建议：对未来类似需求的建议
+
+   **不应该参考的内容**：
+   - ❌ 技术方案：代码可能已经演进，历史方案可能已过时
+   - ❌ 影响面分析：当前代码状态可能已经不同
+   - ❌ 具体实现细节：应该基于当前代码，而不是历史文档
+
+   **为什么这样做**：
+   - 代码是唯一的事实来源，会随着需求演进而变化
+   - 归档文档是历史快照，不会更新
+   - 经验教训是跨时间有效的，但技术方案是时间敏感的
+
+4. **收集评估数据**
+
+   收集以下信息：
+
+   **技术指标**：
+   - 性能是否符合预期？
+   - 是否产生新的 bug？
+   - 技术债务是否可控？
+
+   **业务指标**：
+   - 是否解决了业务问题？
+   - 用户反馈如何？
+   - 是否需要调整？
+
+   **架构决策回顾**（P0 需求）：
+   - 当初的架构决策是否正确？
+   - 有哪些经验教训？
+   - 需要更新 ADR 吗？
+
+4. **生成评估报告**
+
+   创建 `6aspecdoc/brown/<name>/artifacts/06-post-implementation-review.md`：
+   ```markdown
+   # Phase 7: 实施后评估
+
+   > **需求**: <name>
+   > **阶段**: Phase 7 - 实施后评估
+   > **状态**: ✅ 已完成
+   > **评估时间**: <timestamp>
+   > **上线时间**: <timestamp>
+   > **评估周期**: 上线后 <X> 周/月
+
+   ## 评估概览
+
+   | 维度 | 评分 | 说明 |
+   |------|------|------|
+   | 技术指标 | ⭐⭐⭐⭐⭐ | <说明> |
+   | 业务指标 | ⭐⭐⭐⭐⭐ | <说明> |
+   | 用户满意度 | ⭐⭐⭐⭐⭐ | <说明> |
+   | 总体评价 | ⭐⭐⭐⭐⭐ | <说明> |
+
+   ## 1. 技术指标评估
+
+   ### 1.1 性能指标
+
+   | 指标 | 预期 | 实际 | 评估 |
+   |------|------|------|------|
+   | 响应时间 | <预期值> | <实际值> | ✅ 符合 / ⚠️ 偏差 / ❌ 不符合 |
+   | QPS | <预期值> | <实际值> | ✅ 符合 / ⚠️ 偏差 / ❌ 不符合 |
+   | 错误率 | <预期值> | <实际值> | ✅ 符合 / ⚠️ 偏差 / ❌ 不符合 |
+
+   ### 1.2 稳定性
+
+   - 是否产生新的 bug：✅ 否 / ⚠️ 少量 / ❌ 较多
+   - Bug 列表（如有）：
+     - BUG-001: <描述>
+     - BUG-002: <描述>
+
+   ### 1.3 技术债务
+
+   - 技术债务是否可控：✅ 是 / ⚠️ 部分 / ❌ 否
+   - 新增技术债务：
+     - DEBT-XXX: <描述>
+   - 已偿还技术债务：
+     - DEBT-XXX: <描述>
+
+   ## 2. 业务指标评估
+
+   ### 2.1 业务目标达成
+
+   | 业务目标 | 预期 | 实际 | 评估 |
+   |----------|------|------|------|
+   | <目标1> | <预期> | <实际> | ✅ 达成 / ⚠️ 部分达成 / ❌ 未达成 |
+   | <目标2> | <预期> | <实际> | ✅ 达成 / ⚠️ 部分达成 / ❌ 未达成 |
+
+   ### 2.2 用户反馈
+
+   - 正面反馈：
+     - <反馈1>
+     - <反馈2>
+
+   - 负面反馈：
+     - <反馈1>
+     - <反馈2>
+
+   - 改进建议：
+     - <建议1>
+     - <建议2>
+
+   ### 2.3 是否需要调整
+
+   - ✅ 不需要调整，符合预期
+   - ⚠️ 需要小幅调整
+   - ❌ 需要重大调整
+
+   调整计划（如需要）：
+   <调整计划>
+
+   ## 3. 架构决策回顾（P0 需求）
+
+   ### 3.1 决策回顾
+
+   回顾 ADR-<name>.md 中的架构决策：
+
+   | 决策 | 当时的理由 | 实际效果 | 评估 |
+   |------|-----------|----------|------|
+   | <决策1> | <理由> | <效果> | ✅ 正确 / ⚠️ 部分正确 / ❌ 错误 |
+
+   ### 3.2 经验教训
+
+   **做得好的地方**：
+   - <经验1>
+   - <经验2>
+
+   **需要改进的地方**：
+   - <教训1>
+   - <教训2>
+
+   ### 3.3 ADR 更新
+
+   - ✅ 需要更新 ADR
+   - ❌ 不需要更新
+
+   更新内容（如需要）：
+   <更新内容>
+
+   ## 4. 知识沉淀
+
+   ### 4.1 最佳实践
+
+   从本次需求实施中总结的最佳实践：
+   - <实践1>
+   - <实践2>
+
+   ### 4.2 可复用方案
+
+   可以在其他需求中复用的方案：
+   - <方案1>
+   - <方案2>
+
+   ### 4.3 文档更新
+
+   需要更新的文档：
+   - [ ] 架构文档
+   - [ ] 开发规范
+   - [ ] 最佳实践库
+
+   ### 4.4 知识分享
+
+   - [ ] 技术分享会
+   - [ ] 技术博客
+   - [ ] 团队培训
+
+   ## 5. 总结
+
+   ### 5.1 总体评价
+
+   <总体评价>
+
+   ### 5.2 关键成功因素
+
+   - <因素1>
+   - <因素2>
+
+   ### 5.3 改进建议
+
+   对未来类似需求的建议：
+   - <建议1>
+   - <建议2>
+
+   ## 6. 下一步
+
+   运行 `/6aspec:brown:archive` 归档此需求。
+   ```
+
+5. **更新状态**
+
+   更新 `status.json`：
+   ```json
+   {
+     "status": "completed",
+     "phases": {
+       ...
+       "review": "done"
+     },
+     "completedAt": "<timestamp>"
+   }
+   ```
+
+**输出**
+
+```
+## Phase 7 完成：实施后评估
+
+**需求**: <name>
+**进度**: 7/7 阶段完成 ✅
+
+### 评估结果
+- 技术指标：⭐⭐⭐⭐⭐
+- 业务指标：⭐⭐⭐⭐⭐
+- 用户满意度：⭐⭐⭐⭐⭐
+- 总体评价：⭐⭐⭐⭐⭐
+
+### 关键发现
+<列出关键发现>
+
+### 经验教训
+<列出经验教训>
+
+### 文档位置
+6aspecdoc/brown/<name>/artifacts/06-post-implementation-review.md
+
+### 下一步
+所有阶段已完成！运行 `/6aspec:brown:archive` 归档此需求。
+```
+
+**防护措施**
+- 必须先完成 Phase 6
+- 评估必须基于实际数据，不能主观臆断
+- 必须收集用户反馈
+- P0 需求必须回顾架构决策
+- 必须进行知识沉淀