speccore 5.27.33 → 5.30.2

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

@@ -0,0 +1,45 @@
+# SpecCore Analyze — 需求分析器
+
+> **你负责**: 读取需求文档 → 你自己分析 → CLI 写入 ANALYSIS.md。你自己就是分析引擎。
+
+## 核心规则
+1. 迭代不存在时列出可用迭代让用户选。
+2. 分析必须覆盖: API 完整性、数据模型、业务规则、技术映射、风险。
+3. 输出必须是 Markdown，≥200 字符。
+
+## 执行流程
+
+```
+1. execute_command("speccore analyze --prompt -I {iter}")
+
+   exitCode=10 → 你分析
+   exitCode=11 → 展示 NEEDS_INFO → 用户选迭代 → 重试
+
+2. 取 stdout [SPECCORE_PROMPT]...[/SPECCORE_PROMPT]
+   解析需求文档内容
+
+3. 你自己分析并生成 Markdown 报告:
+   ## 需求概述
+   ## API 接口清单（表格）
+   ## 数据模型
+   ## 业务规则
+   ## 技术映射
+   ## 风险与建议
+
+4. 自检: ≥200 字符，含 ≥2 个 ## 标题，含 API 表格
+   失败 → 重试 ≤2 次 → 降级
+
+5. 写入:
+   Write /tmp/analysis.md
+   execute_command("cat /tmp/analysis.md | speccore analyze --apply - -I {iter}")
+
+6. 展示: API 数 + 模型数 + 风险数 + 推荐下一步 (split)
+```
+
+## 退出码
+
+| exitCode | 行动 |
+| :--- | :--- |
+| 10 | 你分析并生成报告 |
+| 11 | 展示迭代列表 → 用户选 |
+| 其他 | [重试/跳过/停止] |

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

@@ -0,0 +1,152 @@
+# SpecCore Ask — 可执行编排引擎 v4
+
+> **你的身份**: 你就是宿主 AI。你的任务是：理解用户意图 → 调用 CLI --prompt → 自己生成内容 → 调 CLI --response 写入。
+> 你不是在"描述"流程，你就是在**执行**流程。不要调用外部 AI，你自己就是那个"AI 生成"环节的负责者。
+
+---
+
+## 核心规则
+
+1. 一次一个命令。不等用户确认不执行下一个。
+2. 每次执行完检查退出码，按速查表行事。
+3. 参数缺了让用户选，不猜。
+4. 你自己生成的内容必须校验格式。失败重试 ≤ 2 次。
+5. Pipeline 每步完成等用户确认。
+6. 执行完成展示摘要 + 推荐下一步。
+
+---
+
+## 步骤 0: 判断输入类型
+
+```
+判断标准（按顺序检查）:
+
+  IF 含 "?"/"吗"/"怎么"/"是什么"/"如何" AND 不是明确动作词（分析/执行/拆分/开发/导入）
+     → 分支 C (explain)
+  ELSE IF 含 "然后"/"再"/"接着"/"最后"/"全流程"/"从头"
+     → 分支 D (pipeline)  
+  ELSE IF 有意向性的动词（"帮我"/"做"/"跑"/"执行"）
+     → 步骤 1 (意图识别)
+  ELSE
+     → 分支 C (explain) — 默认解释/查询
+```
+
+---
+
+## 步骤 1: 意图识别
+
+```
+执行: speccore ask "{用户输入}"
+从 stdout 第一行提取 [SPECCORE_MODE: xxx] → 进对应分支
+若无标记 → 用步骤 0 标准判断
+```
+
+---
+
+## 分支 A: match — 单命令
+
+```
+A-FAIL: 低置信 → 请用户重新描述
+
+A1. 补参:
+    Read .speccore/local/context.json → 获取 currentIteration/currentTask
+    仍缺 → execute_command("speccore {cmd} --prompt {有参}")
+      exitCode=11 → 读 NEEDS_INFO 表格 → 用户选 → 重试
+
+A2. 确认（最多 3 轮追问）:
+    "📋 执行: speccore {cmd} --prompt {params} [是/改/停]"
+
+A3. 执行:
+    execute_command("speccore {cmd} --prompt {params}")
+    exitCode=0  → 步骤 4
+    exitCode=10 → A4
+    exitCode=11 → A1
+    其他        → [重试/跳过/停止]
+
+A4. 你生成 (60s):
+    取 stdout [SPECCORE_PROMPT]...[/SPECCORE_PROMPT]
+    你是 AI — 你自己生成代码/分析/文档
+
+A5. 自检:
+    execute: {"files":[...]}, 其他: Markdown >100 字符
+    失败 → 重试 ≤2 次 → 降级
+
+A6. 写入:
+    Write /tmp/speccore-resp.json
+    execute_command("cat /tmp/speccore-resp.json | speccore {cmd} --response - {params}")
+    注意: --response - 表示从 stdin 读取，已验证可用
+```
+
+---
+
+## 分支 B: ambiguous
+
+```
+展示候选人 → 用户选 → 分支 A
+```
+
+---
+
+## 分支 C: explain
+
+```
+直接回答。不调 CLI。
+```
+
+---
+
+## 分支 D: pipeline (≤5 步)
+
+```
+D1. 展示计划，等确认
+D2. 逐步执行（每步走 A3-A6）
+D3. 步间: Read 产出文件 → 提取参数 → 传下一步
+```
+
+---
+
+## 分支 E: guide
+
+```
+展示流程 → 用户选[开始]进 D 或 [仅查看]结束
+```
+
+---
+
+## 步骤 4: 总结
+
+```
+展示: 文件列表 + 警告 + 下一步推荐
+询问继续
+```
+
+---
+
+## 退出码
+
+| exitCode | 行动 |
+| :--- | :--- |
+| 0 | 展示结果 |
+| 10 | 你自己生成内容 → --apply |
+| 11 | 展示参数表 → 用户补 |
+| 其他 | [重试/跳过/停止] |
+
+---
+
+## 完整命令
+
+| 场景 | --prompt | --apply/response |
+| :--- | :--- | :--- |
+| 导入文档 | `doc2spec --prompt -f {f}` | `--response` |
+| 分析 | `analyze --prompt -I {i}` | `--apply` |
+| 拆分 | `iteration split --prompt -I {i}` | `--response` |
+| 计划 | `plan --prompt -I {i}` | `--response` |
+| 开发 | `execute --prompt -t {t}` | `--response` |
+| PR | `pr --prompt -t {t}` | `--response` |
+| 归档 | `done --prompt -t {t}` | `--response` |
+| 导出 | `spec2doc --prompt -I {i}` | `--apply` |
+| 仪表盘 | `dashboard` | — |
+| 验证 | `validate -I {i}` | — |
+| 回顾 | `retro --task {t}` | — |
+| 搜索 | `search {k}` | — |
+| 初始化 | `init` | — |

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

@@ -0,0 +1,21 @@
+# SpecCore Change — 需求变更处理器
+
+> **你负责**: 记录变更 → 分析影响 → 重新生成受影响代码。
+
+## 执行流程
+
+```
+1. 记录变更描述 + 关联 Task
+2. 分析影响: Read REQ.md → 列出受影响的 API/文件
+3. 展示: "⚠️ 影响: 2 个 API, 3 个文件。继续？[是/取消]"
+4. 执行: execute_command("speccore execute --prompt -t {task}")
+5. 你自己生成修正代码（走 spec-execute 流程）
+6. 写入: cat /tmp/resp.json | speccore execute --response - -t {task}
+```
+
+## 退出码
+
+| exitCode | 行动 |
+| :--- | :--- |
+| 10 | 你重新生成受影响的代码 |
+| 其他 | [重试/跳过/停止] |

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

@@ -0,0 +1,30 @@
+# SpecCore Pipeline — 智能级联推进器
+
+> **你负责**: 检测迭代阶段 → 推荐并执行下一步 → 逐步推进项目。
+
+## 执行流程
+
+```
+1. Read .speccore/local/context.json → 获取当前迭代
+   Read PROJECT_GRAPH.md → 获取 Task 进度
+
+2. 展示状态:
+   "📊 {iter} 进度: analyze ✅ → split ▶ → plan ⬜ → execute ⬜
+    下一步: speccore iteration split --prompt -I {iter}"
+
+3. 用户确认 → execute_command 执行下一步
+   走对应 Skill 的流程(analyze→spec-analyze, execute→spec-execute)
+
+4. 每步完成 → 回到步骤 1 → 重新检测 → 推荐最新下一步
+
+5. --auto 模式: 跳过确认，自动执行所有步骤
+   但每步仍需检查退出码，失败时暂停
+```
+
+## 退出码
+
+| exitCode | 行动 |
+| :--- | :--- |
+| 10 | 交给对应 Skill 处理 |
+| 11 | 展示参数列表 |
+| 其他 | [重试/跳过/停止] |

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

@@ -0,0 +1,35 @@
+# SpecCore doc2spec — AI + Pandoc 双路验证
+
+> **你负责**: Pandoc 机械转换 + 你自己交叉验证 = 零数据丢失。
+
+## 执行流程
+
+```
+1. execute_command("speccore doc2spec -f {file} --iter {iter} --no-ai")
+   先用 pandoc 做机械转换（快，但可能有乱码/断表/遗漏）
+
+2. Read 转换后的 REQUIREMENT.md
+   Read 原始文件 {file}
+
+3. execute_command("speccore doc2spec --prompt -f {file} --iter {iter}")
+   获取 AI 验证 prompt
+
+4. 你自己做交叉验证:
+   - 对比原始文档 vs pandoc 输出
+   - 检查: 乱码、标题断裂、表格损坏、图片缺失、内容丢失
+   - 生成修正后的 Markdown
+
+5. 写入:
+   Write /tmp/doc2spec-fixed.md
+   execute_command("cat /tmp/doc2spec-fixed.md | speccore doc2spec --response - -f {file} --iter {iter}")
+
+6. 展示: 发现N个问题已修复 + VALIDATION.md 报告 + 推荐下一步 (analyze)
+```
+
+## 退出码
+
+| exitCode | 行动 |
+| :--- | :--- |
+| 0 | pandoc 转换完成 → 你验证 |
+| 10 | 获取 prompt → 你交叉验证 |
+| 其他 | [重试/跳过] |

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

@@ -0,0 +1,55 @@
+# SpecCore Execute — 代码生成执行器
+
+> **你负责**: 读取 Task Spec → 构建代码生成上下文 → 你自己生成代码 → CLI 写入文件。
+> **你不需要调用外部 AI**，你自己就是代码生成者。
+
+## 核心规则
+1. 一次只执行一个 Task。不等确认不执行下一个。
+2. Task 不存在时展示可用列表让用户选。
+3. 生成的代码必须匹配 CONSTITUTION 技术栈。
+4. 每个文件生成完做基本语法检查（括号匹配、import 完整）。
+
+## 执行流程
+
+```
+用户: "开发 Task-001"
+
+1. execute_command("speccore execute --prompt -t Task-001")
+
+   检查退出码:
+   exitCode=10 → 你生成代码
+   exitCode=11 → 展示 NEEDS_INFO 表格 → 用户选 Task → 重试
+   其他        → [重试/跳过/停止]
+
+2. 取 stdout [SPECCORE_PROMPT]...[/SPECCORE_PROMPT]
+   解析: API 定义、数据模型、技术栈、业务规则
+
+3. 你自己生成代码:
+   格式: {"files": [{"path": "相对路径", "content": "代码"}]}
+   生成 ALL API 接口 + ALL 数据模型 DDL + import 语句
+   逾 60s → 分 N 批，先返回核心 API
+
+4. 自检: files 数组非空，path 含扩展名，content > 10 字符
+   失败 → 重试 ≤2 次 → 降级: 原始 text 写入 README.md
+
+5. 写入:
+   Write /tmp/speccore-exec.json
+   execute_command("cat /tmp/speccore-exec.json | speccore execute --response - -t Task-001")
+
+6. 展示: 写入文件数 + 文件清单 + 推荐下一步 (pr)
+```
+
+## 退出码
+
+| exitCode | 行动 |
+| :--- | :--- |
+| 10 | 你生成代码 |
+| 11 | 展示 Task 列表 → 用户选 |
+| 其他 | [重试/跳过/停止] |
+
+## 批量执行
+
+```
+--all 模式: 列出所有 pending Task → 用户选 → 逐个执行
+每完成一个展示进度: "✅ 2/5 Task-002 完成，继续？"
+```

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

@@ -0,0 +1,32 @@
+# SpecCore Plan — 执行计划生成器
+
+> **你负责**: 读取 Task 列表 → 你自己排程 → CLI 写入 plan.json。
+
+## 执行流程
+
+```
+1. execute_command("speccore plan --prompt -I {iter}")
+   exitCode=10 → 你排程
+   exitCode=11 → 展示迭代 → 用户选
+
+2. 取 stdout [SPECCORE_PROMPT]...[/SPECCORE_PROMPT]
+   解析 Task 列表和依赖关系
+
+3. 你排程: 拓扑排序 + 并行分组 + 工作量估算
+   返回 JSON: {"batches":[{"tasks":["Task-001"],"assignee":"张三","days":2}]}
+
+4. 自检: 含 batches 数组, 每个 task 有 assignee 和 days
+   失败 → 重试 ≤2 次
+
+5. 写入: Write /tmp/plan.json
+   execute_command("cat /tmp/plan.json | speccore plan --response - -I {iter}")
+
+6. 展示: 批次数 + 总人天 + 推荐 (execute)
+```
+
+## 退出码
+| exitCode | 行动 |
+| :--- | :--- |
+| 10 | 你排程 |
+| 11 | 展示迭代列表 |
+| 其他 | [重试/跳过/停止] |

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

@@ -0,0 +1,35 @@
+# SpecCore spec2doc — AI 排版 + Pandoc 导出
+
+> **你负责**: 审计 Spec 文档 → 你自己编排排版 → Pandoc 机械导出。
+
+## 执行流程
+
+```
+1. execute_command("speccore spec2doc --prompt -i {iter} -o {file}")
+   获取文档审计 prompt
+   exitCode=10 → 你审计
+
+2. 你自己做内容审计:
+   - 检查: TODO/TBD 残留、API 定义完整、交叉引用有效
+   - 生成审计报告: 通过/警告/建议
+
+3. 生成编排版 Markdown:
+   - 封面 + 目录 + 章节重排 + Mermaid 标注
+   Write /tmp/spec2doc-merged.md
+
+4. 导出:
+   execute_command("pandoc /tmp/spec2doc-merged.md -f gfm -t {format} -o {output}")
+
+5. 后处理:
+   execute_command("speccore spec2doc --apply '{audit_report}' -o {file}")
+
+6. 展示: 页数 + 章节 + 图片 + 推荐
+```
+
+## 退出码
+
+| exitCode | 行动 |
+| :--- | :--- |
+| 10 | 你审计 + 编排 |
+| 0 | pandoc 完成 → 你验证 |
+| 其他 | [重试/跳过] |

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

@@ -0,0 +1,42 @@
+# SpecCore Split — 任务拆分器
+
+> **你负责**: 读取分析结果 → 你自己拆分 → CLI 创建 Task 目录。
+
+## 核心规则
+1. 按端（app/h5/miniapp/admin）和 API 数（3-8 个/Task）拆分。
+2. 计算依赖关系：数据模型 Task 前置，认证 Task 前置。
+3. 返回 JSON Task 列表。
+
+## 执行流程
+
+```
+1. execute_command("speccore iteration split --prompt -I {iter}")
+   exitCode=10 → 你拆分
+   exitCode=11 → 展示 NEEDS_INFO → 用户选迭代 → 重试
+
+2. 取 stdout [SPECCORE_PROMPT]...[/SPECCORE_PROMPT]
+   解析 ANALYSIS.md 内容
+
+3. 你自己拆分，返回 JSON:
+   [
+     {"id":"Task-001","name":"数据模型","req":"...","tech":"...","depends":[]},
+     {"id":"Task-002","name":"app 认证","req":"...","tech":"...","depends":["Task-001"]}
+   ]
+
+4. 自检: JSON 数组，每个 item 含 id/name/req
+   失败 → 重试 ≤2 次 → 降级: Markdown 表格写入 REQUIREMENT.md
+
+5. 写入:
+   Write /tmp/split.json
+   execute_command("cat /tmp/split.json | speccore iteration split --response - -I {iter}")
+
+6. 展示: Task 数量 + 依赖关系 + 推荐下一步 (plan)
+```
+
+## 退出码
+
+| exitCode | 行动 |
+| :--- | :--- |
+| 10 | 你拆分任务 |
+| 11 | 展示迭代列表 → 用户选 |
+| 其他 | [重试/跳过/停止] |