speccore 8.3.182 → 8.3.188

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

@@ -9,182 +9,6 @@ allowed-tools: ["Bash", "Read"]
 disable-model-invocation: false
 ---
 
-# spec-execute — 执行开发（专属逻辑）
+直接执行: execute_command("speccore ask '用户原话'")
 
-> **定位**：`/execute` 快捷入口的专属预处理层
-> **原则**：不影响 `speccore ask` 的意图识别能力，只在调用 ask 之前做参数校验和上下文准备
-
----
-
-## 调用方式
-
-```
-/execute [参数]
-/execute -t Task-001
-/execute -I Iteration-001 --all
-```
-
----
-
-## 执行流程
-
-```
-用户输入 /execute [参数]
-        │
-        ▼
-┌───────────────────────────────────────┐
-│ Step 1: 参数提取                        │
-│ 从用户输入提取 iteration/task/all 等     │
-└───────────────┬───────────────────────┘
-                │
-        参数缺失？
-                │
-        是 ──► 输出交互式提示
-                │
-        否 ──► 继续
-                │
-                ▼
-┌───────────────────────────────────────┐
-│ Step 2: 前置校验                        │
-│ - 任务是否存在？                        │
-│ - 上游文档是否有更新？                  │
-│ - 代码模式读取（.speccore/PATTERNS/）   │
-└───────────────┬───────────────────────┘
-                │
-                ▼
-┌───────────────────────────────────────┐
-│ Step 3: 调用 speccore ask               │
-└───────────────────────────────────────┘
-```
-
----
-
-## Step 1: 参数提取
-
-| 参数 | 短名 | 长名 | 必填 | 说明 |
-|:---|:---|:---|:---|:---|
-| iteration | -i | --iteration | 否 | 目标迭代名 |
-| task | -t | --task | 否 | 指定任务（与 --all 互斥）|
-| all | -a | --all | 否 | 全部待执行任务 |
-| force | -f | --force | 否 | 跳过确认直接执行 |
-| resume | -r | --resume | 否 | 断点续跑 |
-| batch-size | -b | --batch-size | 否 | 每批任务数（默认 3）|
-| verify | -v | --verify | 否 | 执行后自动验证 |
-| agent | - | --agent | 否 | 外部 AI 工具 |
-
----
-
-## Step 2: 参数缺失 → 交互式提示
-
-```
-🔨 speccore execute — 执行开发
-
-━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
-📋 当前环境
-━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
-迭代: Iteration-001-meeting-system（从 context.json 读取）
-待执行任务: 3 个（Task-001, Task-002, Task-003）
-
-━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
-📖 可用参数
-━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
-  -I, --iteration <name>    目标迭代（默认: 当前迭代）
-  -t, --task <id>           指定任务（如 Task-001）
-  -a, --all                 全部待执行任务
-  -f, --force               跳过确认直接执行
-  -r, --resume              断点续跑（从上次中断处继续）
-      --batch-size <n>      每批任务数（默认 3）
-      --verify              执行后自动运行测试验证
-      --agent <tool>        外部 AI 工具（copilot/claude/cursor/trae/qoder）
-      --ignore-upstream-update  跳过上游变更检测
-
-━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
-💡 使用示例
-━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
-  /execute -t Task-001                    # 执行单个任务
-  /execute --all                          # 执行全部待完成任务
-  /execute --all --force                  # 全部执行，跳过确认
-  /execute --resume                       # 断点续跑
-  /execute --all --batch-size 5           # 每批 5 个任务
-  /execute -t Task-001 --verify           # 执行后自动验证
-
-请补充参数后重新调用。
-```
-
----
-
-## Step 3: 前置校验
-
-### 3.1 检查任务是否存在
-```bash
-# 扫描 030-tasks/ 目录
-# 如果 Task 不存在 → 提示用户
-```
-
-### 3.2 检查任务状态
-```bash
-# 读取 Task/.meta/status
-# 如果状态为 done → 提示用户是否重新执行
-# 如果状态为 pending → 正常执行
-```
-
-### 3.3 上游变更检测
-```bash
-# 比较 020-specs/ 和 Task/00-specs/ 的 mtime
-# 如果有更新 → 提示用户建议重新拆分
-```
-
-### 3.4 读取代码模式
-```bash
-# 读取 .speccore/PATTERNS/ 中匹配的代码模式
-# 为 AI 提供参考代码片段
-```
-
----
-
-## Step 4: 调用 speccore ask
-
-```bash
-execute_command("speccore ask '执行 Task-XXX 的开发...'")
-```
-
-> ⚠️ 最终仍然调用 `speccore ask`，不要绕过 ask 引擎。
-
----
-
-## 📦 批次执行模式（防止上下文溢出）
-
-当执行多个任务时，使用批次模式避免 AI 上下文耗尽：
-
-### 步骤 1：获取任务清单
-```bash
-speccore execute --list-pending -i <迭代名> --batch-size 3
-```
-输出 JSON 格式的任务清单，包含批次分组信息。
-
-### 步骤 2：按批次执行
-对于每个批次中的任务：
-```bash
-# 1. 获取 Prompt
-speccore execute --prompt --task=<任务ID> -i <迭代名> --batch-size 3
-
-# 2. 根据 Prompt 生成代码
-
-# 3. 写入文件
-speccore execute --response '<代码JSON>' --task=<任务ID> -i <迭代名>
-```
-
-### 步骤 3：批次完成后自动续批
-当 Prompt 输出中包含 `[SPECCORE_CONTINUE: <path>]` 时：
-1. 当前对话的批次已完成
-2. **必须开始新的对话**
-3. 在新对话中，先读取 `<path>` 文件恢复上下文（约 1K tokens，包含已完成任务摘要、待执行任务、依赖关系）
-4. 然后执行提示的命令继续下一批次
-
-> 💡 "文件即记忆"机制：每个任务完成后，CLI 自动将进度、产出摘要、依赖关系写入摘要文件。
-> 新会话只需读取这个文件（~1K tokens）就能恢复全局视角，无需重新扫描全部文件。
-
-### 为什么需要批次执行？
-- 每个任务的 Prompt + AI 回复会累积在对话上下文中
-- 3-5 个任务后，上下文可能接近极限
-- 批次执行通过重置对话上下文，确保每个批次都有充足的上下文空间
+不要输出命令文本，不要分析意图，一切交给 speccore ask。

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

@@ -7,80 +7,6 @@ allowed-tools: ["Bash", "Read"]
 disable-model-invocation: false
 ---
 
-# spec-help — 帮助中心（专属逻辑）
-
-> **定位**：`/help` 快捷入口的专属预处理层
-> **原则**：不影响 `speccore ask` 的意图识别能力
-
----
-
-## 调用方式
-
-```
-/help
-/help --web
-```
-
----
-
-## 执行流程
-
-```
-用户输入 /help
-        │
-        ▼
-┌───────────────────────────────────────┐
-│ Step 1: 前置校验                        │
-│ 比较本地 CLI 版本与项目记录版本            │
-└───────────────────────────────────────┘
-        │
-   ┌────┴────┐
-   ▼         ▼
- 有新版本    最新版
-   │         │
-   ▼         ▼
-输出提示    调用 ask
-建议更新    执行 help
-```
-
----
-
-## 前置校验
-
-### 版本检测
-
-```bash
-# 获取本地安装的 CLI 版本
-localVer=$(speccore --version 2>/dev/null | grep -oE '[0-9]+\.[0-9]+\.[0-9]+' || echo "unknown")
-
-# 获取项目记录的版本（如果有）
-projectVer=$(cat .speccore/local/version.json 2>/dev/null | grep -oE '[0-9]+\.[0-9]+\.[0-9]+' || echo "none")
-
-echo "local: $localVer, project: $projectVer"
-```
-
-### 发现新版本时的提示
-
-```
-📦 版本更新提示
-
-本地 CLI:  v6.77.1
-项目记录:  v6.77.0
-
-发现新版本，建议更新：
-  npm install -g speccore@latest
-
-更新后运行 speccore init --update 同步项目配置。
-```
-
----
-
-## 执行
-
-直接调用 `speccore ask`：
-
-```
-直接执行: execute_command("speccore ask '显示命令帮助中心'")
+直接执行: execute_command("speccore ask '用户原话'")
 
 不要输出命令文本，不要分析意图，一切交给 speccore ask。
-```

package/.agents/skills/spec-iteration-create/SKILL.md

@@ -8,127 +8,6 @@ allowed-tools: ["Bash", "Read"]
 disable-model-invocation: false
 ---
 
-# spec-iteration-create — 创建迭代（专属逻辑）
+直接执行: execute_command("speccore ask '用户原话'")
 
-> **定位**：`/iteration-create` 快捷入口的专属预处理层
-> **原则**：不影响 `speccore ask` 的意图识别能力
-
----
-
-## 调用方式
-
-```
-/iteration-create [参数]
-/iteration-create -n Q2 --topic meeting-system --owner luzhaosheng
-```
-
----
-
-## 执行流程
-
-```
-用户输入 /iteration-create [参数]
-        │
-        ▼
-┌───────────────────────────────────────┐
-│ Step 1: 参数提取                        │
-│ 从用户输入提取 name/topic/owner 等      │
-└───────────────┬───────────────────────┘
-                │
-        参数缺失？
-                │
-        是 ──► 输出交互式提示
-                │
-        否 ──► 继续
-                │
-                ▼
-┌───────────────────────────────────────┐
-│ Step 2: 参数补全                        │
-│ topic 缺失 → AI 从中文名提取英文主题词     │
-│ owner 缺失 → 读 git config user.name     │
-└───────────────┬───────────────────────┘
-                │
-                ▼
-┌───────────────────────────────────────┐
-│ Step 3: 前置校验                        │
-│ - 迭代名是否已存在？                    │
-│ - 主题词是否有效？                      │
-└───────────────┬───────────────────────┘
-                │
-                ▼
-┌───────────────────────────────────────┐
-│ Step 4: 调用 speccore ask               │
-└───────────────────────────────────────┘
-```
-
----
-
-## Step 1: 参数提取
-
-| 参数 | 短名 | 长名 | 必填 | 说明 |
-|:---|:---|:---|:---|:---|
-| name | -n | --name | 是 | 迭代名称（如 Q1, V2.0, Sprint-3）|
-| topic | - | --topic | 否 | 英文主题词（用于目录命名）|
-| owner | -o | --owner | 否 | 迭代负责人 |
-| template | -t | --template | 否 | 模板名称（默认 standard）|
-
----
-
-## Step 2: 参数缺失 → 交互式提示
-
-```
-📁 speccore iteration-create — 创建迭代
-
-━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
-📖 可用参数
-━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
-  -n, --name <name>         迭代名称（必填）
-                            如: Q1, V2.0, Sprint-3, 会议系统
-      --topic <topic>       英文主题词（如 meeting-system, payment）
-                            用于生成目录名，缺失时 AI 自动提取
-  -o, --owner <name>        迭代负责人（默认: git config user.name）
-  -t, --template <name>     模板名称（默认: standard）
-
-━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
-💡 使用示例
-━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
-  /iteration-create -n Q1 --topic meeting-system    # 创建 Q1 迭代
-  /iteration-create -n "支付模块"                    # AI 自动提取主题词
-  /iteration-create -n V2.0 --owner luzhaosheng     # 指定负责人
-
-请补充 --name 参数后重新调用。
-```
-
----
-
-## Step 3: 前置校验
-
-### 3.1 检查迭代名是否已存在
-```bash
-# 检查 .speccore/ITERATIONS/ 或项目根目录下是否已有同名迭代
-# 如果已存在 → 提示用户是否覆盖或改名
-```
-
-### 3.2 提取英文主题词
-```bash
-# 如果用户未提供 --topic，从 --name 提取英文主题词
-# "会议系统" → "meeting-system"
-# "Q1" → "q1"
-# "支付模块" → "payment"
-```
-
-### 3.3 检查 owner
-```bash
-# 如果未提供 --owner，读取 git config user.name
-# 如果 git 未配置 → 提示用户提供
-```
-
----
-
-## Step 4: 调用 speccore ask
-
-```bash
-execute_command("speccore ask '创建 Iteration-XXX 迭代...'")
-```
-
-> ⚠️ 最终仍然调用 `speccore ask`，不要绕过 ask 引擎。
+不要输出命令文本，不要分析意图，一切交给 speccore ask。

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

@@ -9,121 +9,6 @@ allowed-tools: ["Bash", "Read"]
 disable-model-invocation: false
 ---
 
-# spec-plan — 执行计划（专属逻辑）
+直接执行: execute_command("speccore ask '用户原话'")
 
-> **定位**：`/plan` 快捷入口的专属预处理层
-> **原则**：不影响 `speccore ask` 的意图识别能力，只在调用 ask 之前做参数校验和上下文准备
-
----
-
-## 调用方式
-
-```
-/plan [参数]
-/plan -I Iteration-001 --task Task-001
-/plan -I Iteration-001 --all
-```
-
----
-
-## 执行流程
-
-```
-用户输入 /plan [参数]
-        │
-        ▼
-┌───────────────────────────────────────┐
-│ Step 1: 参数提取                        │
-│ 从用户输入提取 iteration/task/all 等     │
-└───────────────┬───────────────────────┘
-                │
-        参数缺失？
-                │
-        是 ──► 输出交互式提示
-                │
-        否 ──► 继续
-                │
-                ▼
-┌───────────────────────────────────────┐
-│ Step 2: 前置校验                        │
-│ - 任务是否已拆分？                      │
-│ - 依赖关系是否完整？                    │
-│ - 执行顺序是否合理？                    │
-└───────────────┬───────────────────────┘
-                │
-                ▼
-┌───────────────────────────────────────┐
-│ Step 3: 调用 speccore ask               │
-└───────────────────────────────────────┘
-```
-
----
-
-## Step 1: 参数提取
-
-| 参数 | 短名 | 长名 | 必填 | 说明 |
-|:---|:---|:---|:---|:---|
-| iteration | -i | --iteration | 否 | 目标迭代名 |
-| task | -t | --task | 否 | 指定任务（与 --all 互斥）|
-| all | -a | --all | 否 | 全部任务 |
-| batch-size | -b | --batch-size | 否 | 每批任务数（默认 3）|
-
----
-
-## Step 2: 参数缺失 → 交互式提示
-
-```
-📋 speccore plan — 执行计划
-
-━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
-📖 可用参数
-━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
-  -I, --iteration <name>    目标迭代（默认: 当前迭代）
-  -t, --task <id>           指定任务（如 Task-001）
-  -a, --all                 全部任务
-      --batch-size <n>      每批任务数（默认 3）
-
-━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
-💡 使用示例
-━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
-  /plan                                   # 计划当前迭代全部任务
-  /plan -I Q1                             # 计划指定迭代
-  /plan -t Task-001                       # 计划单个任务
-  /plan --all --batch-size 5              # 全部任务，每批 5 个
-
-请补充参数后重新调用，或直接调用 /plan 使用默认设置。
-```
-
----
-
-## Step 3: 前置校验
-
-### 3.1 检查任务是否已拆分
-```bash
-# 扫描 030-tasks/ 目录
-# 如果没有 Task 目录 → 提示用户先执行 split
-```
-
-### 3.2 检查依赖关系
-```bash
-# 读取各 Task 的 dependencies
-# 检测循环依赖
-# 检测缺失的依赖任务
-```
-
-### 3.3 执行顺序优化
-```bash
-# 拓扑排序
-# 高优先级任务排在前面
-# 基础模块优先
-```
-
----
-
-## Step 4: 调用 speccore ask
-
-```bash
-execute_command("speccore ask '生成 Iteration-XXX 的执行计划...'")
-```
-
-> ⚠️ 最终仍然调用 `speccore ask`，不要绕过 ask 引擎。
+不要输出命令文本，不要分析意图，一切交给 speccore ask。