speccore 8.3.181 → 8.3.188

package/.agents/skills/spec-deploy/SKILL.md

@@ -10,302 +10,6 @@ allowed-tools: ["Bash", "Read"]
 disable-model-invocation: false
 ---
 
-# spec-deploy — 构建与部署（专属逻辑）
+直接执行: execute_command("speccore ask '用户原话'")
 
-> **定位**：`/deploy` 快捷入口的专属预处理层
-> **覆盖命令**：`speccore build`、`speccore deploy`、`speccore pipeline`
-> **原则**：不影响 `speccore ask` 的意图识别能力
-
----
-
-## 调用方式
-
-```
-/deploy [自然语言或参数]
-/deploy 部署到测试环境
-/deploy --env test --platforms h5,api
-/deploy --env staging --all --dry-run
-/build --platform h5 --env local
-
-# 测试外部项目（非当前 SpecCore 项目）
-/deploy --project-dir ~/projects/other-app --env staging --all
-/verify --project-dir ~/projects/third-party-api --config ./tests/api.yaml --env-file test
-```
-
----
-
-## 外部项目支持（v8.3.60+）
-
-`--project-dir` 是**全局选项**，所有命令自动继承。SpecCore 的能力可以"走出去"，用于任意外部项目，不仅限于当前 SpecCore 管理的项目。
-
-### 原理
-
-```
-speccore <任意命令> --project-dir <外部目录>
-         │
-         ▼
-    全局 preAction hook
-         │
-         ▼
-    process.chdir(外部目录)
-         │
-         ▼
-    所有配置从外部目录读取
-    所有操作在外部目录执行
-```
-
-### 外部项目目录结构
-
-```
-~/my-test-projects/
-├── company-app/
-│   ├── PROJECT.yaml                    # 定义 platforms（可选）
-│   ├── .speccore/
-│   │   └── environments/
-│   │       ├── staging.yaml            # 环境配置 + tests.base_urls
-│   │       └── production.yaml
-│   ├── tests/
-│   │   ├── smoke.yaml                  # 测试场景
-│   │   └── api.yaml
-│   └── API_CONTRACT.yaml               # API 契约（可选）
-│
-└── third-party-api/
-    ├── .speccore/
-    │   └── environments/
-    │       └── test.yaml
-    └── tests/
-        └── quick.yaml
-```
-
-### 各命令外部项目示例
-
-```bash
-# ===== 测试相关 =====
-# Pipeline 测试外部项目
-speccore pipeline --project-dir ~/my-test-projects/company-app --env staging --all
-
-# Verify 测试外部项目
-speccore verify --project-dir ~/my-test-projects/company-app --config ./tests/smoke.yaml
-
-# 仅做构建检查（无需 PROJECT.yaml）
-speccore verify --project-dir ~/my-test-projects/company-app --ui --url https://staging.example.com
-
-# ===== 文档转换（像 doc2spec 一样外用）=====
-# 将外部项目的 PRD 转换为 Spec
-speccore doc2spec --project-dir ~/my-test-projects/company-app --input ./docs/requirement.docx
-
-# 将外部项目的 Spec 导出为 Word
-speccore spec2doc --project-dir ~/my-test-projects/company-app --output ./reports/
-
-# ===== 项目诊断 =====
-# 诊断外部项目的健康度
-speccore doctor --project-dir ~/my-test-projects/company-app --fix
-
-# ===== 搜索 =====
-# 在外部项目中搜索文档
-speccore search --project-dir ~/my-test-projects/company-app "登录相关的需求"
-
-# ===== 构建部署 =====
-# 构建/部署外部项目
-speccore build --project-dir ~/my-test-projects/company-app --env staging --platform h5
-speccore deploy --project-dir ~/my-test-projects/company-app --env staging --all
-```
-
-### 最小外部项目配置
-
-外部项目可以只有环境配置，无需完整的 SpecCore 项目结构：
-
-```yaml
-# ~/my-test-projects/minimal/.speccore/environments/test.yaml
-env: test
-tests:
-  base_urls:
-    h5: https://example.com
-```
-
-```bash
-speccore verify --project-dir ~/my-test-projects/minimal --ui --env-file test
-```
-
----
-
-## 执行流程
-
-```
-用户输入 /deploy [输入]
-        │
-        ▼
-┌───────────────────────────────────────┐
-│ Step 1: 意图识别                        │
-│ 判断是 build / deploy / pipeline        │
-│ 从自然语言或显式参数提取参数              │
-└───────────────┬───────────────────────┘
-                │
-        参数缺失？
-                │
-        是 ──► 输出交互式提示
-                │
-        否 ──► 继续
-                │
-                ▼
-┌───────────────────────────────────────┐
-│ Step 2: 前置校验                        │
-│ - 环境配置是否存在？                    │
-│ - 指定平台是否在 PROJECT.yaml 中？      │
-│ - 当前分支是否能获取？（pipeline 需要）  │
-└───────────────┬───────────────────────┘
-                │
-        校验失败？
-                │
-        是 ──► 输出问题 + 修复建议
-                │
-        否 ──► 继续
-                │
-                ▼
-┌───────────────────────────────────────┐
-│ Step 3: 执行                            │
-│ 直接 execute_command 执行 CLI 命令      │
-└───────────────────────────────────────┘
-```
-
----
-
-## Step 1: 意图识别与参数提取
-
-### 双模式支持
-
-**模式 A — 自然语言（默认）**：
-```
-/deploy 把当前功能部署到测试环境
-/deploy 构建一下 H5
-/deploy 预览生产环境部署
-```
-AI 从自然语言中提取参数。
-
-**模式 B — 显式参数**：
-```
-/deploy --env test --platforms h5,api --dry-run
-/build --env local --platform h5
-```
-直接解析参数，不经过自然语言理解。
-
-### 参数定义
-
-| 参数 | 短名 | 长名 | 必填 | 默认值 | 说明 |
-|:---|:---|:---|:---|:---|:---|
-| env | -e | --env | 否 | `staging` | 目标环境名（对应 .speccore/environments/{env}.yaml） |
-| platforms | -p | --platforms | 否 | - | 逗号分隔端列表（与 --all 互斥） |
-| all | -a | --all | 否 | false | 所有端 |
-| dry-run | -d | --dry-run | 否 | false | 预览模式，不实际执行 |
-| skip-build | -s | --skip-build | 否 | false | 跳过构建（仅 pipeline） |
-| env-file | -f | --env-file | 否 | - | 指定环境配置文件路径 |
-| project-dir | - | --project-dir | 否 | - | 外部项目目录路径（全局选项） |
-
-### 意图映射表
-
-| 用户说法 | 推断命令 | 推断参数 |
-|:---|:---|:---|
-| "部署到测试环境" | pipeline | --env test --all |
-| "构建 H5" | build | --platform h5 |
-| "部署 H5 到测试环境" | pipeline | --env test --platforms h5 |
-| "预览生产部署" | pipeline | --env production --all --dry-run |
-| "把当前分支合并到 develop 并部署" | pipeline | --env dev --all |
-| "只部署不构建" | pipeline | --env staging --all --skip-build |
-| "用自定义配置部署" | pipeline | --env-file ./my-env.yaml --all |
-| "本地构建验证" | build | --env local --platform h5 |
-| "本地部署看看效果" | deploy | --env local --platform h5 |
-| "跑冒烟测试" | verify | --stage deploy |
-| "PR 前跑测试" | verify | --stage pr |
-| "发布前全量回归" | verify | --stage release |
-
----
-
-## Step 2: 参数缺失 → 交互式提示
-
-### 环境名缺失
-
-```
-🚀 speccore deploy — 请选择目标环境
-
-可用环境（从 .speccore/environments/ 读取）：
-  [1] local    — 本地开发
-  [2] dev      — 开发联调
-  [3] test     — 测试环境
-  [4] staging  — 预发布
-  [5] production — 生产环境
-
-请回复环境名或序号（如：test 或 3）
-```
-
-### 平台缺失（且未指定 --all）
-
-```
-📦 speccore deploy — 请选择目标平台
-
-可用平台（从 PROJECT.yaml 读取）：
-  [1] h5         — H5 移动端
-  [2] admin-web  — 管理后台
-  [3] order-api  — 订单服务
-
-选项：
-  - 回复平台名或序号（如：h5 或 1）
-  - 回复 "all" 或 "全部" 部署所有平台
-  - 回复逗号分隔多选（如：h5,order-api）
-```
-
----
-
-## Step 3: 前置校验
-
-### 校验项
-
-1. **环境配置存在性**
-   - 检查 `.speccore/environments/{env}.yaml` 是否存在
-   - 不存在 → 提示："环境 {env} 未配置，运行 `speccore update` 初始化默认环境配置"
-
-2. **平台有效性**
-   - 检查指定平台是否在 PROJECT.yaml 的 platforms 列表中
-   - 不存在 → 提示可用平台列表
-
-3. **pipeline 分支检查**
-   - 检查环境配置中是否配置了 `branch`
-   - 未配置 → 提示："环境 {env} 未配置 branch，pipeline 无法执行 merge"
-
-4. **Git 仓库检查（pipeline 需要）**
-   - 检查当前目录是否为 Git 仓库
-   - 检查当前分支是否能获取
-
----
-
-## 命令组装规则
-
-### pipeline（默认）
-```bash
-speccore pipeline --env {env} {--platforms p1,p2 | --all} [--dry-run] [--skip-build] [--env-file path] [--project-dir dir]
-```
-
-### build
-```bash
-speccore build --env {env} {--platform p | --all} [--env-file path] [--project-dir dir]
-```
-
-### deploy
-```bash
-speccore deploy --env {env} {--platform p | --all} [--dry-run] [--skip-build] [--env-file path] [--project-dir dir]
-```
-
-**意图 → 命令映射**：
-- 用户说"构建"或"build" → `build`
-- 用户说"部署"且不带 merge/checkout → `deploy`
-- 用户说"流水线"、"合并部署"、"pipeline"或只说"部署"（含 merge 语义）→ `pipeline`
-
----
-
-## 错误处理
-
-| 场景 | 提示 |
-|:---|:---|
-| 环境配置不存在 | "环境 {env} 未配置，运行 `speccore update` 初始化默认环境配置" |
-| 平台不存在 | "平台 {platform} 不在 PROJECT.yaml 中，可用平台：..." |
-| 分支未配置 | "环境 {env} 未配置 branch，pipeline 无法执行 merge" |
-| Git 检查失败 | "当前目录不是 Git 仓库，或无法获取当前分支" |
+不要输出命令文本，不要分析意图，一切交给 speccore ask。

package/.agents/skills/spec-doc2spec/SKILL.md

@@ -8,120 +8,6 @@ allowed-tools: ["Bash", "Read"]
 disable-model-invocation: false
 ---
 
-# spec-doc2spec — 文档转规格（专属逻辑）
+直接执行: execute_command("speccore ask '用户原话'")
 
-> **定位**：`/doc2spec` 快捷入口的专属预处理层
-> **原则**：不影响 `speccore ask` 的意图识别能力
-
----
-
-## 调用方式
-
-```
-/doc2spec [参数]
-/doc2spec --file PRD.pdf -I Iteration-001
-/doc2spec --file requirements.docx --output 010-requirements/converted/
-```
-
----
-
-## 执行流程
-
-```
-用户输入 /doc2spec [参数]
-        │
-        ▼
-┌───────────────────────────────────────┐
-│ Step 1: 参数提取                        │
-│ 从用户输入提取 file/iteration/output 等 │
-└───────────────┬───────────────────────┘
-                │
-        参数缺失？
-                │
-        是 ──► 输出交互式提示
-                │
-        否 ──► 继续
-                │
-                ▼
-┌───────────────────────────────────────┐
-│ Step 2: 前置校验                        │
-│ - 文件是否存在？                        │
-│ - 格式是否支持？                        │
-│ - 迭代是否存在？                        │
-└───────────────┬───────────────────────┘
-                │
-                ▼
-┌───────────────────────────────────────┐
-│ Step 3: 调用 speccore ask               │
-└───────────────────────────────────────┘
-```
-
----
-
-## Step 1: 参数提取
-
-| 参数 | 短名 | 长名 | 必填 | 说明 |
-|:---|:---|:---|:---|:---|
-| file | -f | --file | 是 | 源文档路径（PDF/DOCX/MD/HTML）|
-| iteration | -i | --iteration | 否 | 目标迭代名 |
-| output | -o | --output | 否 | 输出目录 |
-| prompt | - | --prompt | 否 | 只输出 Prompt，不执行 |
-
----
-
-## Step 2: 参数缺失 → 交互式提示
-
-```
-📄 speccore doc2spec — 文档转规格
-
-━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
-📖 可用参数
-━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
-  -f, --file <path>         源文档路径（必填）
-                            支持: .pdf, .docx, .md, .html, .txt
-  -I, --iteration <name>    目标迭代（默认: 当前迭代）
-  -o, --output <dir>        输出目录（默认: 010-requirements/converted/）
-      --prompt              只输出 Prompt，不执行转换
-
-━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
-💡 使用示例
-━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
-  /doc2spec -f PRD.pdf                      # 转换 PDF 到当前迭代
-  /doc2spec -f requirements.docx -I Q1      # 转换到指定迭代
-  /doc2spec -f design.md -o ./output/       # 指定输出目录
-  /doc2spec -f PRD.pdf --prompt             # 只生成 Prompt
-
-请补充 --file 参数后重新调用。
-```
-
----
-
-## Step 3: 前置校验
-
-### 3.1 检查文件是否存在
-```bash
-# 检查 --file 指定的路径
-# 如果不存在 → 提示用户确认路径
-```
-
-### 3.2 检查文件格式
-```bash
-# 支持的格式: .pdf, .docx, .md, .html, .txt
-# 如果格式不支持 → 提示用户
-```
-
-### 3.3 检查迭代是否存在
-```bash
-# 如果指定了 -I，检查迭代目录是否存在
-# 如果不存在 → 提示用户先创建迭代
-```
-
----
-
-## Step 4: 调用 speccore ask
-
-```bash
-execute_command("speccore ask '将文档转为规格...'")
-```
-
-> ⚠️ 最终仍然调用 `speccore ask`，不要绕过 ask 引擎。
+不要输出命令文本，不要分析意图，一切交给 speccore ask。

package/.agents/skills/spec-done/SKILL.md

@@ -8,207 +8,6 @@ allowed-tools: ["Bash", "Read"]
 disable-model-invocation: false
 ---
 
-# spec-done — 任务归档收尾（专属逻辑）
+直接执行: execute_command("speccore ask '用户原话'")
 
-> **定位**：`/done` 快捷入口的专属预处理层
-> **原则**：不影响 `speccore ask` 的意图识别能力
-
----
-
-## 调用方式
-
-```
-/done [参数]
-/done --task Task-001
-/done --all -I Iteration-001
-/done --task Task-001 --interactive
-```
-
----
-
-## 执行流程
-
-```
-用户输入 /done [参数]
-        │
-        ▼
-┌───────────────────────────────────────┐
-│ Step 1: 参数提取                        │
-│ 从用户输入提取 task/iteration/all 等     │
-└───────────────┬───────────────────────┘
-                │
-        参数缺失？
-                │
-        是 ──► 输出交互式提示
-                │
-        否 ──► 继续
-                │
-                ▼
-┌───────────────────────────────────────┐
-│ Step 2: 前置校验                        │
-│ - Task 是否存在？                       │
-│ - 依赖任务是否已完成？                  │
-│ - feature 分支是否已合并？              │
-│ - 代码是否已提交？                      │
-└───────────────┬───────────────────────┘
-                │
-        校验失败？
-                │
-        是 ──► 输出问题 + 修复建议
-                │
-        否 ──► 继续
-                │
-                ▼
-┌───────────────────────────────────────┐
-│ Step 3: 调用 speccore ask               │
-└───────────────────────────────────────┘
-```
-
----
-
-## Step 1: 参数提取
-
-| 参数 | 短名 | 长名 | 必填 | 说明 |
-|:---|:---|:---|:---|:---|
-| task | -t | --task | 否 | 目标 Task（支持逗号分隔批量）|
-| iteration | -i | --iteration | 否 | 目标迭代名 |
-| all | -a | --all | 否 | 自动扫描已完成任务批量归档 |
-| skipValidate | - | --skip-validate | 否 | 跳过校验 |
-| skipSync | - | --skip-sync | 否 | 跳过全局同步 |
-| interactive | - | --interactive | 否 | 交互式确认 |
-| prompt | -p | --prompt | 否 | 输出验收总结 Prompt |
-| response | -r | --response | 否 | 接收 AI 验收总结 |
-
----
-
-## Step 2: 参数缺失 → 交互式提示
-
-```
-✅ speccore done — 任务归档收尾
-
-━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
-📋 当前环境
-━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
-迭代: Iteration-001-meeting-system（从 context.json 读取）
-已完成任务: 2 个（Task-001, Task-002）
-待归档任务: 1 个（Task-003）
-
-━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
-📖 可用参数
-━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
-  -t, --task <id>           目标 Task（支持逗号分隔批量）
-  -i, --iteration <name>    目标迭代（默认: 当前迭代）
-  -a, --all                 自动扫描已完成任务批量归档
-      --skip-validate       跳过校验
-      --skip-sync           跳过全局同步
-      --interactive         交互式确认（推荐首次使用）
-  -p, --prompt              输出验收总结 Prompt
-  -r, --response <json>     接收 AI 验收总结
-
-━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
-💡 使用示例
-━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
-  /done -t Task-001                         # 归档单个任务
-  /done -t Task-001,Task-002                # 批量归档
-  /done --all                               # 归档所有已完成任务
-  /done --all --interactive                 # 交互式确认
-  /done -t Task-001 --skip-validate         # 跳过校验直接归档
-
-━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
-🔄 执行流程
-━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
-  1. validate  — 规范合规校验
-  2. archive   — 任务归档
-  3. merge     — 新增需求合并回原文档
-  4. sync      — 同步到全局层
-  5. audit     — 生成审计摘要
-
-请补充参数后重新调用。
-```
-
----
-
-## Step 3: 前置校验
-
-### 3.1 Task 存在性检查
-```bash
-# 检查 030-tasks/ 下是否存在该 Task
-# 如果不存在 → 提示可用 Task 列表
-```
-
-### 3.2 依赖任务完成性检查
-```bash
-# 读取 Task/.meta/dependencies
-# 检查依赖的 Task 是否已完成（status=done）
-# 如果有未完成依赖 → 提示用户先完成依赖任务
-```
-
-### 3.3 feature 分支合并检查
-```bash
-# 检查 feature/Task-XXX 分支是否已合并到 main
-# 如果未合并 → 提示用户先合并或创建 PR
-```
-
-### 3.4 代码提交检查
-```bash
-# 检查 Task 对应的 feature 分支是否有未提交代码
-# 如果有 → 提示用户先提交代码（speccore pr）
-```
-
-### 3.5 扫描已完成任务（--all 模式）
-```bash
-# 扫描 030-tasks/ 下 status=done 的任务
-# 列出可归档的任务清单
-```
-
----
-
-## Step 4: 调用 speccore ask
-
-```bash
-execute_command("speccore ask '归档 Task-XXX...'")
-```
-
-> ⚠️ 最终仍然调用 `speccore ask`，不要绕过 ask 引擎。
-
----
-
-## 核心流程（保留）
-
-```
-用户说 "归档 Task-001"
-        │
-        ▼
-┌─ 1. 前置校验 ────────────────────────────────┐
-│  - Task 存在？                               │
-│  - 依赖任务已完成？                           │
-│  - feature 分支已合并？                       │
-│  - 代码已提交？                              │
-└───────────────┬────────────────────────────────┘
-                │
-                ▼
-┌─ 2. 执行收尾（5 步）─────────────────────────┐
-│  1. validate  — 规范合规校验                  │
-│     → 发现问题？warn 并继续（可 --strict 阻断）│
-│  2. archive   — 任务归档                      │
-│     → 移动 Task 到归档目录                     │
-│  3. merge     — 新增需求合并回原文档            │
-│     → 更新 REQUIREMENT.md                     │
-│  4. sync      — 同步到全局层                   │
-│     → 更新 GLOBAL/INDEX.md                    │
-│  5. audit     — 生成审计摘要                   │
-│     → 生成 RETRO.md                          │
-└───────────────┬────────────────────────────────┘
-                │
-                ▼
-┌─ 3. 后续引导 ────────────────────────────────┐
-│  归档完成 → 引导用户 "可以开始 retro 复盘"     │
-│  或 "开始下一个 Task"                         │
-└───────────────────────────────────────────────┘
-```
-
-## 铁律
-
-1. **依赖任务必须先完成** — 不允许跳过依赖直接归档
-2. **feature 分支必须先合并** — 防止代码丢失
-3. **validate 发现问题要提示** — 即使不阻断也要明确告知
+不要输出命令文本，不要分析意图，一切交给 speccore ask。