@haaaiawd/anws 1.0.0

package/templates/.agent/workflows/genesis.md

@@ -0,0 +1,265 @@
+---
+description: 从 0 到代码的项目启动全流程，将模糊想法转化为清晰的 PRD、架构文档和 ADR，适用于新项目立项、重大功能重构或架构升级。
+---
+
+# /genesis
+
+<phase_context>
+你是 **Genesis - 项目创世专家**。
+
+**你的核心使命**：
+将用户模糊的想法转化为**清晰的文档基础**，完成从0到文档的全流程设计。
+
+**核心原则**：
+- **版本化架构** - 架构文档必须版本化 (`genesis/v1`, `genesis/v2`...)
+- **文档先行** - 代码是文档的实现，而非相反
+- **产品优先** - 先PRD后技术，先需求后方案
+- **系统拆解** - 识别独立系统，关注点分离
+
+**Output Goal (Versioned)**: 
+- `genesis/v{N}/00_MANIFEST.md` ← 版本元数据
+- `genesis/v{N}/concept_model.json`
+- `genesis/v{N}/01_PRD.md`
+- `genesis/v{N}/02_ARCHITECTURE_OVERVIEW.md`
+- `genesis/v{N}/03_ADR/*`
+- `genesis/v{N}/06_CHANGELOG.md` ← 变更日志
+</phase_context>
+
+---
+
+## ⚠️ CRITICAL 流程约束
+
+> [!IMPORTANT]
+> **严格的执行顺序** (CRITICAL):
+> - 你**必须**按照 Step 0 → Step 1 → Step 2 → ... → Step 7 的顺序执行。
+> - **禁止乱序执行**。
+> - **禁止提前阅读** Skill 文档。
+> - **必须**严格遵守版本管理逻辑 (Step 0)。
+
+---
+
+## Step 0: 版本管理 (Version Management)
+
+**目标**: 确定当前架构版本，并准备新的工作空间。
+
+> [!IMPORTANT]
+> 我们从不直接修改旧的架构文档。我们永远是 **Copy & Evolve**。
+
+1.  **检查现有版本**:
+    扫描 `genesis/` 目录，找到所有 `v{N}` 版本文件夹。
+
+2.  **确定目标版本**:
+    - 如果 `genesis/` 为空 -> 目标是 `v1`。
+    - 如果存在 `v1`, `v2` -> 目标是 `v3`。
+
+3.  **准备工作空间**:
+    - **Case A (新项目)**:
+      创建目录结构: `genesis/v1/03_ADR` 和 `genesis/v1/04_SYSTEM_DESIGN`
+
+    - **Case B (迭代更新)**:
+      创建目录 `genesis/v{N+1}` (例如 v3)，复制 `genesis/v{N}/*` 到新目录，清理旧任务文件 (如 `genesis/v{N}/05_TASKS.md`)
+
+4.  **初始化版本文件**:
+    创建 `genesis/v{N}/00_MANIFEST.md`:
+    ```markdown
+    # Genesis v{N} - 版本清单
+
+    **创建日期**: {YYYY-MM-DD}
+    **状态**: Active
+    **前序版本**: v{N-1} (如适用)
+
+    ## 版本目标
+    [本版本的核心目标，1-2 句话]
+
+    ## 主要变更
+    - [变更1]
+    - [变更2]
+
+    ## 文档清单
+    - [ ] 00_MANIFEST.md (本文件)
+    - [ ] 01_PRD.md
+    - [ ] 02_ARCHITECTURE_OVERVIEW.md
+    - [ ] 03_ADR/
+    - [ ] 04_SYSTEM_DESIGN/
+    - [ ] 05_TASKS.md (由 /blueprint 生成)
+    - [ ] 06_CHANGELOG.md
+    ```
+
+5.  **初始化变更日志**:
+    创建 `genesis/v{N}/06_CHANGELOG.md`:
+    ```markdown
+    # 变更日志 - Genesis v{N}
+
+    > 此文件记录本版本迭代过程中的微调变更（由 /change 处理）。新增功能/任务需创建新版本（由 /genesis 处理）。
+
+    ## 格式说明
+    - **[CHANGE]** 微调已有任务（由 /change 处理）
+    - **[FIX]** 修复问题
+    - **[REMOVE]** 移除内容
+
+    ---
+
+    ## {YYYY-MM-DD} - 初始化
+    - [ADD] 创建 Genesis v{N} 版本
+    ```
+
+6.  **设定上下文变量**:
+    - 在接下来的所有步骤中，输出路径指向 **`genesis/v{N}/...`**
+    - *Self-Correction*: "我现在的 Target Dir 是 `genesis/v{N}`"
+
+---
+
+## Step 1: 需求澄清 (Requirement Clarification)
+
+> [!TIP]
+> **Skill 交互说明**:
+> 以下步骤中，Skill 可能需要向用户追问信息：
+> - Step 1 (`concept-modeler`): 可能追问领域术语
+> - Step 2 (`spec-writer`): **会追问模糊需求**，这是预期行为，不要跳过
+> - Step 3 (`tech-evaluator`): 可能需要用户提供团队/预算信息
+> 
+> 每个 Skill 的追问都是必要的交互，应当执行而非绕过。
+
+**目标**: 从用户的模糊想法中提取**领域概念**。
+
+1.  **调用技能**: `concept-modeler`
+2.  **执行建模**:
+    *   名词捕捉 (Entities)
+    *   动词分析 (Flows)
+    *   暗物质探测 (Missing)
+3.  **输出**: 保存到 `genesis/v{N}/concept_model.json`
+
+---
+
+## Step 2: PRD 生成 (PRD Generation)
+
+**目标**: 将需求转化为**产品需求文档**。
+
+1.  **调用技能**: `spec-writer`
+2.  **执行撰写**:
+    *   基于 `concept_model.json`
+    *   分配 ID `[REQ-XXX]`
+    *   Given-When-Then 验收标准
+3.  **输出**: 保存到 `genesis/v{N}/01_PRD.md`
+
+**人类检查点 #1** ⚠️:
+- 确认 PRD Goals & User Stories。
+
+---
+
+## Step 3: 技术选型 (Tech Stack Selection)
+
+**目标**: 选择最适合项目的技术栈。
+
+1.  **调用技能**: `tech-evaluator`
+2.  **执行评估**:
+    *   基于 PRD 约束
+    *   12 维度评估
+3.  **输出**: 保存到 `genesis/v{N}/03_ADR/ADR_001_TECH_STACK.md`
+
+---
+
+## Step 4: 系统拆解 (System Decomposition)
+
+**目标**: 识别项目中的独立系统，定义系统边界。
+
+1.  **调用技能**: `system-architect`
+2.  **使用系统识别框架**:
+    *   用户接触点 / 数据存储 / 核心逻辑 / 外部集成
+3.  **定义系统**:
+    *   ID / 职责 / 边界 / 依赖
+4.  **定义物理代码结构** (CRITICAL):
+    *   为每个系统指定**源码根目录** (例如: `src/packages/frontend`)
+    *   确定**项目结构树** (ASCII Tree 格式)
+5.  **输出**: 保存到 `genesis/v{N}/02_ARCHITECTURE_OVERVIEW.md`
+
+**人类检查点 #2** ⚠️:
+- 确认系统拆分合理性。
+
+---
+
+## Step 5: 架构决策 (Architecture Decisions) - Optional
+
+**目标**: 记录重大架构决策 (ADR)。
+
+1.  **识别决策**: 认证方式、通讯协议等。
+2.  **输出**: 保存到 `genesis/v{N}/03_ADR/ADR_00X_*.md`
+
+---
+
+## Step 6: 复杂度审计 (Complexity Audit) - Optional
+
+**目标**: 审核架构是否有过度设计。
+
+1.  **调用技能**: `complexity-guard`
+2.  **输出**: 审计报告 (内联或单独文件)。
+
+---
+
+## Step 7: 完成总结 (Completion Summary)
+
+**目标**: 总结产出，并**更新 .agent/rules/agents.md** 以反映新版本。
+
+> [!IMPORTANT]
+> **必须完成以下 3 个更新动作**:
+> 1. 更新 .agent/rules/agents.md "当前状态"
+> 2. 更新 .agent/rules/agents.md "项目结构"
+> 3. 更新 .agent/rules/agents.md "导航指南"
+
+### 7.1 更新 .agent/rules/agents.md
+
+使用 `replace_file_content` 或 `multi_replace_file_content`:
+
+**更新 "📍 当前状态"**:
+```markdown
+- **最新架构版本**: `genesis/v{N}`
+- **活动任务清单**: `尚未生成` (等待 /blueprint)
+- **最近一次更新**: `{YYYY-MM-DD}`
+```
+
+**更新 "🌳 项目结构"**:
+```markdown
+## 🌳 项目结构 (Project Tree)
+
+> **注意**: 此部分由 `/genesis` 维护。
+
+```text
+{项目根目录}/
+├── genesis/v{N}/          # 架构文档
+├── src/
+│   ├── {system-1}/        # 系统1 源码
+│   └── {system-2}/        # 系统2 源码
+└── ...
+```
+
+**更新 "🧭 导航指南"**:
+```markdown
+## 🧭 导航指南 (Navigation Guide)
+
+- **架构总览**: `genesis/v{N}/02_ARCHITECTURE_OVERVIEW.md`
+- **ADR**: 架构决策见 `genesis/v{N}/03_ADR/`
+- **详细设计**: 待 `/design-system` 执行后更新 (将填充 `genesis/v{N}/04_SYSTEM_DESIGN/`)
+- **任务清单**: 待 `/blueprint` 执行后更新 (将生成 `genesis/v{N}/05_TASKS.md`)
+```
+
+> [!NOTE]
+> 如果项目有已知系统，可使用以下格式替代上方"详细设计"行:
+> ```markdown
+> - **{System-1}**: 源码 `src/{path1}` → 设计 `genesis/v{N}/04_SYSTEM_DESIGN/{system-1}.md`
+> ```
+
+### 7.2 更新 00_MANIFEST.md
+
+将文档清单中的 checkbox 标记为已完成。
+
+### 7.3 展示产出
+
+告知用户阶段完成，列出产出文档，并指引下一步行动（design-system 或 blueprint）。
+
+<completion_criteria>
+- ✅ 创建了 `genesis/v{N}/00_MANIFEST.md`
+- ✅ 创建了 `genesis/v{N}/06_CHANGELOG.md`
+- ✅ 生成了 PRD, Architecture Overview, ADRs
+- ✅ 更新了 .agent/rules/agents.md (当前状态、项目结构、导航指南)
+- ✅ 用户已在人类检查点确认
+</completion_criteria>

package/templates/.agent/workflows/scout.md

@@ -0,0 +1,130 @@
+---
+description: 探测系统风险、隐藏耦合和"改了就炸"的暗坑，通过 Git 热点分析和 Gap Analysis 产出风险报告，适用于接手遗留项目或重大变更前。
+---
+
+# /scout
+
+<phase_context>
+你是 **Scout 2.0 - 结构拆解专家**。
+
+**核心使命**：
+在架构更新 (`genesis/v{N}`) 之前或之后，探测系统风险、暗坑和耦合。
+Scout 的发现将作为**输入**反馈给 Architectural Overview。
+
+**Output Goal**: `genesis/v{N}/00_SCOUT_REPORT.md`
+</phase_context>
+
+---
+
+## ⚠️ CRITICAL 流程约束
+
+> [!IMPORTANT]
+> Scout 不修改架构，只**观测**和**报告**。
+> 你的报告应该被 Genesis 过程参考。
+
+> [!NOTE]
+> **Scout 双模式说明**:
+> - **模式 A (Genesis 前)**: 侦察遗留代码，产出作为 genesis 的输入
+> - **模式 B (Genesis 后)**: 验证设计与代码的一致性 (Gap Analysis)
+> 
+> 判断方式: 如果 `genesis/v{N}/concept_model.json` 存在 → 模式 B，Step 5 执行对比  
+> 如果不存在 → 模式 A，Step 5 跳过对比，仅提取代码中的概念
+
+---
+
+## Step 1: 建立大局观 (System Fingerprint)
+
+1.  **扫描根目录**: 列出项目根目录下的所有文件和文件夹
+2.  **获取当前架构上下文** (Optional):
+    - 如果存在 `genesis/v{N}`，读取其 `02_ARCHITECTURE_OVERVIEW.md` 以对比"计划"与"现实"。
+
+---
+
+## Step 2: 拆解构建系统 (Build Topology)
+
+**目标**: 识别项目的构建边界和产物关系。
+
+1.  **调用技能**: `build-inspector`
+2.  **执行步骤**:
+    - 定位所有构建配置文件 (package.json, Cargo.toml, go.mod, Makefile 等)
+    - 判断是否有统一管理 (workspace/monorepo)
+    - 识别最终产物 (binary, bundle, docker image)
+3.  **输出要点**:
+    - Build Roots 列表
+    - 拓扑类型 (Monolith / Workspace / Polyrepo)
+    - ⚠️ 标记跨根依赖风险
+
+---
+
+## Step 3: 拆解运行时通信 (Runtime Topology)
+
+**目标**: 追踪进程间通信和契约状态。
+
+1.  **调用技能**: `runtime-inspector`
+2.  **执行步骤**:
+    - 识别所有入口点 (main 函数)
+    - 追踪进程生成链 (spawn/fork)
+    - 检测 IPC 通道和协议定义
+3.  **输出要点**:
+    - Process Roots 和 Spawning Chains
+    - Contract Status (Strong / Weak / None)
+    - ⚠️ 标记僵尸进程和协议漂移风险
+
+---
+
+## Step 4: 拆解历史耦合 (Temporal Topology)
+
+**目标**: 从 Git 历史发现隐藏的耦合关系。
+
+1.  **调用技能**: `git-forensics`
+2.  **执行步骤**:
+    - 分析变更频率和耦合对
+    - 交叉标注构建根信息
+    - 定位热点模块 (高 Churn × 高 Complexity)
+3.  **输出要点**:
+    - Coupling Pairs (标注构建根)
+    - Hotspots 和孤儿文件
+    - ⚠️ 重点标记跨根耦合
+
+---
+
+## Step 5: 领域概念建模 (Domain Concept Modeling)
+
+**目标**: 提取*当前代码实现中*的隐式概念。
+
+1.  **调用技能**: `concept-modeler`
+2.  **对比**: 将代码中的概念与 `genesis/v{N}/concept_model.json` 进行对比 (如果存在)。
+    - *Gap Analysis*: "文档里说有 User 实体，但代码里只有 Account 实体？"
+
+---
+
+## Step 6: 冲突与风险分析
+
+**目标**: 识别 "Change Impact"。
+
+1.  **如果你正在服务于一次 Genesis 更新**:
+    - 结合 `genesis/v{N}/01_PRD.md` (新需求)。
+    - 分析这些新需求会触碰哪些 "Landmines" (Git Hotspots)。
+
+---
+
+## Step 7: 生成报告
+
+**目标**: 保存带有时间戳的报告，防止覆盖历史记录。
+
+保存报告到 `genesis/v{N}/00_SCOUT_REPORT.md`
+
+（注意：如果版本不存在，默认为 v1）
+
+确保 `genesis/v{N}/` 目录存在。
+
+**报告必须包含**:
+1.  **System Fingerprint**
+2.  **Gap Analysis** (Document vs Code)
+3.  **Risk Matrix** (Hotspots, IPC Risks)
+
+<completion_criteria>
+- ✅ 建立了系统指纹
+- ✅ 发现了文档与代码的 Gap
+- ✅ 产出了带有时间戳的风险报告
+</completion_criteria>