speccore 8.3.181 → 8.3.188

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

@@ -10,173 +10,6 @@ allowed-tools: ["Bash", "Read"]
 disable-model-invocation: false
 ---
 
-# spec-analyze — 需求分析（专属逻辑）
+直接执行: execute_command("speccore ask '用户原话'")
 
-> **定位**：`/analyze` 快捷入口的专属预处理层
-> **原则**：不影响 `speccore ask` 的意图识别能力
-
----
-
-## 调用方式
-
-```
-/analyze [参数]
-/analyze -I Iteration-001 --auto
-/analyze -I Iteration-001 --scope global --with-code
-/analyze -I Iteration-001 --clarify
-```
-
----
-
-## 执行流程
-
-```
-用户输入 /analyze [参数]
-        │
-        ▼
-┌───────────────────────────────────────┐
-│ Step 1: 参数提取                        │
-│ 从用户输入提取 iteration/scope/auto 等   │
-└───────────────┬───────────────────────┘
-                │
-        参数缺失？
-                │
-        是 ──► 输出交互式提示
-                │
-        否 ──► 继续
-                │
-                ▼
-┌───────────────────────────────────────┐
-│ Step 2: 参数补全                        │
-│ iteration 缺失 → 读 context.json         │
-│ scope 缺失 → 根据上下文推断              │
-└───────────────┬───────────────────────┘
-                │
-                ▼
-┌───────────────────────────────────────┐
-│ Step 3: 前置校验                        │
-│ - 迭代是否存在？                        │
-│ - 需求文档是否存在？                    │
-│ - 需求专业度评估（clarify）             │
-│ - CONSTITUTION 端列表读取               │
-└───────────────┬───────────────────────┘
-                │
-                ▼
-┌───────────────────────────────────────┐
-│ Step 4: 调用 speccore ask               │
-└───────────────────────────────────────┘
-```
-
----
-
-## Step 1: 参数提取
-
-| 参数 | 短名 | 长名 | 必填 | 说明 |
-|:---|:---|:---|:---|:---|
-| iteration | -i | --iteration | 否 | 目标迭代名 |
-| scope | -s | --scope | 否 | 分析范围: global / iteration / task |
-| auto | -a | --auto | 否 | 全自动模式（不交互）|
-| with-code | -c | --with-code | 否 | 结合源码分析 |
-| full | -f | --full | 否 | 全自动三阶段合成（原 synthesize）|
-| phase | -p | --phase | 否 | 单阶段执行 1/2/3 |
-| clarify | - | --clarify | 否 | 需求专业度检测，口语化时触发 clarify |
-| dev-guide | - | --dev-guide | 否 | 生成 DEV_GUIDE.md 实现指南 |
-| platforms | - | --platforms | 否 | 只分析指定端 |
-| prompt | - | --prompt | 否 | 只输出 Prompt，不执行 |
-| apply | - | --apply | 否 | 应用 AI 分析结果（支持 @file.json）|
-
----
-
-## Step 2: 参数缺失 → 交互式提示
-
-```
-🔍 speccore analyze — 需求分析
-
-━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
-📋 当前环境
-━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
-迭代: Iteration-001-meeting-system（从 context.json 读取）
-端列表: api, h5-mobile, admin-web（从 CONSTITUTION.md 读取）
-
-━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
-📖 可用参数
-━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
-  -I, --iteration <name>    目标迭代（默认: 当前迭代）
-  -s, --scope <scope>       分析范围:
-                            global    — 全局层分析（项目级，跨端）
-                            iteration — 迭代级分析（默认）
-                            task      — 任务级分析
-  -a, --auto                全自动模式（不交互，直接输出）
-  -c, --with-code           结合源码分析（扫描各端源码）
-      --full                全自动三阶段合成（原 synthesize --full）
-      --phase <N>           单阶段执行: 1(逐端) | 2(跨端) | 3(索引)
-      --clarify             需求专业度检测，口语化时自动触发澄清
-      --dev-guide           同时生成 DEV_GUIDE.md 开发者实现指南
-      --platforms <list>    只分析指定端（如 api,h5）
-      --prompt              只输出 Prompt，不执行分析
-      --apply <json|@file>  应用 AI 分析结果（支持 @file.json 文件方式）
-
-━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
-💡 使用示例
-━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
-  /analyze -I Q1 --auto                   # 全自动分析迭代
-  /analyze --scope global --with-code     # 全局层 + 源码分析
-  /analyze --full                         # 三阶段全量合成
-  /analyze --clarify                      # 检测需求专业度
-  /analyze --dev-guide                    # 分析 + 生成实现指南
-  /analyze --platforms api,h5             # 只分析 api 和 h5 端
-  /analyze --prompt                       # 只输出 Prompt
-
-请补充参数后重新调用，或直接调用 /analyze 使用默认设置。
-```
-
----
-
-## Step 3: 前置校验
-
-### 3.1 检查迭代是否存在
-```bash
-# 检查迭代目录是否存在
-# 如果不存在 → 提示用户先创建迭代
-```
-
-### 3.2 检查需求文档
-```bash
-# 检查 010-requirements/REQUIREMENT.md 或 converted/*.md 是否存在
-# 如果不存在 → 提示用户先准备需求文档
-```
-
-### 3.3 需求专业度检测（--clarify）
-```bash
-# 读取 REQUIREMENT.md 或用户输入
-# 检测指标：
-#   - 口语化表达（"我要/我想/能不能"）
-#   - 缺少结构化标题（## / ###）
-#   - 缺少验收标准
-#   - 缺少技术约束
-#   - 缺少错误处理
-#   - 缺少数据模型
-# 如果专业度低 → 提示用户先执行 clarify
-```
-
-### 3.4 读取端列表
-```bash
-# 从 CONSTITUTION.md 读取项目配置的端列表
-# 如果 --platforms 指定了不存在的端 → 提示可用端
-```
-
-### 3.5 检查 --apply 文件
-```bash
-# 如果 --apply 以 @ 开头，从文件读取 JSON
-# 检查文件是否存在
-```
-
----
-
-## Step 4: 调用 speccore ask
-
-```bash
-execute_command("speccore ask '分析 Iteration-XXX...'")
-```
-
-> ⚠️ 最终仍然调用 `speccore ask`，不要绕过 ask 引擎。
+不要输出命令文本，不要分析意图，一切交给 speccore ask。

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

@@ -20,181 +20,6 @@ allowed-tools: ["Bash", "Read", "Write", "Edit"]
 disable-model-invocation: false
 ---
 
-# SpecCore Ask — AI 语义分析引擎
+直接执行: execute_command("speccore ask '用户原话'")
 
-## 🎯 Speccore 输出标记处理
-
-执行任何 `speccore` 命令后，检查 stdout 中的标记：
-- `[SPECCORE_ONBOARD: <path>]` → **🚨 必须最先处理，不可跳过，不可只口头提及**：
-  1. **立即执行** `present_files(<path>)` 展示 HTML 引导页（Qoder/Trae/Cursor 均支持）
-  2. ❌ 禁止只说“检测到引导页”而不执行展示动作 — 说了不等于做了
-  3. ❌ 禁止用文字描述引导页内容代替实际展示 — 必须让用户看到 HTML 页面
-  4. **展示完成后**，再继续处理其他输出（结果、意图确认等）
-- `[SPECCORE_SETUP_GUIDE: <path>]` → **立即执行** `present_files(<path>)` 展示配置引导页
-- `[SPECCORE_ABOUT: <path>]` → **立即执行** `present_files(<path>)` 展示版本信息页
-- `[SPECCORE_HELP: <path>]` → **立即执行** `present_files(<path>)` 展示帮助中心页
-- `[SPECCORE_WELCOME: <path>]` → **立即执行** `present_files(<path>)` 展示项目名片页
-- `[SPECCORE_DEV: <path>]` → **立即执行** `present_files(<path>)` 展示开发流程页
-- `[SPECCORE_KNOWLEDGE: <path>]` → **立即执行** `present_files(<path>)` 展示知识图谱页
-- `[SPECCORE_PLAN: <path>]` → **立即执行** `present_files(<path>)` 展示执行计划页
-- `[SPECCORE_RETRO: <path>]` → **立即执行** `present_files(<path>)` 展示回顾报告页
-- `[SPECCORE_DASHBOARD: <path>]` → **立即执行** `present_files(<path>)` 展示仪表盘页
-- `[SPECCORE_EXEC: <cmd>]` → 直接 `execute_command` 执行
-- `[SPECCORE_INTENT]` → 展示给用户确认
-
-## ⛔ 最高优先级：用户意图优先于效率判断
-
-本规则覆盖你的默认行为。当用户说"重新/再/重跑"时：
-- ✅ 你有合理的确认理由（如"这会覆盖旧结果"），可以先问用户，再执行
-- ✅ 没什么可确认的，直接执行
-- ❌ 禁止检查文件时间戳判断"有无变更"并以此拒绝
-- ❌ 禁止说"结果相同/已完成/无需操作"并以此拒绝
-- 记住：确认≠拒绝。你可以确认，但不能替代用户做决定
-
-## ⛔ 分析必须落盘，禁止只说不写
-
-- 分析结果**必须**通过 `speccore analyze --prompt` 获取模板 → Read 需求文档 → 填充 → `speccore analyze --apply` 写入 020-specs/
-- **禁止**在聊天窗口里输出一段分析文字就完事
-- **禁止**说"基于文档内容的人工分析"而跳过 CLI 落盘
-- 用户要的是 Spec 文档文件，不是聊天消息
-
-## 🚨 核心铁律
-
-1. **每步必确认** — 用户没明确说"自动/全自动/一键"的，每步展示计划→等确认→再执行
-2. **自动模式分两级**: 
-   - **部分自动**: "analyze 和 plan 自动执行，execute 前确认" → 只跳过确认的步骤
-3. **工作流逻辑重排**: 不管用户口述顺序如何（如"先执行再分析"），你必须根据工作流逻辑重新排序：
-4. **禁止阻断用户正常操作**: 无论什么场景（文件已存在、结果相同、无变更、路径不对），**绝对禁止**说"跳过/无变化/不执行"。你应该：
-   - 先列出发现的问题（如"已有旧分析结果"、"路径配置为空"）
-   - 给用户清晰的选择：继续 / 覆盖 / 跳过 / 停止
-   - **由用户决定**，不是你替用户决定
-5. **analyze 必须区分迭代级 vs 全局级，禁止混淆**: 
-   - **迭代级分析**（默认，用户提到"本迭代""当前迭代"或没提 scope）：
-     - 步骤1: `speccore analyze --prompt -I <iter> --type <type>` → 获取 SPECCORE_PROMPT
-     - 步骤2: **Read 迭代目录下需求文档**（REQUIREMENT.md、010-requirements/sources/ 下的文档）
-     - 步骤3-5: 同下
-   - **全局级分析**（用户明确说"全局""全量""项目分析""所有端"等）：
-     - 步骤1: `speccore analyze --prompt --scope global --with-code` → 获取 SPECCORE_PROMPT
-     - 步骤2: **Read .speccore/CONSTITUTION.md 获取工程源码路径**，从源码路径读各端代码，**禁止读/写迭代目录**
-     - 步骤3: **严格按 prompt 中「当前执行层级 Layer N/4」执行，只做当前层**（v7.2.0+ 分层机制，禁止一次写全部）：
-       - Layer 1 代码索引 → `platforms/{端}/_INDEX.md` + PATTERNS
-       - Layer 2 架构关联 → `platforms/_shared/_ASSOCIATION.md` + `_MODULES.md`
-       - Layer 3 业务深入 → 各端功能模块文档
-       - Layer 4 全局汇总 → `overview/`(REQUIREMENT/ANALYSIS/DEPS/FUNCTION_MAP/INTERACTION_MAP/API_CONTRACT) + `requirements/` + `platforms/`
-     - 步骤4: 每层产物用 `speccore analyze --apply '{"<相对路径>":"...",...}' --scope global` 写入 `.speccore/GLOBAL/`
-     - 步骤5: 看到 [SPECCORE_PIPELINE_NEXT] 或 prompt 提示的下一层命令时**自动继续，不询问用户**，直到 Layer 4 完成
-   - 步骤6: **用户提供参考文档时**: 如果用户附带了格式参考文档（如PDF/Word/截图），先按标准 Spec 模板生成默认文档，再按用户参考格式生成一份，**两边都要**
-   - ❌ 禁止: 跳过文档填充直接写代码、生成重复空壳、用 "API=0" 跳过
-   - ❌ 禁止: 全局分析时 fallback 到迭代目录读取需求文档，或把全局产物写到迭代目录
-   - ❌ 禁止: 只生成单个 ANALYSIS.md 就收尾、用 outputs/ 临时报告代替落盘 —— 必须按层级完成全部文档并写入 `.speccore/GLOBAL/`
-   - ⚠️ 如果模板目录不存在或为空: 用你的专业知识自由撰写，绝不允许产出一行垃圾。你是一个专业的技术架构师和分析师，即使没有参考模板，也能产出高质量文档
-6. **交互式文档编辑**: 分析完成后用户可以对任意文档的任意部分进行修改。支持:
-   - "修改 ANALYSIS.md 的接口清单部分，加上签到接口" → 只改指定章节，不改其他部分
-   - "补充 TECH.md 的部署方案" → Read 现有内容 → 追加指定章节
-   - "重写 RISK.md 的第三项" → 定位 → 修改 → Write
-   `init → doc2spec → analyze → split → plan → execute → pr → done → spec2doc`
-   示例: 用户说"执行完再分析" → 你应该排列为 `analyze → execute`，并在计划中说明"根据工作流逻辑，先分析再执行"
-   - **全自动**: "全自动执行/一键完成" → 所有步骤不等确认，全部自动跑
-3. **迭代/任务命名必加 --topic** — 从用户原话提取英文主题词
-4. **禁止 schedule** — 用户说"定时"时告知不可用、改为立即执行
-5. **-i 参数用短名** — 传 `meeting-system` 而非 `Iteration-009-meeting-system`
-6. **分析前先读源码** — 生成分析内容前必须 Read 相关源文件
-
-## 执行流程
-
-```
-1. execute_command("speccore ask '用户原话' --explicit")
-   → --explicit 标记表示这是 /spec-ask Skill 的显式调用，跳过"是否为 speccore 操作"的确认
-   → 读 KB 输出，了解可用命令
-
-2. 检查上下文，识别自动模式:
-   - "全自动/一键/全流程自动" → FULL_AUTO 全流程
-   - "analyze和plan自动，execute前确认" → PARTIAL_AUTO(1-2)
-   - "自动执行到split，plan和execute前确认" → PARTIAL_AUTO(1-2)
-   - 没说自动 → 每步确认
-
-3. 理解意图 → 拼计划 → 展示:
-   """
-   [自动模式] 将自动执行 step 1-2 (analyze+plan)，step 3 (execute) 前暂停确认。
-   [全程确认] 每步展示结果再继续。
-   
-   step 1: 🔒 AI命令: speccore analyze --prompt -I meeting-system --task user-login
-   step 2: 🔒 AI命令: speccore plan --prompt -I meeting-system --task user-login
-   step 3: 🔒 AI命令: speccore execute --prompt -I meeting-system --task user-login
-   
-   是否确认？
-   """
-
-4. 用户确认后按模式执行:
-   - PARTIAL_AUTO: step 1→2 连续执行，step 3 前暂停问"继续？"
-   - FULL_AUTO: 全部连续执行
-   - 手动: 每步暂停确认
-```
-
-## 关键命令
-
-| 命令 | 格式 | 类型 | 说明 |
-|:---|:---|:---|:---|
-| `doc2spec -f <file> --iter <短名>` | 导入文档 | 🔒 AI | PRD/Word → SpecCore MD，双路验证 |
-| `doc2spec --classify --prompt -I <短名>` | 智能分类 | 🔒 AI | AI 提取 sources/ 文档，按类型分类到 staging/ |
-| `analyze --prompt -I <短名> --task <短名>` | 迭代级分析 | 🔒 AI | 读迭代需求文档，生成 020-specs/ 分析文档 |
-| `analyze --prompt --scope global --with-code` | 全局级分析 | 🔒 AI | 读工程源码，生成 .speccore/GLOBAL/ 架构文档，**禁止读迭代目录** |
-| `analyze --feature <模块名>` | 局部分析功能模块 | 🔒 AI | 只分析单个功能模块，不重跑全量 |
-| `analyze --doc <type/slug>` | 局部分析类型文档 | 🔒 AI | 分析 bugs/login-timeout、refactors/db-pool 等 |
-| `plan --prompt -I <短名> --task <短名>` | 制定计划 | 🔒 AI | 需要宿主 AI 交互，`speccore ask "制定计划..."` 路由进入 |
-| `execute --prompt -I <短名> --task <短名>` | 执行开发 | 🔒 AI | 需要宿主 AI 交互，`speccore ask "执行开发..."` 路由进入 |
-| `iteration split -I <短名>` | 拆分任务 | 🔒 AI | 需要宿主 AI 交互，`speccore ask "拆分任务..."` 路由进入 |
-| `refresh [--code] [--rag] [--graph]` | 刷新索引 | CLI | 统一刷新所有检索层，可单独指定 |
-| `reindex [--check]` | 重建索引 | CLI | 全量重建 + 知识图谱 + 衰减检测 |
-| `context --set --iteration <完整名>` | 切换迭代 | CLI | 可在终端直接输入 |
-| `dashboard` | 查看进度 | CLI | 可在终端直接输入 |
-| `task new -n <名> --topic <英文> -i <短名>` | 创建任务 | CLI | 可在终端直接输入 |
-
-## AI 分析质量要求
-
-执行 analyze --prompt（🔒 AI命令）后:
-1. **根据 scope 读取对应内容**（禁止混淆）：
-   - **迭代级** (`-I <iter>`): Read 迭代目录下需求文档（REQUIREMENT.md、010-requirements/sources/ 下的文档）
-   - **全局级** (`--scope global --with-code`): Read .speccore/CONSTITUTION.md 获取工程源码路径，从源码路径读取各端代码，**禁止读迭代目录**
-2. **分析报告必须包含 7 个文档**（不同任务类型不同集合）:
-
-### 全量分析（feature 类型）
-| 文档 | 内容要求 |
-|:---|:---|
-| **ANALYSIS.md** | 功能点列表、接口清单、数据模型、业务规则、异常处理 |
-| **TECH.md** | 架构方案、数据库 DDL、缓存策略、核心流程图 |
-| **TEST.md** | 单元测试用例、集成测试方案、边界条件 |
-| **REVIEW.md** | 代码审查检查项、安全审查清单 |
-| **RISK.md** | 风险矩阵、缓解措施、回滚方案 |
-| **DEPS.md** | 上下游依赖、SLA 要求 |
-| **MONITOR.md** | 业务监控指标、告警规则 |
-
-### 精简分析（bugfix/research 类型）
-| 文档 | 内容 |
-|:---|:---|
-| ANALYSIS.md | 问题定位 + 修复方案 |
-| TEST.md | 回归测试用例 |
-
-3. **写入格式**: `--apply '{"ANALYSIS.md":"...","TECH.md":"..."}'` JSON 多文档写入
-4. **不要生成空洞模板** — 每个字段都要有具体内容（表名、字段名、接口路径、阈值数值）
-
-## 禁止行为
-
-- ❌ 用户没说自动就全自动跑
-- ❌ schedule 命令（任何形式）
-- ❌ 传完整迭代名到 -i 参数
-- ❌ 分析时不读源码凭空生成
-- ❌ 不展示计划直接执行
-
-## 各阶段完成后的正确下一步
-
-创建迭代/完成某阶段后，必须按流水线顺序建议下一步，禁止跳步：
-
-| 当前阶段 | ✅ 正确下一步 | ❌ 禁止跳步到 |
-|:---|:---|:---|
-| 迭代创建完成 | 导入需求文档（doc2spec） | ~~创建开发任务~~ |
-| 需求导入完成 | 分析需求（analyze） | ~~直接执行~~ |
-| 分析完成 | 拆分任务（split） | ~~直接执行~~ |
-| 拆分完成 | 执行开发（execute） | — |
-
-> 💡 用户没有需求文档时，引导先放文件到 `010-requirements/sources/` 或运行 `doc2spec --classify`。
+不要输出命令文本，不要分析意图，一切交给 speccore ask。

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

@@ -8,218 +8,6 @@ allowed-tools: ["Bash", "Read"]
 disable-model-invocation: false
 ---
 
-# spec-change — 需求变更与新增（专属逻辑）
+直接执行: execute_command("speccore ask '用户原话'")
 
-> **定位**：`/change` 快捷入口的专属预处理层
-> **原则**：不影响 `speccore ask` 的意图识别能力
-
----
-
-## 调用方式
-
-```
-/change [参数]
-/change --prompt "新增一个通知功能"
-/change --prompt "订单模块加个退款接口" -I Iteration-001
-```
-
----
-
-## 执行流程
-
-```
-用户输入 /change [参数]
-        │
-        ▼
-┌───────────────────────────────────────┐
-│ Step 1: 参数提取                        │
-│ 从用户输入提取 iteration/prompt/response │
-└───────────────┬───────────────────────┘
-                │
-        参数缺失？
-                │
-        是 ──► 输出交互式提示
-                │
-        否 ──► 继续
-                │
-                ▼
-┌───────────────────────────────────────┐
-│ Step 2: 参数补全                        │
-│ iteration 缺失 → 读 context.json         │
-│ intent 推断 → 新增 or 变更               │
-└───────────────┬───────────────────────┘
-                │
-                ▼
-┌───────────────────────────────────────┐
-│ Step 3: 前置校验                        │
-│ - 当前迭代是否存在？                    │
-│ - 已有 Task 列表扫描                    │
-│ - 变更类型判断（新增/变更）             │
-│ - 附件检测（inbox/ 目录）               │
-└───────────────┬───────────────────────┘
-                │
-                ▼
-┌───────────────────────────────────────┐
-│ Step 4: 调用 speccore ask               │
-└───────────────────────────────────────┘
-```
-
----
-
-## Step 1: 参数提取
-
-| 参数 | 短名 | 长名 | 必填 | 说明 |
-|:---|:---|:---|:---|:---|
-| iteration | -i | --iteration | 否 | 目标迭代名 |
-| prompt | -p | --prompt | 否 | 生成澄清 Prompt（传入用户原话）|
-| response | -r | --response | 否 | 应用 AI 澄清结果（JSON）|
-| file | -f | --file | 否 | 附件文件路径 |
-| task | -t | --task | 否 | 指定受影响的 Task |
-
----
-
-## Step 2: 参数缺失 → 交互式提示
-
-```
-🔄 speccore change — 需求变更与新增
-
-━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
-📋 当前环境
-━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
-迭代: Iteration-001-meeting-system（从 context.json 读取）
-已有任务: 3 个（Task-001, Task-002, Task-003）
-
-━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
-📖 可用参数
-━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
-  -I, --iteration <name>    目标迭代（默认: 当前迭代）
-  -p, --prompt <text>       用户原始需求描述（用于生成澄清 Prompt）
-  -r, --response <json>     AI 澄清后的结构化结果（JSON）
-  -f, --file <path>         附件文件路径
-  -t, --task <id>           指定受影响的 Task（可选）
-
-━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
-💡 使用示例
-━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
-  /change --prompt "新增一个通知功能"              # 生成澄清 Prompt
-  /change --prompt "订单模块加个退款接口"          # 变更现有功能
-  /change --response '{...json...}'               # 应用澄清结果
-  /change --prompt "新增功能" -f ./PRD.pdf        # 带附件的变更
-
-━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
-🔄 核心流程
-━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
-  1. /change --prompt "你的需求描述"     → 生成澄清 Prompt
-  2. AI 根据 Prompt 生成结构化 JSON       → 展示给用户确认
-  3. 用户确认后                         → /change --response '{JSON}'
-  4. CLI 解析 JSON 并写入文件            → 完成变更/新增
-
-请补充 --prompt 参数后重新调用。
-```
-
----
-
-## Step 3: 前置校验
-
-### 3.1 检查迭代是否存在
-```bash
-# 检查迭代目录是否存在
-# 如果不存在 → 提示用户先创建迭代
-```
-
-### 3.2 扫描已有 Task
-```bash
-# 读取 030-tasks/ 下的 Task 列表
-# 用于判断变更影响范围（直接/间接/无影响）
-```
-
-### 3.3 变更类型判断
-```bash
-# 根据用户输入判断意图：
-#   "新增/加/创建/实现 + 描述" → 🆕 新增需求
-#   "{task} 需求变了/要改/修改" → 🔄 需求变更
-#   模糊描述 → AI 判断并询问用户
-```
-
-### 3.4 附件检测
-```bash
-# 检查 .speccore/inbox/ 目录是否有文件
-# 检查用户是否通过 --file 指定了附件
-# 有附件时，澄清 Prompt 自动包含附件内容
-```
-
----
-
-## Step 4: 调用 speccore ask
-
-```bash
-execute_command("speccore ask '处理需求变更...'")
-```
-
-> ⚠️ 最终仍然调用 `speccore ask`，不要绕过 ask 引擎。
-
----
-
-## 核心流程（保留）
-
-```
-用户自然语言输入（如 "新增一个通知功能" 或 "订单模块加个退款接口"）
-        │
-        ▼
-┌─ 1. 澄清 Prompt ──────────────────────────────────────┐
-│  execute_command("speccore change --prompt \"{用户原话}\"")│
-│  → CLI 输出澄清 Prompt（含附件 + 已有任务上下文）       │
-└───────────────┬────────────────────────────────────────┘
-                │
-                ▼
-┌─ 2. AI 澄清 ──────────────────────────────────────────┐
-│  你（AI）根据 Prompt 生成结构化 JSON:                   │
-│  {                                                     │
-│    "intent": "new" | "change",                         │
-│    "structuredDesc": "结构化需求描述",                  │
-│    "keyPoints": ["功能要点1", "功能要点2"],             │
-│    "acceptanceCriteria": ["验收标准1", "验收标准2"],     │
-│    "impactReport": { "directTasks": [...], ... }       │
-│  }                                                     │
-└───────────────┬────────────────────────────────────────┘
-                │
-                ▼
-┌─ 3. ⚠️ 展示给用户确认（关键！）──────────────────────┐
-│  将澄清结果以易读格式展示给用户:                       │
-│                                                       │
-│  📋 需求澄清结果:                                     │
-│  - 意图: 🆕 新增 / 🔄 变更                            │
-│  - 结构化描述: ...                                     │
-│  - 功能要点: 1. ... 2. ... 3. ...                     │
-│  - 验收标准: ☐ ... ☐ ...                              │
-│  - 影响范围: Task-001(直接), Task-003(间接)            │
-│                                                       │
-│  然后问用户: "以上理解是否正确？需要调整什么？"         │
-│                                                       │
-│  ┌─ 用户说"可以/确认" ─→ 进入步骤 4                   │
-│  └─ 用户说"不对/要改" ─→ 根据反馈重新澄清（回步骤 2） │
-│                                                       │
-│  ⚠️ 这一步不可跳过！必须让用户确认后才写入文件。      │
-└───────────────┬────────────────────────────────────────┘
-                │ 用户确认
-                ▼
-┌─ 4. 持久化 ───────────────────────────────────────────┐
-│  execute_command("speccore change --response '{JSON}'")│
-│  → CLI 解析 JSON → 写入 REQ.md / CHANGE_SUMMARY.md    │
-│  → 新增: 创建 Task 目录 + 00-specs/REQ.md             │
-│  → 变更: 更新受影响任务的 Spec + 记录变更历史           │
-└───────────────┬────────────────────────────────────────┘
-                │
-                ▼
-┌─ 5. 后续引导 ─────────────────────────────────────────┐
-│  新增需求 → 引导用户: "接下来可以 analyze 或 split"    │
-│  需求变更 → 引导用户: "受影响任务需要 re-execute"      │
-└───────────────────────────────────────────────────────┘
-```
-
-## 铁律
-
-1. **澄清结果必须展示给用户确认** — 不能 AI 自己决定就写入文件
-2. **用户不满意就反复澄清** — 直到用户说"可以"为止
-3. **澄清 = 需求分析** — 结果必须持久化到 REQ.md，不是临时判断
-4. **不要输出命令文本** — 用 execute_command 执行
+不要输出命令文本，不要分析意图，一切交给 speccore ask。

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

@@ -7,81 +7,6 @@ allowed-tools: ["Bash", "Read"]
 disable-model-invocation: false
 ---
 
-# spec-dashboard — 仪表盘（专属逻辑）
-
-> **定位**：`/dashboard` 快捷入口的专属预处理层
-> **原则**：不影响 `speccore ask` 的意图识别能力
-
----
-
-## 调用方式
-
-```
-/dashboard
-/dashboard --scope global
-```
-
----
-
-## 执行流程
-
-```
-用户输入 /dashboard
-        │
-        ▼
-┌───────────────────────────────────────┐
-│ Step 1: 前置校验                        │
-│ 检查 context.json 中是否有 currentIteration│
-└───────────────────────────────────────┘
-        │
-   ┌────┴────┐
-   ▼         ▼
- 无迭代      有迭代
-   │         │
-   ▼         ▼
-输出提示    调用 ask
-引导创建    执行 dashboard
-```
-
----
-
-## 前置校验
-
-### 检查活跃迭代
-
-```bash
-# 读取 context.json 中的 currentIteration
-current=$(cat .speccore/local/context.json 2>/dev/null | grep -o '"currentIteration"[^,]*' | grep -o '"[^"]*"' | tail -1 | tr -d '"')
-
-if [ -n "$current" ] && [ "$current" != "null" ]; then
-  echo "has-iteration: $current"
-else
-  echo "no-iteration"
-fi
-```
-
-### 无迭代时的交互提示
-
-```
-📊 仪表盘
-
-当前没有活跃的迭代。
-
-建议操作：
-  speccore iteration create -n <迭代名称>   # 创建新迭代
-  speccore context --set --iteration <名称>   # 切换到已有迭代
-
-创建迭代后，可重新执行 /dashboard 查看项目进度。
-```
-
----
-
-## 执行
-
-有活跃迭代时，直接调用 `speccore ask`：
-
-```
-直接执行: execute_command("speccore ask '显示项目仪表盘'")
+直接执行: execute_command("speccore ask '用户原话'")
 
 不要输出命令文本，不要分析意图，一切交给 speccore ask。
-```