adspecs 0.1.41 → 0.2.0

package/skills/{adspecs-architecture-planning → ads-architecture-planning}/SKILL.md

@@ -1,5 +1,5 @@
 ---
-name: "adspecs-architecture-planning"
+name: "ads-architecture-planning"
 description: "基于自然语言项目/业务描述，支持3种架构规划类型：①功能架构 ②子模块依赖关系 ③统一数据建模（含Mermaid ER图）。用户可选择执行1种、2种或全部3种，后两者依赖功能架构完成"
 agent_created: true
 argument-hint: "描述项目名称、行业领域、核心业务和系统边界，如：华峰铝业CRM平台，覆盖销售全生命周期"
@@ -44,7 +44,7 @@ $ARGUMENTS
 - 对于每个剩余的钩子，**不要** 尝试解释或评估钩子的 `condition` 表达式：
   - 如果钩子没有 `condition` 字段，或为空/null，视为可执行。
   - 如果钩子定义了非空的 `condition`，跳过该钩子，将条件评估留给 HookExecutor 实现。
-- 从钩子命令名构造斜杠命令时，将点号（`.`）替换为连字符（`-`）。例如：`adspecs.git.commit` → `/adspecs-git-commit`。
+- 从钩子命令名构造斜杠命令时，将点号（`.`）替换为连字符（`-`）。例如：`adspecs.git.commit` → `/ads-git-commit`。
 - 对于每个可执行钩子，根据其 `optional` 标志输出以下内容：
   - **可选钩子** (`optional: true`):
 
@@ -194,7 +194,7 @@ $ARGUMENTS
 
 ## 概述
 
-用户在触发消息中 `/adspecs-planning` 之后输入的文本**就是**项目/业务描述。假设你在本次对话中始终可以获取到它，即使 `$ARGUMENTS` 字面上出现在下方。除非用户提供了空命令，否则不要要求用户重复输入。
+用户在触发消息中 `/ads-planning` 之后输入的文本**就是**项目/业务描述。假设你在本次对话中始终可以获取到它，即使 `$ARGUMENTS` 字面上出现在下方。除非用户提供了空命令，否则不要要求用户重复输入。
 
 本技能支持 **3 种架构类型**，用户可按需选择执行。各类型之间存在依赖关系：
 
@@ -766,11 +766,11 @@ erDiagram
 ### 后续步骤建议
 
 ```
-/adspecs-prd                    → 为具体模块生成 PRD
-/adspecs-clarify                → 澄清 PRD 中的模糊点
-/adspecs-plan                   → 为具体模块做详细系统设计（OOA+OOD+DDL）
-/adspecs-analyze                → 跨文档一致性检查
-/adspecs-adversarial-review     → 多角色对抗性评审
+/ads-prd                    → 为具体模块生成 PRD
+/ads-clarify                → 澄清 PRD 中的模糊点
+/ads-plan                   → 为具体模块做详细系统设计（OOA+OOD+DDL）
+/ads-analyze                → 跨文档一致性检查
+/ads-adversarial-review     → 多角色对抗性评审
 ```
 
 ## 必选执行后钩子
@@ -786,7 +786,7 @@ erDiagram
 - 对于每个剩余的钩子，**不要** 尝试解释或评估钩子的 `condition` 表达式：
   - 如果钩子没有 `condition` 字段，或为空/null，视为可执行。
   - 如果钩子定义了非空的 `condition`，跳过该钩子，将条件评估留给 HookExecutor 实现。
-- 从钩子命令名构造斜杠命令时，将点号（`.`）替换为连字符（`-`）。例如：`adspecs.git.commit` → `/adspecs-git-commit`。
+- 从钩子命令名构造斜杠命令时，将点号（`.`）替换为连字符（`-`）。例如：`adspecs.git.commit` → `/ads-git-commit`。
 - 对于每个可执行钩子，根据其 `optional` 标志输出以下内容：
   - **必选钩子** (`optional: false`) — **必须为每个必选钩子发出 `EXECUTE_COMMAND:`**：
 

package/skills/{adspecs-biz-blueprint → ads-biz-blueprint}/SKILL.md

@@ -1,5 +1,5 @@
 ---
-name: "adspecs-biz-blueprint"
+name: "ads-biz-blueprint"
 description: "将业务需求分析文档转化为结构化的业务方案文档（F1~F6 文件体系），作为 PRD 编写与系统设计的单一信息源。在需求分析之后、PRD 之前，完成业务流程、字段、规则、角色的完整业务蓝图。"
 agent_created: true
 argument-hint: "<业务需求分析文件路径>，如 docs/00-customer-requirements/M03-02/M03-02_bonded-material_业务需求分析.md"
@@ -37,9 +37,9 @@ $ARGUMENTS
 
 ## 定位
 
-本 skill 专注于 **业务需求分析 → 业务方案的结构化转化**，是产品交付流水线的第二步——在需求分析（`adspecs-new-requirement`）之后、PRD（`adspecs-prd`）之前，将需求分析成果转化为 F1~F6 业务蓝图，为 PRD 编写提供完整的业务框架。
+本 skill 专注于 **业务需求分析 → 业务方案的结构化转化**，是产品交付流水线的第二步——在需求分析（`ads-new-requirement`）之后、PRD（`ads-prd`）之前，将需求分析成果转化为 F1~F6 业务蓝图，为 PRD 编写提供完整的业务框架。
 
-| 对比项   | adspecs-new-requirement         | adspecs-biz-blueprint（本 skill）                                | adspecs-prd                            | adspecs-plan                  |
+| 对比项   | ads-new-requirement         | ads-biz-blueprint（本 skill）                                | ads-prd                            | ads-plan                  |
 | -------- | ------------------------------- | ---------------------------------------------------------------- | -------------------------------------- | ----------------------------- |
 | 输出     | 业务需求分析（1 个文件）        | 业务方案（1 个文件，F1~F6 体系）                                 | 产品需求说明书（1 个文件）             | 系统设计 + SQL（2 个文件）    |
 | 模板     | `01-业务需求分析模板.md`        | `21-业务方案模板.md`                                             | `02-产品需求说明书模板.md`             | `03-系统设计模板.md`          |
@@ -49,10 +49,10 @@ $ARGUMENTS
 
 **典型工作流**：
 
-1. 先用 `adspecs-new-requirement` 完成深度需求分析，确认方向正确（为什么做）
-2. **然后用 `adspecs-biz-blueprint` 生成业务方案，完成 F1~F6 业务蓝图（业务怎么运作）**
-3. 再用 `adspecs-prd` 基于业务方案编写产品需求说明书供业务方确认（做什么）
-4. 最后用 `adspecs-plan` 生成技术系统设计文档（怎么建）
+1. 先用 `ads-new-requirement` 完成深度需求分析，确认方向正确（为什么做）
+2. **然后用 `ads-biz-blueprint` 生成业务方案，完成 F1~F6 业务蓝图（业务怎么运作）**
+3. 再用 `ads-prd` 基于业务方案编写产品需求说明书供业务方确认（做什么）
+4. 最后用 `ads-plan` 生成技术系统设计文档（怎么建）
 
 ## 角色
 
@@ -110,7 +110,7 @@ $ARGUMENTS
 - 对于每个剩余的钩子，**不要** 尝试解释或评估钩子的 `condition` 表达式：
   - 如果钩子没有 `condition` 字段，或为空/null，视为可执行。
   - 如果钩子定义了非空的 `condition`，跳过该钩子，将条件评估留给 HookExecutor 实现。
-- 从钩子命令名构造斜杠命令时，将点号（`.`）替换为连字符（`-`）。例如：`adspecs.git.commit` → `/adspecs-git-commit`。
+- 从钩子命令名构造斜杠命令时，将点号（`.`）替换为连字符（`-`）。例如：`adspecs.git.commit` → `/ads-git-commit`。
 - 对于每个可执行钩子，根据其 `optional` 标志输出以下内容：
   - **可选钩子** (`optional: true`):
 
@@ -287,7 +287,7 @@ OUTPUT_FILE = "{OUTPUT_DIR}/{short-name}_业务方案.md"
 - **如果 ✅ 10/10 通过**：
 
   ```
-  📋 建议下一步执行：/adspecs-prd {需求概要}
+  📋 建议下一步执行：/ads-prd {需求概要}
   ```
 
 - **如果 ⚠️ N/10 通过（有 ⚠️ 无 ❌）**：
@@ -296,7 +296,7 @@ OUTPUT_FILE = "{OUTPUT_DIR}/{short-name}_业务方案.md"
   ⚠️ 在编写 PRD 之前，建议先补充以下信息：
   1. {未通过的检查项对应的待补充内容}
   2. {待补充项 2}
-  补充完成后可直接执行 /adspecs-prd
+  补充完成后可直接执行 /ads-prd
   ```
 
 - **如果 ❌ N/10 通过（有 ❌）**：
@@ -437,7 +437,7 @@ OUTPUT_FILE = "{OUTPUT_DIR}/{short-name}_业务方案.md"
 - 对于每个剩余的钩子，**不要** 尝试解释或评估钩子的 `condition` 表达式：
   - 如果钩子没有 `condition` 字段，或为空/null，视为可执行。
   - 如果钩子定义了非空的 `condition`，跳过该钩子，将条件评估留给 HookExecutor 实现。
-- 从钩子命令名构造斜杠命令时，将点号（`.`）替换为连字符（`-`）。例如：`adspecs.git.commit` → `/adspecs-git-commit`。
+- 从钩子命令名构造斜杠命令时，将点号（`.`）替换为连字符（`-`）。例如：`adspecs.git.commit` → `/ads-git-commit`。
 - 对于每个可执行钩子，根据其 `optional` 标志输出以下内容：
   - **必选钩子** (`optional: false`) — **必须为每个必选钩子发出 `EXECUTE_COMMAND:`**：
 
@@ -501,19 +501,19 @@ OUTPUT_FILE = "{OUTPUT_DIR}/{short-name}_业务方案.md"
 ## 后续建议
 
 1. 人工复核交叉引用一致性（特别是状态枚举值和角色权限）
-2. 可继续执行 `/adspecs-prd` 基于业务方案编写产品需求说明书
-3. 如需导出 Word，可执行 `/adspecs-export-word`（Mermaid 图将自动渲染）
+2. 可继续执行 `/ads-prd` 基于业务方案编写产品需求说明书
+3. 如需导出 Word，可执行 `/ads-export-word`（Mermaid 图将自动渲染）
 ```
 
 ## 与上下游的关系
 
 | 上游                                     | 本 skill                | 下游                     |
 | ---------------------------------------- | ----------------------- | ------------------------ |
-| `adspecs-new-requirement` → 需求分析文档 | `adspecs-biz-blueprint` | → `adspecs-prd` PRD 编写 |
+| `ads-new-requirement` → 需求分析文档 | `ads-biz-blueprint` | → `ads-prd` PRD 编写 |
 
-- **输入**：业务需求分析文档（由 `/adspecs-new-requirement` 生成）
+- **输入**：业务需求分析文档（由 `/ads-new-requirement` 生成）
 - **输出**：业务方案文件（F1~F6 体系）
-- **下游消费**：PRD 编写（`/adspecs-prd`）引用业务方案中的 F3 流程步骤、F4 字段定义、F5 规则清单、F6 权限矩阵，构建用户故事和功能描述
+- **下游消费**：PRD 编写（`/ads-prd`）引用业务方案中的 F3 流程步骤、F4 字段定义、F5 规则清单、F6 权限矩阵，构建用户故事和功能描述
 
 ## 快速指南
 
@@ -521,10 +521,10 @@ OUTPUT_FILE = "{OUTPUT_DIR}/{short-name}_业务方案.md"
 
 ```bash
 # 转换指定需求分析文件
-/adspecs-biz-blueprint docs/00-customer-requirements/M03-02/M03-02_bonded-material_业务需求分析.md
+/ads-biz-blueprint docs/00-customer-requirements/M03-02/M03-02_bonded-material_业务需求分析.md
 
 # 如无参数，将提示输入需求分析文件路径
-/adspecs-biz-blueprint
+/ads-biz-blueprint
 ```
 
 ### 转化策略

package/skills/{adspecs-clarify → ads-clarify}/SKILL.md

@@ -1,5 +1,5 @@
 ---
-name: "adspecs-clarify"
+name: "ads-clarify"
 description: "通过最多 5 个高度针对性的澄清问题，识别当前功能 spec 中欠明确的区域，并将答案编码回 spec 文件。"
 agent_created: true
 argument-hint: "spec 中需要澄清的可选区域"
@@ -29,7 +29,7 @@ $ARGUMENTS
 - 对于每个剩余的钩子，**不要** 尝试解释或评估钩子的 `condition` 表达式：
   - 如果钩子没有 `condition` 字段，或为空/null，视为可执行。
   - 如果钩子定义了非空的 `condition`，跳过该钩子，将条件评估留给 HookExecutor 实现。
-- 从钩子命令名构造斜杠命令时，将点号（`.`）替换为连字符（`-`）。例如：`adspecs.git.commit` → `/adspecs-git-commit`。
+- 从钩子命令名构造斜杠命令时，将点号（`.`）替换为连字符（`-`）。例如：`adspecs.git.commit` → `/ads-git-commit`。
 - 对于每个可执行钩子，根据其 `optional` 标志输出以下内容：
   - **可选钩子** (`optional: true`):
 
@@ -62,7 +62,7 @@ $ARGUMENTS
 
 目标：检测并减少当前功能 spec 中的模糊性或缺失的决策点，并将澄清记录直接写入 spec 文件。
 
-注意：此澄清工作流预期在调用 `/adspecs-plan` **之前** 运行（并完成）。如果用户明确表示跳过澄清（例如探索性 spike），可以继续，但必须警告下游返工风险增加。
+注意：此澄清工作流预期在调用 `/ads-plan` **之前** 运行（并完成）。如果用户明确表示跳过澄清（例如探索性 spike），可以继续，但必须警告下游返工风险增加。
 
 执行步骤：
 
@@ -73,7 +73,7 @@ $ARGUMENTS
    - `FEATURE_DIR`
    - `FEATURE_SPEC`
    - （可选捕获 `IMPL_PLAN`、`TASKS` 供未来的链式流程使用。）
-   - 如果 JSON 解析失败，中止并指示用户重新运行 `/adspecs-prd` 或验证 feature branch 环境。
+   - 如果 JSON 解析失败，中止并指示用户重新运行 `/ads-prd` 或验证 feature branch 环境。
    - 对于参数中的单引号如 "I'm Groot"，使用转义语法：例如 'I'\''m Groot'（或如果可能，使用双引号："I'm Groot"）。
 
 2. 加载当前 spec 文件。使用以下分类法执行结构化模糊度和覆盖度扫描。为每个类别标记状态：Clear / Partial / Missing。生成用于优先排序的内部覆盖度映射（不要输出原始映射，除非没有问题可问）。
@@ -233,7 +233,7 @@ $ARGUMENTS
 行为规则：
 
 - 如果没有发现有意义模糊点（或所有潜在问题都是低影响的），回复："未检测到值得正式澄清的关键模糊点。" 并建议继续。
-- 如果 spec 文件缺失，指示用户先运行 `/adspecs-prd`（不要在此创建新 spec）。
+- 如果 spec 文件缺失，指示用户先运行 `/ads-prd`（不要在此创建新 spec）。
 - 永远不要超过 5 个已问问题（对单个问题的澄清重试不计为新问题）。
 - 避免推测性技术栈问题，除非其缺失阻碍功能清晰性。
 - 尊重用户提前终止信号（"stop"、"done"、"proceed"）。
@@ -255,7 +255,7 @@ $ARGUMENTS
 - 对于每个剩余的钩子，**不要** 尝试解释或评估钩子的 `condition` 表达式：
   - 如果钩子没有 `condition` 字段，或为空/null，视为可执行。
   - 如果钩子定义了非空的 `condition`，跳过该钩子，将条件评估留给 HookExecutor 实现。
-- 从钩子命令名构造斜杠命令时，将点号（`.`）替换为连字符（`-`）。例如：`adspecs.git.commit` → `/adspecs-git-commit`。
+- 从钩子命令名构造斜杠命令时，将点号（`.`）替换为连字符（`-`）。例如：`adspecs.git.commit` → `/ads-git-commit`。
 - 对于每个可执行钩子，根据其 `optional` 标志输出以下内容：
   - **必选钩子** (`optional: false`) — **必须为每个必选钩子发出 `EXECUTE_COMMAND:`**：
 
@@ -289,7 +289,7 @@ $ARGUMENTS
 - 涉及的章节（列出名称）。
 - Spec 质量检查清单状态（如果 `FEATURE_DIR/checklists/requirements.md` 被重新验证）：显示之前/之后通过数（例如 "Spec Quality Checklist: 12/16 → 15/16 items passing"）并列出任何状态发生变化的项 — 包括新增已勾选（未勾选 → 已勾选）和任何退回（已勾选 → 未勾选）。如果有任何项仍未勾选，将它们列为需要关注的领域。
 - 覆盖度摘要表，列出每个分类法类别的状态：Resolved（之前 Partial/Missing 且已处理）、Deferred（超过问题配额或更适合计划阶段处理）、Clear（已足够）、Outstanding（仍 Partial/Missing 但低影响）。
-- 如果存在任何 Outstanding 或 Deferred，建议是继续 `/adspecs-plan` 还是在计划后再次运行 `/adspecs-clarify`。
+- 如果存在任何 Outstanding 或 Deferred，建议是继续 `/ads-plan` 还是在计划后再次运行 `/ads-clarify`。
 - 建议的下一步命令。
 
 ## 完成标志

package/skills/{adspecs-constitution → ads-constitution}/SKILL.md

@@ -1,5 +1,5 @@
 ---
-name: "adspecs-constitution"
+name: "ads-constitution"
 description: "根据交互式输入或提供的原则输入创建或更新项目章程，确保所有依赖模板保持同步。"
 agent_created: true
 argument-hint: "项目章程的原则或价值观"
@@ -30,7 +30,7 @@ $ARGUMENTS
 - 对于每个剩余的钩子，**不要** 尝试解释或评估钩子的 `condition` 表达式：
   - 如果钩子没有 `condition` 字段，或为空/null，视为可执行。
   - 如果钩子定义了非空的 `condition`，跳过该钩子，将条件评估留给 HookExecutor 实现。
-- 从钩子命令名构造斜杠命令时，将点号（`.`）替换为连字符（`-`）。例如：`adspecs.git.commit` → `/adspecs-git-commit`。
+- 从钩子命令名构造斜杠命令时，将点号（`.`）替换为连字符（`-`）。例如：`adspecs.git.commit` → `/ads-git-commit`。
 - 对于每个可执行钩子，根据其 `optional` 标志输出以下内容：
   - **可选钩子** (`optional: true`):
     ```
@@ -134,7 +134,7 @@ $ARGUMENTS
 - 对于每个剩余的钩子，**不要** 尝试解释或评估钩子的 `condition` 表达式：
   - 如果钩子没有 `condition` 字段，或为空/null，视为可执行。
   - 如果钩子定义了非空的 `condition`，跳过该钩子，将条件评估留给 HookExecutor 实现。
-- 从钩子命令名构造斜杠命令时，将点号（`.`）替换为连字符（`-`）。例如：`adspecs.git.commit` → `/adspecs-git-commit`。
+- 从钩子命令名构造斜杠命令时，将点号（`.`）替换为连字符（`-`）。例如：`adspecs.git.commit` → `/ads-git-commit`。
 - 对于每个可执行钩子，根据其 `optional` 标志输出以下内容：
   - **可选钩子** (`optional: true`):
     ```

package/skills/{adspecs-export-word → ads-export-word}/SKILL.md

@@ -1,5 +1,5 @@
 ---
-name: "adspecs-export-word"
+name: "ads-export-word"
 description: "将 Markdown 文档导出为 Word (.docx)，自动生成封面页和目录索引页。支持单文件或批量目录转换。"
 agent_created: true
 argument-hint: "指定 .md 文件路径或目录路径，如 docs/20-prd/xxx.md 或 docs/30-system-design/"
@@ -108,7 +108,7 @@ cd "$SKILL_DIR/references" && npm install
 - 对于每个剩余的钩子，**不要** 尝试解释或评估钩子的 `condition` 表达式：
   - 如果钩子没有 `condition` 字段，或为空/null，视为可执行。
   - 如果钩子定义了非空的 `condition`，跳过该钩子，将条件评估留给 HookExecutor 实现。
-- 从钩子命令名构造斜杠命令时，将点号（`.`）替换为连字符（`-`）。例如：`adspecs.git.commit` → `/adspecs-git-commit`。
+- 从钩子命令名构造斜杠命令时，将点号（`.`）替换为连字符（`-`）。例如：`adspecs.git.commit` → `/ads-git-commit`。
 - 对于每个可执行钩子，根据其 `optional` 标志输出以下内容：
   - **可选钩子** (`optional: true`):
 
@@ -395,7 +395,7 @@ node "{SCRIPT_PATH}" \
 - 对于每个剩余的钩子，**不要** 尝试解释或评估钩子的 `condition` 表达式：
   - 如果钩子没有 `condition` 字段，或为空/null，视为可执行。
   - 如果钩子定义了非空的 `condition`，跳过该钩子，将条件评估留给 HookExecutor 实现。
-- 从钩子命令名构造斜杠命令时，将点号（`.`）替换为连字符（`-`）。例如：`adspecs.git.commit` → `/adspecs-git-commit`。
+- 从钩子命令名构造斜杠命令时，将点号（`.`）替换为连字符（`-`）。例如：`adspecs.git.commit` → `/ads-git-commit`。
 - 对于每个可执行钩子，根据其 `optional` 标志输出以下内容：
   - **必选钩子** (`optional: false`) — **必须为每个必选钩子发出 `EXECUTE_COMMAND:`**：
 
@@ -443,7 +443,7 @@ node "{SCRIPT_PATH}" \
 首次使用前需安装 npm 依赖（仅需执行一次）：
 
 ```bash
-cd skills/adspecs-export-word/references && npm install
+cd skills/ads-export-word/references && npm install
 ```
 
 依赖包括：
@@ -454,19 +454,19 @@ cd skills/adspecs-export-word/references && npm install
 
 ```bash
 # 转换单个文件
-/adspecs-export-word docs/20-prd/crm-prd.md
+/ads-export-word docs/20-prd/crm-prd.md
 
 # 转换目录下所有文件
-/adspecs-export-word docs/30-system-design/
+/ads-export-word docs/30-system-design/
 
 # 递归转换目录及子目录
-/adspecs-export-word docs/ --recursive
+/ads-export-word docs/ --recursive
 
 # 指定输出路径
-/adspecs-export-word docs/20-prd/crm-prd.md --output /tmp/exports/
+/ads-export-word docs/20-prd/crm-prd.md --output /tmp/exports/
 
 # 不生成封面页和目录
-/adspecs-export-word docs/20-prd/crm-prd.md --no-cover --no-toc
+/ads-export-word docs/20-prd/crm-prd.md --no-cover --no-toc
 ```
 
 ### 封面页与目录