adspecs 0.1.16 → 0.1.19

package/.adspecs/extensions/git/commands/adspecs.git.initialize.md

@@ -10,12 +10,12 @@ Initialize a Git repository in the current project directory if one does not alr
 
 Run the appropriate script from the project root:
 
-- **Bash**: `.specify/extensions/git/scripts/bash/initialize-repo.sh`
-- **PowerShell**: `.specify/extensions/git/scripts/powershell/initialize-repo.ps1`
+- **Bash**: `.adspecs/extensions/git/scripts/bash/initialize-repo.sh`
+- **PowerShell**: `.adspecs/extensions/git/scripts/powershell/initialize-repo.ps1`
 
 If the extension scripts are not found, fall back to:
-- **Bash**: `git init && git add . && git commit -m "Initial commit from Specify template"`
-- **PowerShell**: `git init; git add .; git commit -m "Initial commit from Specify template"`
+- **Bash**: `git init && git add . && git commit -m "Initial commit from Adspecs template"`
+- **PowerShell**: `git init; git add .; git commit -m "Initial commit from Adspecs template"`
 
 The script handles all checks internally:
 - Skips if Git is not available

package/.adspecs/extensions/git/extension.yml

@@ -10,7 +10,7 @@ extension:
   license: MIT
 
 requires:
-  adspecs_version: ">=0.2.0"
+  adspecs_version: ">=0.1.0"
   tools:
     - name: git
       required: false

package/.adspecs/extensions/git/git-config.yml

@@ -1,5 +1,5 @@
 # Git Branching Workflow Extension Configuration
-# Copied to .specify/extensions/git/git-config.yml on install
+# Copied to .adspecs/extensions/git/git-config.yml on install
 
 # Branch numbering strategy: "sequential" (001, 002, ...) or "timestamp" (YYYYMMDD-HHMMSS)
 branch_numbering: sequential
@@ -11,7 +11,10 @@ init_commit_message: "[adspecs] Initial commit"
 # Set "default" to enable for all commands, then override per-command.
 # Each key can be true/false. Message is customizable per-command.
 auto_commit:
-  default: false
+  default: false  
+  before_prd:
+    enabled: false
+    message: "[adspecs] Save progress before prd"
   before_clarify:
     enabled: false
     message: "[adspecs] Save progress before clarification"
@@ -21,6 +24,12 @@ auto_commit:
   before_tasks:
     enabled: false
     message: "[adspecs] Save progress before task generation"
+  before_front-spec:
+    enabled: false
+    message: "[adspecs] Save progress before front-spec"
+  before_front-tasks:
+    enabled: false
+    message: "[adspecs] Save progress before front-tasks"
   before_implement:
     enabled: false
     message: "[adspecs] Save progress before implementation"
@@ -33,6 +42,9 @@ auto_commit:
   before_taskstoissues:
     enabled: false
     message: "[adspecs] Save progress before issue sync"
+  before_update_status:
+    enabled: false
+    message: "[adspecs] Save progress before update status"
   after_constitution:
     enabled: false
     message: "[adspecs] Add project constitution"
@@ -63,3 +75,6 @@ auto_commit:
   after_taskstoissues:
     enabled: false
     message: "[adspecs] Sync tasks to issues"
+  after_updatestatus:
+    enabled: true
+    message: "[adspecs] Sync update status"

package/.adspecs/extensions.yml

@@ -50,6 +50,22 @@ hooks:
     optional: false
     prompt: Commit outstanding changes before task generation?
     description: Auto-commit before task generation
+    condition: null    
+  before_front-spec:
+  - extension: git
+    command: adspecs.git.commit
+    enabled: false
+    optional: false
+    prompt: Commit outstanding changes before front-spec planning?
+    description: Auto-commit before front-spec planning
+    condition: null
+  before_front-tasks:
+  - extension: git
+    command: adspecs.git.commit
+    enabled: false
+    optional: false
+    prompt: Commit outstanding changes before front tasks generation?
+    description: Auto-commit before front tasks generation
     condition: null
   before_implement:
   - extension: git
@@ -130,6 +146,22 @@ hooks:
     optional: true
     prompt: Commit task changes?
     description: Auto-commit after task generation
+    condition: null  
+  after_front-spec:
+  - extension: git
+    command: adspecs.git.commit
+    enabled: true
+    optional: true
+    prompt: Commit front-spec changes?
+    description: Auto-commit after implementation front-spec
+    condition: null
+  after_front-tasks:
+  - extension: git
+    command: adspecs.git.commit
+    enabled: true
+    optional: true
+    prompt: Commit front tasks changes?
+    description: Auto-commit after implementation front-tasks
     condition: null
   after_implement:
   - extension: git

package/.adspecs/paths.json

@@ -0,0 +1,17 @@
+{
+  "$schema": "adspecs plugin path configuration",
+  "version": 1,
+  "paths": {
+    "biz_analysis_dir": "docs/00-customer-requirements",
+    "architecture_dir": "docs/10-architecture",
+    "research_output_dir": "docs/02-prd",
+    "sow_dir": "docs/05-sow",
+    "prd_dir": "docs/20-prd",
+    "design_dir": "docs/30-system-design",
+    "test_report_dir": "docs/80-development",
+    "export_dir": "docs/90-export",
+    "front_demo_dir": "front-demo",
+    "front_prototype_dir": "web-ui",
+    "wiki_dir": "wiki"
+  }
+}

package/.adspecs/templates/02-/344/272/247/345/223/201/351/234/200/346/261/202/350/257/264/346/230/216/344/271/246/346/250/241/346/235/277.md

@@ -370,6 +370,9 @@ stateDiagram-v2
 - [如果有特殊的业务逻辑，描述清楚]
 - [如：需要调用第三方接口、需要特殊计算、需要特殊权限等]
 
+**异常处理**:
+- [详细描述异常场景业务逻辑，重点包括权限异常、数据为空、接口失败、重复提交、状态冲突、网络异常、历史数据兼容、用户中途退出]
+
 **业务实体**(若功能涉及数据，请包含):
 - **[实体1]**: [其代表的含义，未实现的关键属性]
 - **[实体2]**： [它代表什么，与其他实体的关系]
@@ -394,6 +397,7 @@ stateDiagram-v2
 - [原型文件路径]: [如：应收佣金（一期）.html]
 - [原型页面说明]: [描述原型页面对应的功能,包括详细描述界面中各个按钮、字段之间的联动逻辑]
 ---
+
 #### 4.3.2 功能2: [功能编号] [功能名称]
 
 [按照上述格式继续描述。报表类功能可用"页面布局"小节替代操作流程；扫码/移动端功能可用"功能入口"小节列出各操作场景]

package/.adspecs/workflows/adspecs/workflow.yml

@@ -2,7 +2,7 @@ schema_version: "1.0"
 workflow:
   id: "adspecs"
   name: "Full SDD Cycle"
-  version: "1.0.1"
+  version: "0.1.18"
   author: "GitHub"
   description: "Runs adspecs → plan → tasks → implement with review gates"
 
@@ -10,7 +10,7 @@ requires:
   # 0.8.5 is the first release with engine-side resolution of the
   # ``integration: "auto"`` default. Older versions would treat "auto"
   # as a literal integration key and fail at dispatch.
-  adspecs_version: ">=1.0.1"
+  adspecs_version: ">=0.1.0"
   integrations:
     # The four commands below (adspecs, plan, tasks, implement) are core
     # adspecs commands provided by every integration. The list here is an
@@ -21,6 +21,7 @@ requires:
     # core commands referenced in ``steps``.
     any:
       - "claude"
+      - "qoder"
       - "copilot"
       - "gemini"
       - "opencode"
@@ -40,8 +41,8 @@ inputs:
     enum: ["full", "backend-only", "frontend-only"]
 
 steps:
-  - id: biz-analysis
-    command: adspecs.biz-analysis
+  - id: new-requirement
+    command: adspecs.new-requirement
     integration: "{{ inputs.integration }}"
     input:
       args: "{{ inputs.spec }}"

package/.claude-plugin/marketplace.json

@@ -10,7 +10,7 @@
     {
       "name": "adspecs",
       "description": "AI Coding研发协同开发插件",
-      "version": "0.1.16",
+      "version": "0.1.19",
       "source": "./",
       "author": {
         "name": "Qingwen Chen",

package/.claude-plugin/plugin.json

@@ -2,7 +2,7 @@
   "name": "adspecs",
   "displayName": "adspecs AI Plugin",
   "description": "AI first工程规范驱动开发插件",
-  "version": "0.1.16",
+  "version": "0.1.19",
   "author": {
     "name": "Qingwen Chen",
     "email": "cqinwn@qq.com",

package/.qoder-plugin/plugin.json

@@ -1,21 +1,31 @@
-{
-  "name": "adspecs",
-  "displayName": "adspecs AI 工程规范驱动开发插件",
-  "version": "0.1.13",
-  "description": "AI-first specification-driven development plugin for ECP platform full-lifecycle development",
-  "descriptionZh": "AI优先的工程规范驱动开发插件，覆盖需求分析、PRD、系统设计、任务拆解、TDD、代码评审、Wiki同步全流程",
-  "author": {
-    "name": "Qingwen Chen",
-    "email": "cqinwn@qq.com"
-  },
-  "homepage": "https://gitee.com/yuebon/adspecs",
-  "repository": "https://gitee.com/yuebon/adspecs",
-  "logo": "./assets/avatar.svg",
-  "keywords": ["qoder-plugin", "adspecs", "spec-driven", "tdd"],
-  "category": "developer-tools",
-  "tags": ["skill", "specification", "tdd", "documentation"],
-  "skills": "./skills/",
-  "rules": "./rules/",
-  "hooks": "./hooks/hooks.json",
-  "preserveUpstreamMetadata": true
-}
+{
+  "name": "adspecs",
+  "displayName": "adspecs AI 工程规范驱动开发插件",
+  "version": "0.1.19",
+  "description": "AI-first specification-driven development plugin for ECP platform full-lifecycle development",
+  "descriptionZh": "AI优先的工程规范驱动开发插件，覆盖需求分析、PRD、系统设计、任务拆解、TDD、代码评审、Wiki同步全流程",
+  "author": {
+    "name": "Qingwen Chen",
+    "email": "cqinwn@qq.com"
+  },
+  "homepage": "https://gitee.com/yuebon/adspecs",
+  "repository": "https://gitee.com/yuebon/adspecs",
+  "logo": "./assets/avatar.svg",
+  "keywords": [
+    "qoder-plugin",
+    "adspecs",
+    "spec-driven",
+    "tdd"
+  ],
+  "category": "developer-tools",
+  "tags": [
+    "skill",
+    "specification",
+    "tdd",
+    "documentation"
+  ],
+  "skills": "./skills/",
+  "rules": "./rules/",
+  "hooks": "./hooks/hooks.json",
+  "preserveUpstreamMetadata": true
+}

package/README.md

@@ -1,9 +1,5 @@
 # AdSpecs — AI 工程研发协同插件
 
-> **AI First 全链路研发协同**：规划 → 需求 → 设计 → 任务 → 编码 → 测试 → 审查 → 导出 → 知识回归
->
-> **版本**：v0.1.15 ｜ **协议**：Apache-2.0 ｜ **作者**：Qingwen Chen
-
 [![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)
 
@@ -11,7 +7,7 @@
 
 ## 简介
 
-AdSpecs 是一个基于 Claude Code 的 AI 工程研发协同插件，面向 **ECP（企业云平台）** 类中后台项目，提供：
+AdSpecs 是一个基于 Claude Code 的 AI 工程研发协同插件，提供：
 
 - **21 个 Skill**（Slash 命令） — 覆盖需求分析、架构规划、系统设计、任务拆解、单元测试、代码审查、文档导出、Wiki 同步
 - **CLI 工具** — `adspecs init` 一键脚手架、`adspecs plugin install` 插件注册、`adspecs doctor` 环境检查
@@ -23,6 +19,34 @@ AdSpecs 是一个基于 Claude Code 的 AI 工程研发协同插件，面向 **E
 
 ---
 
+## 项目结构
+
+```
+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. 安装
@@ -44,9 +68,6 @@ adspecs plugin install --scope project
 ```bash
 # 交互式初始化
 adspecs init
-
-# 或直接在 Claude Code 中
-/project-init
 ```
 
 ### 3. 开始使用 Skill
@@ -64,28 +85,28 @@ adspecs init
 
 安装后提供 `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`             | 交互式初始化项目结构（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` | 自动确认执行 | — |
+| 参数                        | 说明                                                  | 默认值     |
+| --------------------------- | ----------------------------------------------------- | ---------- |
+| `--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`                 | 自动确认执行                                          | —          |
 
 ---
 
@@ -95,8 +116,8 @@ adspecs init
 
 ### 一、项目初始化（CLI 命令）
 
-| 命令 | 说明 |
-| --- | --- |
+| 命令           | 说明                                                                           |
+| -------------- | ------------------------------------------------------------------------------ |
 | `adspecs init` | 交互式初始化项目结构：`docs/` 文档树、前端模板、后端模块、编码规范、标准模板等 |
 
 初始化后生成：
@@ -110,58 +131,58 @@ adspecs init
 
 ### 二、需求分析与架构规划（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/` |
+| 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 |
+| 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 单元测试代码及报告 |
+| 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/（全量 / 增量模式） |
+| 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 | 说明 |
-| --- | --- |
+| Skill                           | 说明                                 |
+| ------------------------------- | ------------------------------------ |
 | `adspecs-write-planning-report` | 汇总调研期分析输出，生成产品规划报告 |
-| `adspecs-write-roadmap` | 版本路标维护，追写 roadmap.md |
+| `adspecs-write-roadmap`         | 版本路标维护，追写 roadmap.md        |
 
 ### 编码阶段依赖（superpowers 插件）
 
-| 外部 Skill | 说明 |
-| --- | --- |
-| `subagent-driven-development` | 子代理驱动并行开发 |
-| `test-driven-development` | RED → GREEN → REFACTOR TDD 循环 |
-| `dispatching-parallel-agents` | 并行子代理调度 |
+| 外部 Skill                       | 说明                             |
+| -------------------------------- | -------------------------------- |
+| `subagent-driven-development`    | 子代理驱动并行开发               |
+| `test-driven-development`        | RED → GREEN → REFACTOR TDD 循环  |
+| `dispatching-parallel-agents`    | 并行子代理调度                   |
 | `finishing-a-development-branch` | 分支收尾（PR / merge / cleanup） |
-| `verification-before-completion` | 完成前最终验证 |
+| `verification-before-completion` | 完成前最终验证                   |
 
 ---
 
@@ -169,29 +190,29 @@ adspecs init
 
 初始化后位于 `.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 文件体系） | 需求 |
+| 模板                         | 用途                        | 阶段 |
+| ---------------------------- | --------------------------- | ---- |
+| `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 调用生成，不建议直接手工填写。
 
@@ -201,19 +222,19 @@ adspecs init
 
 `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 后端集成参考 |
+| 目录                           | 说明                                           |
+| ------------------------------ | ---------------------------------------------- |
+| `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 后端集成参考                        |
 
 ---
 
@@ -369,34 +390,6 @@ Vue 项目使用 Vitest + @vue/test-utils；React 项目使用 Jest + React Test
 
 ---
 
-## 项目结构
-
-```
-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
-```
-
----
-
 ## License
 
 [Apache-2.0](./LICENSE)

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "adspecs",
-  "version": "0.1.16",
+  "version": "0.1.19",
   "description": "AI first 工程规范驱动开发插件 — 支持 npm 安装和 CLI 初始化",
   "bin": {
     "adspecs": "./bin/adspecs.js"
@@ -30,7 +30,7 @@
     "test": "node --test src/**/*.test.js",
     "postinstall": "node scripts/postinstall.js",
     "prepublishOnly": "node scripts/prepublish-check.js",
-    "preversion": "node scripts/sync-version.js",
+    "version": "node scripts/sync-version.js && git add .claude-plugin/plugin.json .claude-plugin/marketplace.json .qoder-plugin/plugin.json",
     "sync-version": "node scripts/sync-version.js"
   },
   "dependencies": {

package/references/antd-front-demo/.env

@@ -1,10 +1,10 @@
 # 应用标题
-VITE_APP_TITLE=Sie Front Demo
-VITE_APP_SIDEBAR_TITLE=Sie Demo
-VITE_APP_BRAND_TITLE=Sie Front Demo
+VITE_APP_TITLE=演示环境
+VITE_APP_SIDEBAR_TITLE=演示环境
+VITE_APP_BRAND_TITLE=演示环境
 
 # 应用命名空间
-VITE_APP_NAMESPACE=sie-demo
+VITE_APP_NAMESPACE=front-demo
 
 # 请求路径
 VITE_BASE_URL=