adspecs 0.1.19 → 0.1.21

package/README.md

@@ -1,395 +1,395 @@
-# AdSpecs — AI 工程研发协同插件
-
-[![npm version](https://img.shields.io/npm/v/adspecs)](https://www.npmjs.com/package/adspecs)
-[![npm downloads](https://img.shields.io/npm/dt/adspecs)](https://www.npmjs.com/package/adspecs)
-
----
-
-## 简介
-
-AdSpecs 是一个基于 Claude Code 的 AI 工程研发协同插件，提供：
-
-- **21 个 Skill**（Slash 命令） — 覆盖需求分析、架构规划、系统设计、任务拆解、单元测试、代码审查、文档导出、Wiki 同步
-- **CLI 工具** — `adspecs init` 一键脚手架、`adspecs plugin install` 插件注册、`adspecs doctor` 环境检查
-- **21 个标准文档模板** — 需求 / 设计 / 任务 / 测试 / 评审 / 架构全覆盖
-- **多技术栈参考** — ECP Java 后端、Vue 3 前端、Ant Design React 前端、Python 后端等 11 套参考工程
-- **npm 分发** — `npm install -g adspecs` 即装即用
-
-本插件需配合 [`superpowers`](https://github.com/anthropics/claude-plugins-official) 插件（提供 TDD、子代理驱动开发等通用 Skill）一起使用。
-
----
-
-## 项目结构
-
-```
-adspecs/
-├── bin/adspecs.js                  # CLI 入口
-├── src/                            # CLI 核心代码
-│   ├── commands/                   #   init / plugin / doctor / update
-│   └── lib/                        #   scaffolder / prompts / report 等
-├── skills/                         # 21 个 Skill 定义
-├── .claude-plugin/                 # Claude Code 插件清单
-├── .qoder-plugin/                  # Qoder 插件清单
-├── .adspecs/
-│   ├── templates/                  #   21 个标准文档模板
-│   ├── extensions/                 #   扩展配置（git hooks 等）
-│   ├── scripts/                    #   辅助脚本（bash/powershell/python）
-│   ├── feature.json                #   功能追踪模板
-│   └── project.json                #   项目元数据模板
-├── hooks/                          # Node.js 钩子脚本
-├── references/                     # 11 套参考工程与编码规范
-├── scripts/                        # 构建脚本（postinstall/sync-version）
-├── package.json
-├── CLAUDE.md
-├── INSTALL.md
-└── README.md
-```
-
----
-
-## 快速开始
-
-### 1. 安装
-
-```bash
-# 全局安装 CLI
-npm install -g adspecs
-
-# 在 Claude Code 中注册插件（用户级，全局生效）
-adspecs plugin install
-
-# 或仅注册到当前项目（团队级）
-cd your-project
-adspecs plugin install --scope project
-```
-
-### 2. 初始化项目
-
-```bash
-# 交互式初始化
-adspecs init
-```
-
-### 3. 开始使用 Skill
-
-```
-/adspecs-new-requirement CRM 销售预测模块
-/adspecs-prd docs/00-customer-requirements/...
-/adspecs-plan docs/20-prd/crm/...
-...
-```
-
----
-
-## CLI 工具
-
-安装后提供 `adspecs` 命令行工具：
-
-| 命令                       | 说明                                                  | 示例                                     |
-| -------------------------- | ----------------------------------------------------- | ---------------------------------------- |
-| `adspecs init`             | 交互式初始化项目结构（docs/、templates/、前端模板等） | `adspecs init --mode simple`             |
-| `adspecs plugin install`   | 注册为 Claude Code 插件                               | `adspecs plugin install --scope project` |
-| `adspecs plugin uninstall` | 从 Claude Code 卸载插件                               | `adspecs plugin uninstall --scope user`  |
-| `adspecs doctor`           | 检查环境依赖（Node.js、git、Python 等）               | `adspecs doctor`                         |
-| `adspecs update`           | 升级到最新版本                                        | `adspecs update --version 0.2.0`         |
-
-### `adspecs init` 参数
-
-| 参数                        | 说明                                                  | 默认值     |
-| --------------------------- | ----------------------------------------------------- | ---------- |
-| `--project-name <name>`     | 项目名称                                              | 交互输入   |
-| `--project-dir <dir>`       | 项目目录（留空=当前目录）                             | 当前目录   |
-| `--mode <mode>`             | 初始化模式：`simple` \| `classic` \| `full` \| `demo` | 交互选择   |
-| `--front-demo <stack>`      | 前端演示技术栈：`vue` \| `antd`                       | `vue`      |
-| `--company <name>`          | 公司名称                                              | —          |
-| `--confidentiality <level>` | 文件密级：`公开` \| `内部资料` \| `机密` \| `绝密`    | `内部资料` |
-| `--modules <list>`          | 后端模块列表（逗号分隔）                              | —          |
-| `--non-interactive`         | 非交互模式，使用默认值                                | —          |
-| `--force`                   | 已存在区域直接重建                                    | —          |
-| `-y, --yes`                 | 自动确认执行                                          | —          |
-
----
-
-## Skills 总览（21 个）
-
-按职责分为六类：
-
-### 一、项目初始化（CLI 命令）
-
-| 命令           | 说明                                                                           |
-| -------------- | ------------------------------------------------------------------------------ |
-| `adspecs init` | 交互式初始化项目结构：`docs/` 文档树、前端模板、后端模块、编码规范、标准模板等 |
-
-初始化后生成：
-
-- `docs/10-architecture/` — 架构规划
-- `docs/20-prd/` — 产品需求说明书
-- `docs/30-system-design/` — 系统设计 + SQL + 前端设计 + 任务清单
-- `docs/40-project_conventions/` — 编码规范
-- `.adspecs/templates/` — 21 个标准模板
-- `.adspecs/paths.json` — 可自定义的输出路径配置
-
-### 二、需求分析与架构规划（5 个）
-
-| Skill                           | 说明                                             | 输入                | 输出                             |
-| ------------------------------- | ------------------------------------------------ | ------------------- | -------------------------------- |
-| `adspecs-new-requirement`       | 深度业务需求分析（六步结构 + 模拟评审）          | 业务需求描述        | `docs/00-customer-requirements/` |
-| `adspecs-biz-blueprint`         | 将需求分析转化为 F1~F6 业务方案文件体系          | 业务需求分析文档    | `docs/00-customer-requirements/` |
-| `adspecs-prd`                   | 从自然语言 / 调研材料生成 PRD                    | 调研材料 / 原始需求 | `docs/20-prd/`                   |
-| `adspecs-clarify`               | 识别 PRD 模糊点（≤5 个）并澄清                   | 需求规格说明书      | 更新后的规格说明书               |
-| `adspecs-architecture-planning` | 平台级架构规划（功能架构 → 模块依赖 → 数据建模） | 项目 / 业务描述     | `docs/10-architecture/`          |
-
-### 三、SOW / 设计 / 任务（5 个）
-
-| Skill                 | 说明                                  | 输入            | 输出                                  |
-| --------------------- | ------------------------------------- | --------------- | ------------------------------------- |
-| `adspecs-write-sow`   | 根据项目 / 合同信息生成工作说明书     | 项目 / 合同信息 | `docs/05-sow/`                        |
-| `adspecs-plan`        | 后端统一系统设计（OOA+OOD）+ 建表 SQL | PRD             | `docs/30-system-design/` design + SQL |
-| `adspecs-front-spec`  | 前端功能设计（UI/交互规格）           | PRD + 系统设计  | `docs/30-system-design/` 前端设计     |
-| `adspecs-tasks`       | 后端 TDD 任务清单                     | 系统设计文档    | `docs/30-system-design/` tasks.md     |
-| `adspecs-front-tasks` | 前端 TDD 任务清单                     | 前端设计文档    | `docs/30-system-design/` tasks.md     |
-
-### 四、质量保障与测试（3 个）
-
-| Skill                        | 说明                                                                |
-| ---------------------------- | ------------------------------------------------------------------- |
-| `adspecs-analyze`            | 跨文档（PRD / 系统设计 / tasks）全链路 13 维一致性分析              |
-| `adspecs-adversarial-review` | 对抗式审查：5 个红队角色挑战文档假设、缺失、矛盾与歧义              |
-| `adspecs-utest`              | 基于系统设计生成 Service / Controller 层 JUnit 5 单元测试代码及报告 |
-
-### 五、交付与运维（5 个）
-
-| Skill                   | 说明                                               |
-| ----------------------- | -------------------------------------------------- |
-| `adspecs-update-status` | 更新 feature.json 功能状态 + 输出追踪矩阵          |
-| `adspecs-export-word`   | Markdown 导出为 Word（.docx），自动生成封面 + 目录 |
-| `adspecs-git-commit`    | 各阶段完成后自动提交变更                           |
-| `sie-front-code-review` | 前端专项评审（React + TypeScript + Ant Design）    |
-| `wiki-update`           | 将 docs/ 同步到 wiki/（全量 / 增量模式）           |
-
-### 六、产品规划（2 个）
-
-| Skill                           | 说明                                 |
-| ------------------------------- | ------------------------------------ |
-| `adspecs-write-planning-report` | 汇总调研期分析输出，生成产品规划报告 |
-| `adspecs-write-roadmap`         | 版本路标维护，追写 roadmap.md        |
-
-### 编码阶段依赖（superpowers 插件）
-
-| 外部 Skill                       | 说明                             |
-| -------------------------------- | -------------------------------- |
-| `subagent-driven-development`    | 子代理驱动并行开发               |
-| `test-driven-development`        | RED → GREEN → REFACTOR TDD 循环  |
-| `dispatching-parallel-agents`    | 并行子代理调度                   |
-| `finishing-a-development-branch` | 分支收尾（PR / merge / cleanup） |
-| `verification-before-completion` | 完成前最终验证                   |
-
----
-
-## 模板体系（21 个）
-
-初始化后位于 `.adspecs/templates/`：
-
-| 模板                         | 用途                        | 阶段 |
-| ---------------------------- | --------------------------- | ---- |
-| `01-业务需求分析模板.md`     | 业务需求分析（六步结构）    | 需求 |
-| `02-产品需求说明书模板.md`   | 产品需求说明书（PRD）       | 需求 |
-| `03-系统设计模板.md`         | 后端统一系统设计（OOA+OOD） | 设计 |
-| `04-前端功能设计模板.md`     | 前端功能规格（UI/交互）     | 设计 |
-| `05-后端任务清单模板.md`     | 后端 TDD 任务清单           | 任务 |
-| `05b-前端任务清单模板.md`    | 前端 TDD 任务清单           | 任务 |
-| `06-代码评审报告模板.md`     | 代码评审报告                | 审查 |
-| `07-单元测试报告模板.md`     | 单元测试报告                | 测试 |
-| `08-系统集成测试报告模板.md` | 集成测试报告                | 测试 |
-| `09-性能测试报告模板.md`     | 性能测试报告                | 测试 |
-| `10-安全检查清单.md`         | 安全检查清单                | 审查 |
-| `11-代码质量标准.md`         | 代码质量标准                | 审查 |
-| `13-测试用例模板.md`         | 测试用例                    | 测试 |
-| `14-需求追溯矩阵模板.md`     | 需求 → 实现追溯矩阵         | 审查 |
-| `15-业务功能架构文档模板.md` | 业务功能架构规划            | 架构 |
-| `16-系统架构设计模板.md`     | 系统架构设计                | 架构 |
-| `17-子模块依赖关系模板.md`   | 子模块依赖关系              | 架构 |
-| `18-统一数据模型模板.md`     | 统一数据建模（含 ER 图）    | 架构 |
-| `19-项目目录结构模板.md`     | 项目目录结构规划            | 架构 |
-| `20-工作说明书SOW模板.md`    | 工作说明书（SOW）           | 需求 |
-| `21-业务方案模板.md`         | 业务方案（F1~F6 文件体系）  | 需求 |
-
-> **约定**：所有模板通过对应 Skill 调用生成，不建议直接手工填写。
-
----
-
-## 参考工程（11 套）
-
-`references/` 目录包含 `adspecs init` 时按需复制到目标项目的参考代码和规范：
-
-| 目录                           | 说明                                           |
-| ------------------------------ | ---------------------------------------------- |
-| `docs/40-project_conventions/` | ECP 编码标准（后端 Java + 前端集成）           |
-| `front-demo/`                  | Vue 3 前端演示项目（Vite + TS + Element Plus） |
-| `antd-front-demo/`             | Ant Design React 前端演示项目                  |
-| `ant6-front-standard/`         | Ant Design 6 前端编码规范（9 篇）              |
-| `ecp-end-standard/`            | ECP 后端编码规范                               |
-| `ecp-front-standard/`          | ECP 前端编码规范                               |
-| `iidp-end-standard/`           | IIDP 后端编码规范                              |
-| `iidp-front-standard/`         | IIDP 前端编码规范                              |
-| `web-ui/`                      | ECP 管理控制台外壳工程                         |
-| `python/`                      | Python 后端参考                                |
-| `yudaocloud-end-standard/`     | 芋道 Cloud 后端集成参考                        |
-
----
-
-## 推荐开发流程
-
-```
-[adspecs init]                        →  项目脚手架
-         ↓
-[adspecs-architecture-planning]       →  平台架构规划（功能架构→依赖→数据模型）
-         ↓
-[adspecs-new-requirement]             →  深度业务需求分析
-         ↓
-[adspecs-biz-blueprint]               →  业务方案（F1~F6 文件体系）
-         ↓
-[adspecs-prd + adspecs-clarify]       →  产品需求说明书 + 澄清迭代
-         ↓
-[adspecs-plan / adspecs-front-spec]   →  后端设计+SQL / 前端设计
-         ↓
-[adspecs-tasks / adspecs-front-tasks] →  后端 / 前端 TDD 任务清单
-         ↓
-[adspecs-analyze + adversarial-review]→  一致性与质量审查
-         ↓
-[TDD + subagent-driven-development]   →  编码实现（依赖 superpowers）
-         ↓
-[adspecs-utest]                       →  单元测试 + 报告
-         ↓
-[sie-front-code-review]               →  前端代码审查
-         ↓
-[adspecs-update-status]               →  功能状态追踪
-         ↓
-[adspecs-export-word / wiki-update]   →  文档导出 + Wiki 同步
-```
-
-### 完整示例：销售预测从零到交付
-
-```txt
-# 1. 初始化项目
-adspecs init --project-name my-crm --mode classic
-
-# 2. 平台架构规划
-/adspecs-architecture-planning 华峰铝业CRM，覆盖销售全生命周期
-
-# 3. 深度需求分析
-/adspecs-new-requirement CRM 销售预测模块
-
-# 4. 业务方案
-/adspecs-biz-blueprint docs/00-customer-requirements/...
-
-# 5. 生成 PRD
-/adspecs-prd 预测单需求调研.md
-
-# 6. 澄清 + 评审（2~3 轮）
-/adspecs-clarify docs/20-prd/crm/sales-forecast/M06-01_销售预测需求规格说明书.md
-
-# 7. 后端系统设计 + SQL
-/adspecs-plan docs/20-prd/crm/sales-forecast/M06-01_销售预测需求规格说明书.md
-
-# 8. 前端设计
-/adspecs-front-spec docs/20-prd/crm/sales-forecast/M06-01_销售预测需求规格说明书.md
-
-# 9. 生成任务清单
-/adspecs-tasks docs/30-system-design/crm/M06-01-销售预测_system-design.md
-/adspecs-front-tasks docs/30-system-design/crm/M06-01_销售预测_前端设计.md
-
-# 10. 一致性与对抗审查
-/adspecs-analyze docs/20-prd/... docs/30-system-design/...
-/adspecs-adversarial-review M06-01_*.md
-
-# 11. 编码实现（TDD）
-/subagent-driven-development
-
-# 12. 单元测试 + 审查
-/adspecs-utest docs/30-system-design/crm/M06-01-销售预测_system-design.md
-/sie-front-code-review
-
-# 13. 状态追踪 + 导出
-/adspecs-update-status
-/adspecs-export-word docs/30-system-design/
-/wiki-update
-```
-
----
-
-## 路径配置
-
-Skill 支持通过 `.adspecs/paths.json` 自定义输出目录：
-
-```json
-{
-  "paths": {
-    "biz_analysis_dir": "docs/00-customer-requirements",
-    "architecture_dir": "docs/10-architecture",
-    "prd_dir": "docs/20-prd",
-    "design_dir": "docs/30-system-design",
-    "test_report_dir": "docs/80-development",
-    "export_dir": "docs/90-export",
-    "wiki_dir": "wiki"
-  }
-}
-```
-
-`adspecs init` 自动生成此文件，可直接编辑修改。
-
----
-
-## 安装与升级
-
-详细安装说明见 [INSTALL.md](./INSTALL.md)。
-
-```bash
-# 安装
-npm install -g adspecs
-adspecs plugin install              # 用户级（默认）
-adspecs plugin install --scope project  # 项目级
-
-# 升级
-npm install -g adspecs@latest
-
-# 卸载
-adspecs plugin uninstall --scope user
-adspecs plugin uninstall --scope project
-```
-
----
-
-## 常见问题
-
-**Q1：adspecs 与 superpowers 的关系？**
-adspecs 提供领域专属 Skill（需求、设计、模板、规范），superpowers 提供通用 AI 工程 Skill（TDD、子代理、调试）。两者分工协作，**编码阶段必须同时安装**。
-
-**Q2：用户级和项目级安装可以共存吗？**
-可以，项目级优先于用户级（就近原则）。个人开发选用户级，团队协作选项目级。
-
-**Q3：安装后 Skill 未生效？**
-1. 执行 `/plugins` 查看 adspecs 是否在已加载列表
-2. 重启 Claude Code
-3. 检查安装 scope 对应的目录是否存在
-
-**Q4：如何升级？**
-```bash
-npm install -g adspecs@latest
-# 插件注册无需重新执行，Skill 定义随 npm 包更新
-```
-
-**Q5：前端测试框架？**
-Vue 项目使用 Vitest + @vue/test-utils；React 项目使用 Jest + React Testing Library。
-
-**Q6：init 模式区别？**
-- `simple`：仅 docs + wiki
-- `classic`：+ front-demo（默认）
-- `full`：所有目录 + 参考工程
-- `demo`：Python+SQLite+React+AntD6 全栈 demo
-
----
-
-## License
-
-[Apache-2.0](./LICENSE)
+# AdSpecs — AI 工程研发协同插件
+
+[![npm version](https://img.shields.io/npm/v/adspecs)](https://www.npmjs.com/package/adspecs)
+[![npm downloads](https://img.shields.io/npm/dt/adspecs)](https://www.npmjs.com/package/adspecs)
+
+---
+
+## 简介
+
+AdSpecs 是一个基于 Claude Code 的 AI 工程研发协同插件，提供：
+
+- **21 个 Skill**（Slash 命令） — 覆盖需求分析、架构规划、系统设计、任务拆解、单元测试、代码审查、文档导出、Wiki 同步
+- **CLI 工具** — `adspecs init` 一键脚手架、`adspecs plugin install` 插件注册、`adspecs doctor` 环境检查
+- **21 个标准文档模板** — 需求 / 设计 / 任务 / 测试 / 评审 / 架构全覆盖
+- **多技术栈参考** — ECP Java 后端、Vue 3 前端、Ant Design React 前端、Python 后端等 11 套参考工程
+- **npm 分发** — `npm install -g adspecs` 即装即用
+
+本插件需配合 [`superpowers`](https://github.com/anthropics/claude-plugins-official) 插件（提供 TDD、子代理驱动开发等通用 Skill）一起使用。
+
+---
+
+## 项目结构
+
+```
+adspecs/
+├── bin/adspecs.js                  # CLI 入口
+├── src/                            # CLI 核心代码
+│   ├── commands/                   #   init / plugin / doctor / update
+│   └── lib/                        #   scaffolder / prompts / report 等
+├── skills/                         # 21 个 Skill 定义
+├── .claude-plugin/                 # Claude Code 插件清单
+├── .qoder-plugin/                  # Qoder 插件清单
+├── .adspecs/
+│   ├── templates/                  #   21 个标准文档模板
+│   ├── extensions/                 #   扩展配置（git hooks 等）
+│   ├── scripts/                    #   辅助脚本（bash/powershell/python）
+│   ├── feature.json                #   功能追踪模板
+│   └── project.json                #   项目元数据模板
+├── hooks/                          # Node.js 钩子脚本
+├── references/                     # 11 套参考工程与编码规范
+├── scripts/                        # 构建脚本（postinstall/sync-version）
+├── package.json
+├── CLAUDE.md
+├── INSTALL.md
+└── README.md
+```
+
+---
+
+## 快速开始
+
+### 1. 安装
+
+```bash
+# 全局安装 CLI
+npm install -g adspecs
+
+# 在 Claude Code 中注册插件（用户级，全局生效）
+adspecs plugin install
+
+# 或仅注册到当前项目（团队级）
+cd your-project
+adspecs plugin install --scope project
+```
+
+### 2. 初始化项目
+
+```bash
+# 交互式初始化
+adspecs init
+```
+
+### 3. 开始使用 Skill
+
+```
+/adspecs-new-requirement CRM 销售预测模块
+/adspecs-prd docs/00-customer-requirements/...
+/adspecs-plan docs/20-prd/crm/...
+...
+```
+
+---
+
+## CLI 工具
+
+安装后提供 `adspecs` 命令行工具：
+
+| 命令                       | 说明                                                  | 示例                                     |
+| -------------------------- | ----------------------------------------------------- | ---------------------------------------- |
+| `adspecs init`             | 交互式初始化项目结构（docs/、templates/、前端模板等） | `adspecs init --mode simple`             |
+| `adspecs plugin install`   | 注册为 Claude Code 插件                               | `adspecs plugin install --scope project` |
+| `adspecs plugin uninstall` | 从 Claude Code 卸载插件                               | `adspecs plugin uninstall --scope user`  |
+| `adspecs doctor`           | 检查环境依赖（Node.js、git、Python 等）               | `adspecs doctor`                         |
+| `adspecs update`           | 升级到最新版本                                        | `adspecs update --version 0.2.0`         |
+
+### `adspecs init` 参数
+
+| 参数                        | 说明                                                  | 默认值     |
+| --------------------------- | ----------------------------------------------------- | ---------- |
+| `--project-name <name>`     | 项目名称                                              | 交互输入   |
+| `--project-dir <dir>`       | 项目目录（留空=当前目录）                             | 当前目录   |
+| `--mode <mode>`             | 初始化模式：`simple` \| `classic` \| `full` \| `demo` | 交互选择   |
+| `--front-demo <stack>`      | 前端演示技术栈：`vue` \| `antd`                       | `vue`      |
+| `--company <name>`          | 公司名称                                              | —          |
+| `--confidentiality <level>` | 文件密级：`公开` \| `内部资料` \| `机密` \| `绝密`    | `内部资料` |
+| `--modules <list>`          | 后端模块列表（逗号分隔）                              | —          |
+| `--non-interactive`         | 非交互模式，使用默认值                                | —          |
+| `--force`                   | 已存在区域直接重建                                    | —          |
+| `-y, --yes`                 | 自动确认执行                                          | —          |
+
+---
+
+## Skills 总览（21 个）
+
+按职责分为六类：
+
+### 一、项目初始化（CLI 命令）
+
+| 命令           | 说明                                                                           |
+| -------------- | ------------------------------------------------------------------------------ |
+| `adspecs init` | 交互式初始化项目结构：`docs/` 文档树、前端模板、后端模块、编码规范、标准模板等 |
+
+初始化后生成：
+
+- `docs/10-architecture/` — 架构规划
+- `docs/20-prd/` — 产品需求说明书
+- `docs/30-system-design/` — 系统设计 + SQL + 前端设计 + 任务清单
+- `docs/40-project_conventions/` — 编码规范
+- `.adspecs/templates/` — 21 个标准模板
+- `.adspecs/paths.json` — 可自定义的输出路径配置
+
+### 二、需求分析与架构规划（5 个）
+
+| Skill                           | 说明                                             | 输入                | 输出                             |
+| ------------------------------- | ------------------------------------------------ | ------------------- | -------------------------------- |
+| `adspecs-new-requirement`       | 深度业务需求分析（六步结构 + 模拟评审）          | 业务需求描述        | `docs/00-customer-requirements/` |
+| `adspecs-biz-blueprint`         | 将需求分析转化为 F1~F6 业务方案文件体系          | 业务需求分析文档    | `docs/00-customer-requirements/` |
+| `adspecs-prd`                   | 从自然语言 / 调研材料生成 PRD                    | 调研材料 / 原始需求 | `docs/20-prd/`                   |
+| `adspecs-clarify`               | 识别 PRD 模糊点（≤5 个）并澄清                   | 需求规格说明书      | 更新后的规格说明书               |
+| `adspecs-architecture-planning` | 平台级架构规划（功能架构 → 模块依赖 → 数据建模） | 项目 / 业务描述     | `docs/10-architecture/`          |
+
+### 三、SOW / 设计 / 任务（5 个）
+
+| Skill                 | 说明                                  | 输入            | 输出                                  |
+| --------------------- | ------------------------------------- | --------------- | ------------------------------------- |
+| `adspecs-write-sow`   | 根据项目 / 合同信息生成工作说明书     | 项目 / 合同信息 | `docs/05-sow/`                        |
+| `adspecs-plan`        | 后端统一系统设计（OOA+OOD）+ 建表 SQL | PRD             | `docs/30-system-design/` design + SQL |
+| `adspecs-front-spec`  | 前端功能设计（UI/交互规格）           | PRD + 系统设计  | `docs/30-system-design/` 前端设计     |
+| `adspecs-tasks`       | 后端 TDD 任务清单                     | 系统设计文档    | `docs/30-system-design/` tasks.md     |
+| `adspecs-front-tasks` | 前端 TDD 任务清单                     | 前端设计文档    | `docs/30-system-design/` tasks.md     |
+
+### 四、质量保障与测试（3 个）
+
+| Skill                        | 说明                                                                |
+| ---------------------------- | ------------------------------------------------------------------- |
+| `adspecs-analyze`            | 跨文档（PRD / 系统设计 / tasks）全链路 13 维一致性分析              |
+| `adspecs-adversarial-review` | 对抗式审查：5 个红队角色挑战文档假设、缺失、矛盾与歧义              |
+| `adspecs-utest`              | 基于系统设计生成 Service / Controller 层 JUnit 5 单元测试代码及报告 |
+
+### 五、交付与运维（5 个）
+
+| Skill                   | 说明                                               |
+| ----------------------- | -------------------------------------------------- |
+| `adspecs-update-status` | 更新 feature.json 功能状态 + 输出追踪矩阵          |
+| `adspecs-export-word`   | Markdown 导出为 Word（.docx），自动生成封面 + 目录 |
+| `adspecs-git-commit`    | 各阶段完成后自动提交变更                           |
+| `sie-front-code-review` | 前端专项评审（React + TypeScript + Ant Design）    |
+| `wiki-update`           | 将 docs/ 同步到 wiki/（全量 / 增量模式）           |
+
+### 六、产品规划（2 个）
+
+| Skill                           | 说明                                 |
+| ------------------------------- | ------------------------------------ |
+| `adspecs-write-planning-report` | 汇总调研期分析输出，生成产品规划报告 |
+| `adspecs-write-roadmap`         | 版本路标维护，追写 roadmap.md        |
+
+### 编码阶段依赖（superpowers 插件）
+
+| 外部 Skill                       | 说明                             |
+| -------------------------------- | -------------------------------- |
+| `subagent-driven-development`    | 子代理驱动并行开发               |
+| `test-driven-development`        | RED → GREEN → REFACTOR TDD 循环  |
+| `dispatching-parallel-agents`    | 并行子代理调度                   |
+| `finishing-a-development-branch` | 分支收尾（PR / merge / cleanup） |
+| `verification-before-completion` | 完成前最终验证                   |
+
+---
+
+## 模板体系（21 个）
+
+初始化后位于 `.adspecs/templates/`：
+
+| 模板                         | 用途                        | 阶段 |
+| ---------------------------- | --------------------------- | ---- |
+| `01-业务需求分析模板.md`     | 业务需求分析（六步结构）    | 需求 |
+| `02-产品需求说明书模板.md`   | 产品需求说明书（PRD）       | 需求 |
+| `03-系统设计模板.md`         | 后端统一系统设计（OOA+OOD） | 设计 |
+| `04-前端功能设计模板.md`     | 前端功能规格（UI/交互）     | 设计 |
+| `05-后端任务清单模板.md`     | 后端 TDD 任务清单           | 任务 |
+| `05b-前端任务清单模板.md`    | 前端 TDD 任务清单           | 任务 |
+| `06-代码评审报告模板.md`     | 代码评审报告                | 审查 |
+| `07-单元测试报告模板.md`     | 单元测试报告                | 测试 |
+| `08-系统集成测试报告模板.md` | 集成测试报告                | 测试 |
+| `09-性能测试报告模板.md`     | 性能测试报告                | 测试 |
+| `10-安全检查清单.md`         | 安全检查清单                | 审查 |
+| `11-代码质量标准.md`         | 代码质量标准                | 审查 |
+| `13-测试用例模板.md`         | 测试用例                    | 测试 |
+| `14-需求追溯矩阵模板.md`     | 需求 → 实现追溯矩阵         | 审查 |
+| `15-业务功能架构文档模板.md` | 业务功能架构规划            | 架构 |
+| `16-系统架构设计模板.md`     | 系统架构设计                | 架构 |
+| `17-子模块依赖关系模板.md`   | 子模块依赖关系              | 架构 |
+| `18-统一数据模型模板.md`     | 统一数据建模（含 ER 图）    | 架构 |
+| `19-项目目录结构模板.md`     | 项目目录结构规划            | 架构 |
+| `20-工作说明书SOW模板.md`    | 工作说明书（SOW）           | 需求 |
+| `21-业务方案模板.md`         | 业务方案（F1~F6 文件体系）  | 需求 |
+
+> **约定**：所有模板通过对应 Skill 调用生成，不建议直接手工填写。
+
+---
+
+## 参考工程（11 套）
+
+`references/` 目录包含 `adspecs init` 时按需复制到目标项目的参考代码和规范：
+
+| 目录                           | 说明                                           |
+| ------------------------------ | ---------------------------------------------- |
+| `docs/40-project_conventions/` | ECP 编码标准（后端 Java + 前端集成）           |
+| `front-demo/`                  | Vue 3 前端演示项目（Vite + TS + Element Plus） |
+| `antd-front-demo/`             | Ant Design React 前端演示项目                  |
+| `ant6-front-standard/`         | Ant Design 6 前端编码规范（9 篇）              |
+| `ecp-end-standard/`            | ECP 后端编码规范                               |
+| `ecp-front-standard/`          | ECP 前端编码规范                               |
+| `iidp-end-standard/`           | IIDP 后端编码规范                              |
+| `iidp-front-standard/`         | IIDP 前端编码规范                              |
+| `web-ui/`                      | ECP 管理控制台外壳工程                         |
+| `python/`                      | Python 后端参考                                |
+| `yudaocloud-end-standard/`     | 芋道 Cloud 后端集成参考                        |
+
+---
+
+## 推荐开发流程
+
+```
+[adspecs init]                        →  项目脚手架
+         ↓
+[adspecs-architecture-planning]       →  平台架构规划（功能架构→依赖→数据模型）
+         ↓
+[adspecs-new-requirement]             →  深度业务需求分析
+         ↓
+[adspecs-biz-blueprint]               →  业务方案（F1~F6 文件体系）
+         ↓
+[adspecs-prd + adspecs-clarify]       →  产品需求说明书 + 澄清迭代
+         ↓
+[adspecs-plan / adspecs-front-spec]   →  后端设计+SQL / 前端设计
+         ↓
+[adspecs-tasks / adspecs-front-tasks] →  后端 / 前端 TDD 任务清单
+         ↓
+[adspecs-analyze + adversarial-review]→  一致性与质量审查
+         ↓
+[TDD + subagent-driven-development]   →  编码实现（依赖 superpowers）
+         ↓
+[adspecs-utest]                       →  单元测试 + 报告
+         ↓
+[sie-front-code-review]               →  前端代码审查
+         ↓
+[adspecs-update-status]               →  功能状态追踪
+         ↓
+[adspecs-export-word / wiki-update]   →  文档导出 + Wiki 同步
+```
+
+### 完整示例：销售预测从零到交付
+
+```txt
+# 1. 初始化项目
+adspecs init --project-name my-crm --mode classic
+
+# 2. 平台架构规划
+/adspecs-architecture-planning 华峰铝业CRM，覆盖销售全生命周期
+
+# 3. 深度需求分析
+/adspecs-new-requirement CRM 销售预测模块
+
+# 4. 业务方案
+/adspecs-biz-blueprint docs/00-customer-requirements/...
+
+# 5. 生成 PRD
+/adspecs-prd 预测单需求调研.md
+
+# 6. 澄清 + 评审（2~3 轮）
+/adspecs-clarify docs/20-prd/crm/sales-forecast/M06-01_销售预测需求规格说明书.md
+
+# 7. 后端系统设计 + SQL
+/adspecs-plan docs/20-prd/crm/sales-forecast/M06-01_销售预测需求规格说明书.md
+
+# 8. 前端设计
+/adspecs-front-spec docs/20-prd/crm/sales-forecast/M06-01_销售预测需求规格说明书.md
+
+# 9. 生成任务清单
+/adspecs-tasks docs/30-system-design/crm/M06-01-销售预测_system-design.md
+/adspecs-front-tasks docs/30-system-design/crm/M06-01_销售预测_前端设计.md
+
+# 10. 一致性与对抗审查
+/adspecs-analyze docs/20-prd/... docs/30-system-design/...
+/adspecs-adversarial-review M06-01_*.md
+
+# 11. 编码实现（TDD）
+/subagent-driven-development
+
+# 12. 单元测试 + 审查
+/adspecs-utest docs/30-system-design/crm/M06-01-销售预测_system-design.md
+/sie-front-code-review
+
+# 13. 状态追踪 + 导出
+/adspecs-update-status
+/adspecs-export-word docs/30-system-design/
+/wiki-update
+```
+
+---
+
+## 路径配置
+
+Skill 支持通过 `.adspecs/paths.json` 自定义输出目录：
+
+```json
+{
+  "paths": {
+    "biz_analysis_dir": "docs/00-customer-requirements",
+    "architecture_dir": "docs/10-architecture",
+    "prd_dir": "docs/20-prd",
+    "design_dir": "docs/30-system-design",
+    "test_report_dir": "docs/80-development",
+    "export_dir": "docs/90-export",
+    "wiki_dir": "wiki"
+  }
+}
+```
+
+`adspecs init` 自动生成此文件，可直接编辑修改。
+
+---
+
+## 安装与升级
+
+详细安装说明见 [INSTALL.md](./INSTALL.md)。
+
+```bash
+# 安装
+npm install -g adspecs
+adspecs plugin install              # 用户级（默认）
+adspecs plugin install --scope project  # 项目级
+
+# 升级
+npm install -g adspecs@latest
+
+# 卸载
+adspecs plugin uninstall --scope user
+adspecs plugin uninstall --scope project
+```
+
+---
+
+## 常见问题
+
+**Q1：adspecs 与 superpowers 的关系？**
+adspecs 提供领域专属 Skill（需求、设计、模板、规范），superpowers 提供通用 AI 工程 Skill（TDD、子代理、调试）。两者分工协作，**编码阶段必须同时安装**。
+
+**Q2：用户级和项目级安装可以共存吗？**
+可以，项目级优先于用户级（就近原则）。个人开发选用户级，团队协作选项目级。
+
+**Q3：安装后 Skill 未生效？**
+1. 执行 `/plugins` 查看 adspecs 是否在已加载列表
+2. 重启 Claude Code
+3. 检查安装 scope 对应的目录是否存在
+
+**Q4：如何升级？**
+```bash
+npm install -g adspecs@latest
+# 插件注册无需重新执行，Skill 定义随 npm 包更新
+```
+
+**Q5：前端测试框架？**
+Vue 项目使用 Vitest + @vue/test-utils；React 项目使用 Jest + React Testing Library。
+
+**Q6：init 模式区别？**
+- `simple`：仅 docs + wiki
+- `classic`：+ front-demo（默认）
+- `full`：所有目录 + 参考工程
+- `demo`：Python+SQLite+React+AntD6 全栈 demo
+
+---
+
+## License
+
+[Apache-2.0](./LICENSE)