speccore 5.43.1 → 5.51.0

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

@@ -1,3 +1,16 @@
+---
+name: spec-analyze
+description: >
+  AI 需求分析引擎。按任务类型(feature/bugfix/review/test/docs/refactor/deploy/security/performance)
+  自动生成对应分析报告。Use when user says "分析" "审查" "安全审计" "性能分析" "测试用例".
+allowed-tools: ["Bash", "Read", "Write", "Edit"]
+---
+## 🚫 禁止
+
+- 禁止在无 REQUIREMENT.md 时生成分析
+- 禁止跳过需求确认直接输出结论
+- 禁止不展示 [确认/修改/重新分析] 就写入文件
+
 # SpecCore Analyze — 需求分析器
 
 > **你负责**: 读取需求文档 → 你自己分析 → CLI 写入 ANALYSIS.md。你自己就是分析引擎。

package/.agents/skills/spec-analyze/references/analysis-report.md

@@ -0,0 +1,9 @@
+# 分析报告模板
+
+| 报告类型 | 文件名 | 核心内容 |
+| feature | ANALYSIS.md | API/数据模型/业务规则/风险 |
+| bugfix | ANALYSIS.md | 根因定位/影响范围/修复方案 |
+| review | REVIEW_PLAN.md | 审查范围/检查清单/关注点 |
+| test | TEST_PLAN.md | 测试用例/覆盖率目标/边界测试 |
+| security | SECURITY_AUDIT.md | OWASP 检查/漏洞/风险评级 |
+| performance | PERF_ANALYSIS.md | 瓶颈定位/优化建议/基准 |

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

@@ -1,3 +1,21 @@
+---
+name: spec-ask
+description: >
+  SpecCore 可执行编排引擎。处理意图识别 → CLI 执行 → AI 内容生成 → 写入。
+  Use when user says anything that doesn't match a specific skill route,
+  or complex multi-step requests involving "然后" "接着" "定时" "分批" "调度".
+  Always invoked via execute_command("speccore ask '...'").
+allowed-tools: ["Bash", "Read", "Write", "Edit"]
+disable-model-invocation: false
+---
+## 🚫 禁止
+
+- 禁止跳过 ask 引擎直接自行猜测意图
+- 禁止在 pipeline 未完成时跳到下一步
+- 禁止无用户确认时执行破坏性操作
+- 禁止输出 speccore 命令给用户
+- 禁止重复执行已完成的 SPECCORE_AUTO_RESULT
+
 # SpecCore Ask — 可执行编排引擎 v4
 
 > **你的身份**: 你就是宿主 AI。你的任务是：理解用户意图 → 调用 CLI --prompt → 自己生成内容 → 调 CLI --response 写入。  

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

@@ -1,3 +1,16 @@
+---
+name: spec-change
+description: >
+  需求变更管理。联动更新所有关联 Spec，支持口语化输入。
+  Use when user says "变更" "改需求" "修改" "change".
+allowed-tools: ["Bash", "Read", "Write", "Edit"]
+---
+## 🚫 禁止
+
+- 禁止不记录变更历史
+- 禁止变更后不联动更新关联 Spec
+- 禁止单次变更超过 3 个模块
+
 # SpecCore Change — 需求变更处理器
 
 > **你负责**: 记录变更 → 分析影响 → 重新生成受影响代码。

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

@@ -1,3 +1,17 @@
+---
+name: spec-dev
+description: >
+  智能进度推进器。检测迭代阶段 → 展示状态 → 等用户确认后执行下一步。
+  Use when user says "下一步" "流水线" "进度" "推进" "what's next".
+allowed-tools: ["Bash", "Read"]
+---
+## 🚫 禁止
+
+- 禁止在探索阶段写代码（只读）
+- 禁止不展示状态就直接执行下一步
+- 禁止跳过用户确认执行 analyze/execute
+- 禁止在没有 context.json 时推进
+
 # SpecCore Pipeline — 智能级联推进器
 
 > **你负责**: 检测迭代阶段 → 推荐并执行下一步 → 逐步推进项目。

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

@@ -1,3 +1,16 @@
+---
+name: spec-doc2spec
+description: >
+  文档导入。Word/Excel/CSV → Spec Markdown，支持图片提取和 Bug 列表解析。
+  Use when user says "导入文档" "Word" "Excel" "CSV" "Bug列表".
+allowed-tools: ["Bash", "Read", "Write", "Edit"]
+---
+## 🚫 禁止
+
+- 禁止在无 pandoc 时直接放弃（AI 上下文自动安装）
+- 禁止跳过图片提取步骤
+- 禁止对非文档文件执行转换
+
 # SpecCore doc2spec — AI + Pandoc 双路验证
 
 > **你负责**: Pandoc 机械转换 + 你自己交叉验证 = 零数据丢失。

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

@@ -1,3 +1,17 @@
+---
+name: spec-execute
+description: >
+  任务执行引擎。读取 ANALYSIS.md → Prompt/Apply 模式生成代码。
+  Use when user says "开发" "执行" "写代码" "实现" "跑任务".
+allowed-tools: ["Bash", "Read", "Write", "Edit"]
+---
+## 🚫 禁止
+
+- 禁止在无 ANALYSIS.md 时执行
+- 禁止跳过 plan 直接 execute --all
+- 禁止生成不完整代码（漏 import/漏 API/漏 DDL）
+- 禁止不先创建 feature 分支就改代码
+
 # SpecCore Execute — 代码生成执行器
 
 > **你负责**: 读取 Task Spec → 构建代码生成上下文 → 你自己生成代码 → CLI 写入文件。

package/.agents/skills/spec-execute/references/code-output.md

@@ -0,0 +1,13 @@
+# 代码生成输出格式
+
+## Prompt/Apply 协议
+1. CLI: `speccore execute --prompt -t Task-001` → exitCode=10
+2. AI 读取 ANALYSIS.md, REQUIREMENT.md
+3. AI 生成代码 JSON: `{"files": [{"path": "...","content": "..."}]}`
+4. 写入 /tmp/speccore-resp.json
+5. CLI: `cat /tmp/speccore-resp.json | speccore execute --response - -t Task-001`
+
+## 强制约束
+- 每个文件必须有 import 语句
+- API 必须完整（controller + service + model + DDL）
+- 逾 60s → 分批返回，先核心 API

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

@@ -1,3 +1,16 @@
+---
+name: spec-iteration-create
+description: >
+  迭代创建。AI 英文关键词命名 + 平台检查。
+  Use when user says "创建迭代" "新建迭代" "Sprint".
+allowed-tools: ["Bash", "Read", "Write", "Edit"]
+---
+## 🚫 禁止
+
+- 禁止直接用中文命名迭代（AI 翻译英文关键词）
+- 禁止重复创建同名迭代
+- 禁止不检查平台兼容性就创建
+
 # SpecCore Iteration Create — 交互式迭代创建（高阶 Skill）
 
 > **你负责**: 接收描述 → 智能命名 → 检查平台映射 → 创建迭代 → 推荐下一步。

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

@@ -1,3 +1,16 @@
+---
+name: spec-plan
+description: >
+  执行计划生成。根据任务列表生成多阶段计划(Mermaid 图+风险评估+里程碑)。
+  Use when user says "规划" "计划" "plan" "排程".
+allowed-tools: ["Bash", "Read", "Write", "Edit"]
+---
+## 🚫 禁止
+
+- 禁止在无 Task 时生成计划
+- 禁止计划中遗漏依赖关系
+- 禁止不写回滚方案
+
 # SpecCore Plan — 执行计划生成器
 
 > **你负责**: 读取 Task 列表 → 你自己排程 → CLI 写入 plan.json。

package/.agents/skills/spec-plan/references/plan-template.md

@@ -0,0 +1,24 @@
+# Plan Template — 迭代级执行计划
+
+## 使用方式
+speccore plan 生成 `Iteration-{name}/000-overview/PLAN-{ts}-{slug}.md`
+PLAN.md 始终为最新版本。
+
+## 计划文件标准结构（8 章）
+
+```markdown
+# 📋 Plan — {iteration}
+> 生成时间 | 状态 | 任务数 | 阶段数 | 预估
+
+## 1. Mermaid 依赖关系图
+## 2. Mermaid 执行甘特图
+## 3. 执行概览（表格）
+## 4. 任务详情
+## 5. 风险评估（高依赖/高优先级自动标红）
+## 6. 里程碑（Phase 验收标准）
+## 7. 回滚方案
+## 8. 执行记录（追加式）
+```
+
+## 任务级计划（可选）
+单个任务的详细执行计划放在: `Task-{id}-{name}/plan/PLAN.md`

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

@@ -1,3 +1,16 @@
+---
+name: spec-spec2doc
+description: >
+  文档导出。Spec Markdown → Word/PDF/HTML/PPTX。
+  Use when user says "导出" "生成文档" "生成报告" "导出Word" "导出PDF".
+allowed-tools: ["Bash", "Read", "Write", "Edit"]
+---
+## 🚫 禁止
+
+- 禁止在无 Spec 目录时执行导出
+- 禁止导出未完成分析的文档
+- 禁止跳过格式校验直接输出
+
 # SpecCore spec2doc — AI 排版 + Pandoc 导出
 
 > **你负责**: 审计 Spec 文档 → 你自己编排排版 → Pandoc 机械导出。

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

@@ -1,3 +1,16 @@
+---
+name: spec-split
+description: >
+  任务拆分。将需求 REQUIREMENT.md 拆分为独立开发任务。
+  Use when user says "拆分" "分解" "split" "拆任务".
+allowed-tools: ["Bash", "Read", "Write", "Edit"]
+---
+## 🚫 禁止
+
+- 禁止在无 REQUIREMENT.md 时拆分
+- 禁止拆分粒度过细（单个 Task < 1 文件）
+- 禁止拆分时不标注依赖关系
+
 # SpecCore Split — 任务拆分器
 
 > **你负责**: 读取分析结果 → 你自己拆分 → CLI 创建 Task 目录。

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

@@ -1,3 +1,17 @@
+---
+name: spec-task-create
+description: >
+  交互式任务创建。10 种类型选择器 + AI 智能命名 + 内容澄清。
+  Use when user says "创建任务" "新建任务" "bug任务" "测试任务" "审查任务" "文档任务".
+allowed-tools: ["Bash", "Read", "Write", "Edit"]
+---
+## 🚫 禁止
+
+- 禁止输出 speccore 命令给用户复制
+- 禁止未经用户确认就创建任务
+- 禁止跳过澄清环节直接生成（<80字内容必须追问）
+- 禁止任务创建后自动推进到 analyze
+
 # SpecCore Task Create — 交互式任务创建
 
 > **你负责**: 接收任意输入 → 内容澄清 → 智能命名 → 用 `execute_command` 创建任务 → 推荐下一步。

package/.agents/skills/spec-task-create/references/requirement-template.md

@@ -0,0 +1,23 @@
+# REQUIREMENT.md 模板
+
+```markdown
+# {Task-ID}: {任务名}
+
+| 属性 | 值 |
+| 编号 | {Task-ID} |
+| 类型 | feature/bugfix/review/test/docs/refactor/deploy/security/performance |
+| 优先级 | high/medium/low |
+| 迭代 | {iteration} |
+| 负责人 | {assignee} |
+
+## 描述
+{用户原始描述 + AI 补充}
+
+## 验收标准
+- [ ] {标准1}
+- [ ] {标准2}
+
+## 关联文件
+- ANALYSIS.md
+- PLAN.md (迭代级)
+```

package/.agents/skills/speccore-router/SKILL.md

@@ -1,3 +1,18 @@
+---
+name: speccore-router
+description: >
+  智能意图路由器。从自然语言识别意图 → 匹配 Skill → execute_command 执行。
+  核心原则：必须直接执行，决不输出命令文本。唯一下例外："只看不跑"。
+  Use when user input is ambiguous or doesn't match any specific Skill trigger.
+allowed-tools: ["Bash", "Read", "Write", "Edit"]
+---
+## 🚫 禁止
+
+- 禁止输出命令文本给用户复制粘贴
+- 禁止在 AI 上下文中问'是否执行以下命令'
+- 禁止不调用 execute_command 只展示 bash 语句
+- 唯一例外: 用户明确说'只看不跑'
+
 # SpecCore Router — 智能意图路由器
 
 > **定位**：从用户自然语言识别意图，提取参数，**用 execute_command 自动执行** CLI 命令。

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "speccore",
-  "version": "5.43.1",
+  "version": "5.51.0",
   "description": "SpecCore - Code by Spec, Not by Vibe.",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",