@zeyue0329/xiaoma-cli 1.11.0 → 1.13.0

package/demo/xiaoma-prd-saas-zh/product-brief.md

@@ -0,0 +1,97 @@
+---
+stepsCompleted:
+  - step-01-init
+  - step-02-vision
+  - step-03-users
+  - step-04-metrics
+  - step-05-scope
+  - step-06-complete
+inputDocuments: []
+date: '2026-04-22'
+author: 张明远
+---
+
+# Product Brief: 灵协 Linkly
+
+## Vision
+
+**愿景：** 让中型企业的客户成功（CS）团队在统一画布上看见、解读并干预客户旅程，把流失预警的"发现到触达"从平均 7 天压到 24 小时内。
+
+**核心问题：** 中型企业 CS 团队同时使用 4-6 个系统（CRM、客服、数据看板、IM、工单、合同），客户信号分散，CSM 平均每天花 90 分钟手动汇集信息，流失预警延迟 5-7 天，单人服务客户数受限。
+
+**价值主张：**
+
+- 跨系统聚合的客户旅程视图，单页可视化 ≥ 12 个月历史
+- LLM 自动摘要近 30 天高风险对话，CSM 平均处理时间从 18 分钟降至 6 分钟
+- 风险评分与触达建议同源，CSM 单人服务客户数从 30 提升至 40
+
+**差异化：**
+
+- 唯一同时整合"旅程画布 + LLM 摘要 + 风险评分"三能力的国内 SaaS
+- 国内同类产品（聚客云、客成 Pro）只覆盖其中 1-2 项
+
+## Target Users
+
+主要用户（primary）：
+
+- **客户成功经理（CSM）** — 直接对客户健康度负责，每日检视高风险客户并介入
+- **客服主管** — 负责团队 KPI、SLA、人力调度
+- **数据分析师** — 季度健康度报告、流失预测模型迭代
+
+次要用户（secondary）：
+
+- **租户管理员（Admin）** — 配置权限、订阅、集成
+- **产品经理（PM）** — 月度功能反馈分析
+
+不在目标用户中：
+
+- 一线客服坐席（已有 Salesforce Service Cloud / 钉钉客服覆盖）
+- 销售团队（CRM 主战场，本产品仅消费 CRM 数据）
+
+## Success Metrics
+
+候选指标（PM 在 PRD §2 中需补全 baseline / target / measurement / window）：
+
+- 流失预警触达率：从 30% 提升至 ≥ 95%
+- CSM 单人服务客户数：从 30 提升至 40
+- LLM 摘要采纳率：人工标注后采纳 ≥ 80%
+- 月度 SLA：99.9%
+- 试点客户 NPS：≥ 45（季度调研）
+- 12 个月内付费客户数：≥ 80
+- 单客户平均合同金额（ACV）：≥ 18 万元/年
+
+## Scope
+
+**In-Scope（MVP，2026 H2 上线）：**
+
+- 客户档案管理：多源聚合 · 标签 · 检索
+- 旅程画布：单租户视图 · 12 个月历史 · 时间轴
+- 风险预警：3 类规则引擎 · 工单系统单向集成
+- AI 摘要：近 30 天对话摘要 · 触达建议
+- 工单整合：钉钉 / 飞书 / Salesforce 单向同步
+- 租户与权限：4 角色 RBAC · 基础订阅层级（Starter/Team/Business）
+
+**Out-of-Scope：**
+
+- 海外多语：首期客户均为国内中型企业，海外需求量 < 5%
+- 自营客服坐席系统：与现有合作伙伴 Salesforce/钉钉客服重叠
+- 自营 CRM：仅消费现有 CRM 数据，不替代
+- 移动原生 App：MVP 仅 Web；移动需求由 PWA 满足
+
+**Future Phases：**
+
+- Growth（2027 Q1）：客户健康度模型可调校 · 移动 PWA · 多 LLM 厂商抽象层
+- Vision（2027 H2+）：自动触达执行（IM 推送 / 邮件）· 跨租户行业基准对比 · 海外多语
+
+**Constraints：**
+
+- 团队规模：2026 H2 前 8 人（含 PM、设计、前端 2、后端 3、数据 1）
+- 预算：年化研发投入 ¥6M
+- 时间：2026 H2 上线，节点：2026/06 内测、2026/09 公测、2026/12 GA
+- 数据本地化：所有客户数据仅存储于中国大陆 IDC
+
+## Differentiation
+
+- 国内同类产品对比：见 market-research-2026-q1.md §3 竞争分析
+- 技术新颖度：LLM 摘要 + 风险评分 + 旅程画布的三位一体集成在国内为首
+- 核心壁垒：旅程画布的多源聚合管线（≥ 12 个月历史）+ 可解释风险评分模型

package/demo/xiaoma-prd-saas-zh/validation-report.md

@@ -0,0 +1,279 @@
+---
+workflowType: 'prd-validation'
+prdFile: ./prd.md
+prdVersion: '1.0.0'
+rubricFile: '../../src/xmc/workflows/2-plan-workflows/xiaoma-validate-prd/data/prd-quality-rubric.csv'
+validationIteration: 1
+date: '2026-05-08'
+verdict: 'pass'
+totalScore: 97.5
+gatePassed: true
+---
+
+# PRD Validation Report — 灵协 Linkly v1.0.0
+
+> 本报告是 [prd.md](./prd.md) 跑完 `xiaoma-validate-prd` 13 步校验后的得分卡，演示 `prd-quality-rubric.csv` 的 13 维量化打分逻辑。
+
+## Verdict
+
+| 项                | 值          | 备注                                                |
+| ----------------- | ----------- | --------------------------------------------------- |
+| **Total Score**   | 97.5 / 100  | 加权总分（partial 按 50% 权重计入）                 |
+| **Blockers Failed** | 0         | D05 / D06 / D08 / D10 全 pass                       |
+| **Verdict**       | **pass** ✅ | 无 blocker 且总分 ≥ 80                              |
+| Validation Iteration | 1 / 3    | 首轮即 pass，无需重试                               |
+| Gate Threshold    | 80          | 已通过                                              |
+
+可进入下游 `xiaoma-create-epics-and-stories` 工作流。
+
+---
+
+## 13 维得分卡
+
+| ID  | 维度                      | step_ref                                         | 权重 | 状态     | 得分    | 严重度  |
+| --- | ------------------------- | ------------------------------------------------ | ---- | -------- | ------- | ------- |
+| D01 | Discovery Completeness    | step-v-01-discovery                              | 5    | pass     | 5.0     | minor   |
+| D02 | Format & Parity           | step-v-02-format-detection + step-v-02b          | 6    | pass     | 6.0     | major   |
+| D03 | Information Density       | step-v-03-density-validation                     | 10   | pass     | 10.0    | major   |
+| D04 | Brief Coverage            | step-v-04-brief-coverage-validation              | 8    | pass     | 8.0     | major   |
+| D05 | **Measurability**         | step-v-05-measurability-validation               | 12   | pass     | 12.0    | blocker |
+| D06 | **Traceability**          | step-v-06-traceability-validation                | 12   | pass     | 12.0    | blocker |
+| D07 | Implementation Leakage    | step-v-07-implementation-leakage-validation      | 8    | pass     | 8.0     | major   |
+| D08 | **Domain Compliance**     | step-v-08-domain-compliance-validation           | 10   | pass     | 10.0    | blocker |
+| D09 | Project-Type Fit          | step-v-09-project-type-validation                | 7    | pass     | 7.0     | major   |
+| D10 | **SMART (FR/NFR)**        | step-v-10-smart-validation                       | 12   | pass     | 12.0    | blocker |
+| D11 | Holistic Quality          | step-v-11-holistic-quality-validation            | 5    | partial  | 2.5     | minor   |
+| D12 | Completeness              | step-v-12-completeness-validation                | 5    | pass     | 5.0     | major   |
+| D13 | Dual-Audience Readiness   | step-v-13-report-complete (fused)                | 0    | pass     | (info)  | minor   |
+|     |                           | **TOTAL**                                        | 100  |          | **97.5**|         |
+
+---
+
+## 维度详情
+
+### D01 Discovery Completeness — pass
+
+- inputDocuments：3 个文件全部加载成功（product-brief.md / market-research-2026-q1.md / domain-research.md）
+- frontmatter `workflowType: 'prd'`：✅
+- frontmatter `templateVersion: '2.0-m1'`：✅
+
+### D02 Format & Parity — pass
+
+9 个必需章节全部以 `## N. <Name>` 形式存在：
+
+```
+## 1. Executive Summary
+## 2. Success Criteria
+## 3. Product Scope
+## 4. User Journeys
+## 5. Domain Requirements
+## 6. Innovation Analysis
+## 7. Project-Type Requirements
+## 8. Functional Requirements
+## 9. Non-Functional Requirements
+```
+
+格式：XiaoMa 2.0-m1（无需 parity check）。
+
+### D03 Information Density — pass
+
+| 信号关键词        | 命中数 | 阈值 |
+| ----------------- | ------ | ---- |
+| 打造              | 0      | < 3  |
+| 业界领先          | 0      | < 3  |
+| 一站式            | 0      | < 3  |
+| 赋能              | 0      | < 3  |
+| 数字化转型        | 0      | < 3  |
+| 智能化            | 0      | < 3  |
+| 全方位            | 0      | < 3  |
+| the system will   | 0      | < 3  |
+| in order to       | 0      | < 3  |
+| **Total fluff/100 lines** | **0** | **< 3** |
+
+§1 Executive Summary 直接量化（"7 天压到 24 小时"），无口号化。
+
+### D04 Brief Coverage — pass
+
+`contract-check.json` 验证通过：
+
+```json
+{
+  "passed": true,
+  "missing_required": [],
+  "missing_conditional": [],
+  "applied_policies": {},
+  "tbds": []
+}
+```
+
+product-brief.md 中所有 `required: yes` 字段均映射到 PRD 对应章节：
+
+| Brief 字段              | PRD 章节                                                        |
+| ----------------------- | --------------------------------------------------------------- |
+| vision_statement        | §1 Executive Summary（行 24）                                   |
+| core_problem            | §1 Executive Summary（行 26）                                   |
+| target_personas         | §1 + §4 全部 4 个 journey（CSM/Manager/分析师/Admin）            |
+| value_propositions      | §1 价值主张三条                                                 |
+| success_metrics_draft   | §2（SC-01..08 全覆盖 brief 中候选指标 + 添加 baseline/target）  |
+| mvp_scope               | §3 MVP 列表                                                     |
+| out_of_scope            | §3 Out-of-Scope（6 条）                                         |
+| differentiation         | §1 What Makes Special + §6 Innovation Analysis                  |
+
+### D05 Measurability — pass（blocker）
+
+**FR 分析（24 条）：**
+
+| 检查项               | 违规数 |
+| -------------------- | ------ |
+| 格式 `[Actor] can`   | 0      |
+| 主观形容词           | 0      |
+| 模糊量词             | 0      |
+| 实现泄漏             | 0      |
+| **FR violations**    | **0**  |
+
+**NFR 分析（10 条）：**
+
+| 检查项                   | 违规数 |
+| ------------------------ | ------ |
+| 缺测量方法               | 0      |
+| 缺数值阈值               | 0      |
+| 缺前置条件               | 0      |
+| **NFR violations**       | **0**  |
+
+总违规数 = 0（< 5 阈值），状态 pass。
+
+### D06 Traceability — pass（blocker）
+
+§Traceability Matrix（[prd.md 行 314-339](./prd.md)）含 24 行：
+
+- 24/24 FR 含 `Maps to Vision`
+- 22/24 FR 含 `Maps to Success Criteria`（FR-PROFILE-04 / FR-JOURNEY-04 / FR-RISK-04 / FR-SUMMARY-04 / FR-TENANT-01 / FR-TENANT-03 标注 "-" — Admin/Manager 配置类 FR 无直接 SC 映射，已合理化）
+- 24/24 FR 含 `Maps to Journey Step`
+
+无空 mapping 比例：0% < 20% 阈值，pass。
+
+### D07 Implementation Leakage — pass
+
+跨 §1, §2, §4, §8 扫描技术栈关键词：
+
+| 关键词             | §1 | §2 | §4 | §8 |
+| ------------------ | -- | -- | -- | -- |
+| Redis/Postgres/...  | 0 | 0  | 0  | 0  |
+| React/Vue/...       | 0 | 0  | 0  | 0  |
+| Docker/K8s/...      | 0 | 0  | 0  | 0  |
+| AWS/GCP/Azure       | 0 | 0  | 0  | 0  |
+
+§7 Project-Type Requirements 出现 "K8s HPA"（NFR-SCALE-02）属于可接受位置（基础设施约束）。
+
+### D08 Domain Compliance — pass（blocker）
+
+domain 检测：`general` + medium complexity（来自 frontmatter `domainTier: 'medium'` + project_type saas_b2b）。
+
+`domain-complexity.csv` 对 `general` 域要求 `special_sections: standard_requirements`。
+PRD §5 含 6 条具体可验证条款（5.1.1-5.1.6），且 §5.2 行业术语表 + §5.3 外部依赖均完整。
+
+虽然 domain=general 不是 high-complexity，但 PRD 主动覆盖了等保二级 + 个保法 + 数据本地化 + 审计日志 + 数据备份 + 数据导出 + 数据删除 7 个合规维度，超出 general 域要求。
+
+### D09 Project-Type Fit — pass
+
+`project-types.csv` 中 `saas_b2b` 行的 `required_sections`：
+
+```
+tenant_model;rbac_matrix;subscription_tiers;integration_list;compliance_reqs
+```
+
+PRD §7 覆盖：
+
+| required_section    | §7 子节                  | 状态 |
+| ------------------- | ------------------------ | ---- |
+| tenant_model        | §7.1 多租户模型          | ✅   |
+| rbac_matrix         | §7.2 RBAC 角色矩阵       | ✅   |
+| subscription_tiers  | §7.3 订阅层级            | ✅   |
+| integration_list    | §7.4 集成清单（MVP）     | ✅   |
+| compliance_reqs     | §7.6 合规需求摘要        | ✅   |
+
+`skip_sections: cli_interface;mobile_first` — PRD 在 §3 Out-of-Scope 明确"MVP 仅 Web，移动需求由 PWA 满足"，已显式处理。
+
+### D10 SMART (FR/NFR) — pass（blocker）
+
+| FR/NFR 总数 | Specific | Measurable | Attainable | Relevant | Traceable | 复合需求 |
+| ----------- | -------- | ---------- | ---------- | -------- | --------- | -------- |
+| FR (24)     | 24/24    | 24/24      | 24/24      | 24/24    | 24/24     | 0        |
+| NFR (10)    | 10/10    | 10/10      | 10/10      | 10/10    | 10/10     | 0        |
+
+无单条 FR 含 `且|并|同时|以及`。所有 NFR 含 baseline + threshold + measurement method。
+
+### D11 Holistic Quality — partial ⚠️
+
+发现 1 处轻度跨节不一致：
+
+- §3 Out-of-Scope 列出 "自动触达执行（自动外呼 / 自动 IM）：MVP 仅生成建议，CSM 手动确认后执行"
+- §8.5 工单整合 包含 FR-TICKET-02（系统同步工单到外部）— 同步工单本身可视为"系统侧自动触达"
+- 风险：读者可能将 FR-TICKET-02 误读为"自动触达执行"被偷偷加回 MVP
+
+建议：在 §3 Out-of-Scope 第一条加注释，明确"自动触达执行"特指对客户的主动外呼/IM 推送，不含工单同步动作。修正后可升级为 pass。
+
+权重计算：5 × 50% = 2.5（partial 折半）。
+
+### D12 Completeness — pass
+
+| 章节                | 字符数 | 阈值     | 状态    |
+| ------------------- | ------ | -------- | ------- |
+| §1 Executive Summary| ~750   | > 200    | ✅      |
+| §2 Success Criteria | ~620   | > 200    | ✅      |
+| §3 Product Scope    | ~960   | > 200    | ✅      |
+| §4 User Journeys    | ~1850  | > 200    | ✅      |
+| §5 Domain Reqs      | ~1100  | > 200    | ✅      |
+| §6 Innovation       | ~580   | > 200    | ✅      |
+| §7 Project-Type     | ~880   | > 200    | ✅      |
+| §8 FR (24 items)    | ~1500  | > 200    | ✅      |
+| §9 NFR (10 items)   | ~720   | > 200    | ✅      |
+
+frontmatter 完整性：所有 M1 新增字段 (`templateVersion`, `densityLevel`, `domainTier`, `projectType`, `version`) 均填写。
+
+无残留 `{{...}}` 占位。
+
+### D13 Dual-Audience Readiness — pass（informational）
+
+| 检查项                                   | 状态 |
+| ---------------------------------------- | ---- |
+| Skim — 仅看 ## 头能理解结构              | ✅   |
+| Skip — 每节有 1-2 句开场总结             | ✅   |
+| Scan — 表格/列表/加粗承载密度数据        | ✅   |
+| Chunk — 一段一概念                       | ✅   |
+| Anchor — 所有 §N / FR-AREA-NN 引用一致   | ✅   |
+| Cite — 跨引使用全 ID                     | ✅   |
+| Forward-reference free                   | ✅   |
+| Section-local terminology                | ✅   |
+
+8/8 通过。informational 维度，不计入加权得分。
+
+---
+
+## 修复建议（按优先级）
+
+| # | 维度  | 问题                                       | 建议                                                                                  | 工作量 |
+| - | ----- | ------------------------------------------ | ------------------------------------------------------------------------------------- | ------ |
+| 1 | D11   | §3 自动触达描述与 §8.5 工单同步可能混淆    | §3 第一条 Out-of-Scope 加注释，明确"自动触达"特指对客户主动外呼/IM 推送，不含工单同步 | XS     |
+
+修复后预期总分：100 / 100。
+
+---
+
+## 与 prd-bad-examples.md 的对比
+
+将 [prd-bad-examples.md](./prd-bad-examples.md) 中 8 个反模式片段拼成的"坏 PRD"喂给同一份 rubric，预期得分卡完全不同：
+
+| 维度 | good 版本（本报告） | bad 版本（预期）       |
+| ---- | ------------------- | ---------------------- |
+| D03  | pass (10)           | partial (5) — AP-01 命中  |
+| D05  | pass (12)           | **fail (0)** — blocker |
+| D06  | pass (12)           | **fail (0)** — blocker |
+| D07  | pass (8)            | major (4) — Redis/React |
+| D08  | pass (10)           | **fail (0)** — blocker |
+| D10  | pass (12)           | **fail (0)** — blocker |
+| ...  | ...                 | ...                    |
+| 总分 | 97.5                | < 50                   |
+| Verdict | **pass**          | **reject**（≥ 4 blockers） |
+
+这一对比是 rubric 设计的核心校准目标。

package/docs/roadshow/01-/351/241/271/347/233/256/346/246/202/350/247/210/344/270/216/346/236/266/346/236/204.md

@@ -0,0 +1,189 @@
+# XiaoMa-CLI 项目概览与架构
+
+## 1. 项目定位与价值主张
+
+XiaoMa-CLI (`@zeyue0329/xiaoma-cli`) 是一个 AI 驱动的敏捷开发框架/CLI 工具。它将专业化的 AI 智能体角色、工作流和技能安装到用户的项目目录中，与 AI IDE（Claude Code、Cursor 等）协同工作。
+
+**核心价值：**
+
+- 将软件开发全生命周期（需求 → 设计 → 架构 → 开发 → 测试 → 交付）全面 AI 化
+- 9 个专业智能体协同，模拟真实敏捷团队
+- 26 个结构化工作流覆盖开发全阶段
+- 支持 25+ 主流 AI IDE 平台
+- 一键安装，即插即用
+
+---
+
+## 2. 整体架构
+
+XiaoMa-CLI 采用**两层架构**设计，将内容与工具彻底分离，确保高扩展性和可维护性。
+
+```mermaid
+graph TB
+    subgraph ContentLayer["内容层 (src/)"]
+        subgraph CoreModule["Core 模块"]
+            CS["核心技能<br/>12个"]
+            CT["核心任务<br/>创建PRD等"]
+        end
+        subgraph XMCModule["XMC 模块 - 小马敏捷方法"]
+            AG["智能体<br/>9个"]
+            WF["工作流<br/>26个"]
+            TM["团队定义"]
+        end
+    end
+
+    subgraph ToolLayer["工具层 (tools/)"]
+        subgraph CLITools["CLI 命令行工具"]
+            CMD["命令系统<br/>install / status / uninstall"]
+            INS["安装器<br/>模块管理 / 配置收集 / 清单生成"]
+            IDE["IDE 管理器<br/>25+ 平台适配"]
+        end
+        SCH["Schema 验证<br/>Zod"]
+        FLT["代码扁平化工具"]
+    end
+
+    CS --> CMD
+    CT --> CMD
+    AG --> CMD
+    WF --> CMD
+    AG --> SCH
+    CMD --> IDE
+    INS --> IDE
+```
+
+**架构要点：**
+
+- **内容层**负责定义"做什么"——智能体的角色、工作流的步骤、技能的能力
+- **工具层**负责实现"怎么做"——CLI 交互、文件安装、Schema 校验、IDE 适配
+- 两层通过模块系统（`module.yaml`）连接，支持独立扩展
+
+---
+
+## 3. 模块系统
+
+模块是 XiaoMa-CLI 的核心组织单元，每个模块通过 `module.yaml` 定义配置变量、提示语和目录声明。
+
+### Core 模块 (src/core/)
+
+- **模块代码：** `core`
+- **职责：** 提供基础技能和通用任务
+- **配置收集：** 用户名称、沟通语言、文档输出语言、输出目录
+- **12 个核心技能：** brainstorming、distillator、party-mode、editorial-review 等
+
+### XMC 模块 (src/xmc/) — 小马敏捷方法
+
+- **模块代码：** `xmc`
+- **职责：** 提供完整的敏捷开发智能体和工作流
+- **配置收集：** 项目名称、用户技能等级、规划产物路径、实施产物路径
+- **自动创建目录结构：** `planning_artifacts`、`implementation_artifacts`、`project_knowledge`
+
+---
+
+## 4. CLI 安装流程
+
+以下时序图展示了用户执行 `npx xiaoma-cli install` 时的完整安装流程：
+
+```mermaid
+sequenceDiagram
+    participant U as 用户
+    participant CLI as xiaoma-cli
+    participant DET as 安装检测器
+    participant CFG as 配置收集器
+    participant MOD as 模块管理器
+    participant MAN as 清单生成器
+    participant IDE as IDE管理器
+
+    U->>CLI: npx xiaoma-cli install
+    CLI->>DET: 检测已有安装
+    DET-->>CLI: 安装状态
+    CLI->>CFG: 收集用户配置
+    CFG->>U: 交互式提问（项目名/语言/路径等）
+    U-->>CFG: 配置回答
+    CFG-->>CLI: 配置数据
+    CLI->>MOD: 安装模块（core + xmc）
+    MOD->>MOD: 复制文件 + 占位符替换
+    MOD->>MOD: 处理智能体 Sidecar
+    MOD-->>CLI: 模块安装完成
+    CLI->>MAN: 生成 CSV 清单
+    MAN->>MAN: agent-manifest / workflow-manifest / files-manifest
+    MAN-->>CLI: 清单生成完成
+    CLI->>IDE: 安装到选定 IDE
+    IDE->>IDE: 技能文件写入 .claude/skills/ 等
+    IDE-->>CLI: IDE 配置完成
+    CLI-->>U: 安装成功
+```
+
+**关键步骤说明：**
+
+1. **安装检测** — 自动识别项目中是否已安装 XiaoMa，支持升级和重装
+2. **配置收集** — 通过 `@clack/prompts` 提供交互式终端体验，收集项目和用户配置
+3. **模块安装** — 按依赖顺序安装 core 和 xmc 模块，执行占位符替换和 Sidecar 处理
+4. **清单生成** — 生成三份 CSV 清单（智能体/工作流/文件），用于运行时查询和完整性校验
+5. **IDE 配置** — 根据用户选择的 IDE 平台，写入对应的技能文件和配置
+
+---
+
+## 5. 支持的 IDE 平台
+
+XiaoMa-CLI 采用**配置驱动**的 IDE 适配方案，通过 `platform-codes.yaml` 统一管理所有平台，无需为每个 IDE 编写定制代码。
+
+| 类别 | 平台 | 优先级 |
+|------|------|--------|
+| CLI | Claude Code | ⭐ 首选 |
+| IDE | Cursor | ⭐ 首选 |
+| IDE | Cline, Windsurf, Roo Code | 支持 |
+| IDE | Codex, OpenCode | 支持 |
+| 云端 | Google Antigravity, Kiro, Rovo Dev | 支持 |
+| CLI | Auggie, Gemini, Pi | 支持 |
+| 其他 | CodeBuddy, Crush, GitHub Copilot, iFlow, Trae 等 | 支持 |
+
+> 所有 IDE 的安装均通过 `platform-codes.yaml` 配置驱动，无需为单个 IDE 编写定制代码。新增 IDE 支持只需添加配置条目。
+
+---
+
+## 6. 技术栈
+
+| 技术 | 用途 |
+|------|------|
+| Node.js >= 20 | 运行时环境 |
+| Commander.js | CLI 命令框架 |
+| @clack/prompts | 交互式终端 UI |
+| Zod | Schema 验证（智能体 YAML 校验） |
+| YAML | 配置和智能体定义格式 |
+| Markdown | 工作流和技能定义格式 |
+| Mermaid | 文档图表渲染 |
+| ESLint + Prettier | 代码质量与格式化 |
+| Husky + lint-staged | Git 钩子自动化 |
+
+---
+
+## 7. 项目安装后目录结构
+
+以下展示了 XiaoMa-CLI 安装完成后，在用户项目中生成的目录结构：
+
+```
+{项目根目录}/
+├── _xiaoma/                       # 安装目录
+│   ├── core/config.yaml           # 核心配置
+│   ├── xmc/config.yaml            # XMC 模块配置
+│   ├── _config/                   # 清单文件
+│   │   ├── manifest.yaml          # 安装元数据
+│   │   ├── agent-manifest.csv     # 智能体注册表
+│   │   ├── workflow-manifest.csv  # 工作流注册表
+│   │   └── files-manifest.csv     # 文件完整性清单
+│   └── _memory/                   # 智能体记忆（Sidecar）
+├── _xiaoma-output/                # 产出目录
+│   ├── planning-artifacts/        # 规划产物（PRD/架构/史诗等）
+│   └── implementation-artifacts/  # 实施产物（Sprint/Story等）
+├── .claude/skills/                # Claude Code 技能
+├── .cursor/skills/                # Cursor 技能
+└── docs/                          # 项目知识库
+```
+
+**目录说明：**
+
+- **`_xiaoma/`** — XiaoMa 框架核心安装目录，包含所有智能体、工作流、技能定义和配置
+- **`_xiaoma/_config/`** — 安装清单和元数据，用于运行时查询和 `status` 命令
+- **`_xiaoma/_memory/`** — 智能体 Sidecar 记忆文件，支持跨会话上下文保持
+- **`_xiaoma-output/`** — 标准化的产出目录，分为规划阶段和实施阶段两大类
+- **`.claude/skills/` / `.cursor/skills/`** — 各 IDE 平台的技能入口文件