speccore 8.3.29 → 8.3.30

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
@@ -1,9 +1,11 @@
1
1
  ---
2
2
  name: spec-analyze
3
3
  description: >
4
- 需求分析专属 Skill。在调用 speccore ask 之前,执行参数提取、
5
- 前置校验(迭代存在性、需求文档检测、专业度评估、端列表读取),
6
- 参数缺失时输出交互式提示。不影响 speccore ask 的意图识别能力。
4
+ SpecCore 需求分析专属 Skill。仅在用户明确提到 speccore、迭代、期次、Spec、
5
+ /analyze 等关键词,或明确要求通过 speccore 执行 analyze 操作时使用。
6
+ 在调用 speccore ask 之前,执行参数提取、前置校验(迭代存在性、需求文档检测、
7
+ 专业度评估、端列表读取),参数缺失时输出交互式提示。
8
+ 不处理一般性的"分析需求"讨论(如"帮我分析一下登录功能"),只处理 speccore 上下文中的分析。
7
9
  allowed-tools: ["Bash", "Read"]
8
10
  disable-model-invocation: false
9
11
  ---
@@ -1,10 +1,11 @@
1
1
  ---
2
2
  name: spec-split
3
3
  description: >
4
- 任务拆分专属 Skill。在调用 speccore ask 之前,执行参数提取、
5
- 前置校验(analyze 是否完成、端列表提取、变更检测),
6
- 参数缺失时输出交互式提示(参数说明 + 使用示例)。
7
- 不影响 speccore ask 的意图识别能力。
4
+ SpecCore 任务拆分专属 Skill。仅在用户明确提到 speccore、迭代、期次、Spec、
5
+ /split 等关键词,或明确要求通过 speccore 执行 split 操作时使用。
6
+ 在调用 speccore ask 之前,执行参数提取、前置校验(analyze 是否完成、端列表提取、
7
+ 变更检测),参数缺失时输出交互式提示(参数说明 + 使用示例)。
8
+ 不处理一般性的"拆分任务"讨论(如"帮我拆分一下工作"),只处理 speccore 上下文中的拆分。
8
9
  allowed-tools: ["Bash", "Read"]
9
10
  disable-model-invocation: false
10
11
  ---
@@ -1,15 +1,18 @@
1
1
  ---
2
2
  name: speccore-router
3
3
  description: >
4
- SpecCore CLI 命令路由器。仅在用户明确要求通过 speccore 命令行工具执行操作,
5
- 且意图涉及以下概念时使用:迭代管理、需求文档导入(doc2spec)、
6
- Spec 分析生成(analyze --prompt)、任务拆分(split)、执行计划(plan --prompt)、
7
- 代码执行(execute --prompt)、任务归档(done)、PR 提交(pr)、
8
- 状态查看(status/dashboard/doctor)、智能级联(dev)。
4
+ SpecCore CLI 命令路由器。仅在用户明确提到 speccore、迭代、期次、Spec 等关键词,
5
+ 或明确要求通过 speccore 命令行工具执行操作,且意图涉及以下概念时使用:
6
+ 迭代管理、需求文档导入(doc2spec)、Spec 分析生成(analyze --prompt)、
7
+ 任务拆分(split)、执行计划(plan --prompt)、代码执行(execute --prompt)、
8
+ 任务归档(done)、PR 提交(pr)、状态查看(status/dashboard/doctor)、智能级联(dev)。
9
9
  将用户意图映射为 speccore CLI 命令,通过 execute_command 执行。
10
10
  核心原则:必须直接执行,决不输出命令文本。唯一下例外:"只看不跑"。
11
11
  以下情况明确不处理:解释代码逻辑、审查代码片段、讨论需求合理性、
12
12
  排查具体 bug、一般性技术咨询、算法实现、架构讨论。
13
+ 模糊意图拦截:如果用户没有明确提到 speccore/迭代/期次/Spec 等关键词,
14
+ 只说"分析需求"、"拆分任务"、"做需求分析"等泛泛说法,必须先追问确认:
15
+ "你是指用 speccore 分析迭代需求,还是一般性地讨论需求?",不可直接执行。
13
16
  allowed-tools: ["Bash", "Read", "Write", "Edit"]
14
17
  ---
15
18
 
@@ -61,6 +64,14 @@ allowed-tools: ["Bash", "Read", "Write", "Edit"]
61
64
 
62
65
 
63
66
  ┌───────────────────────────────────────┐
67
+ │ 0. 上下文检测(新增) │
68
+ │ 用户是否提到 speccore/迭代/期次/Spec?│
69
+ │ 是 → 继续意图识别 │
70
+ │ 否 → 进入模糊意图拦截 │
71
+ └───────────────┬───────────────────────┘
72
+
73
+
74
+ ┌───────────────────────────────────────┐
64
75
  │ 1. 意图识别 │
65
76
  │ 关键词匹配 + 上下文推断 + 参数提取 │
66
77
  └───────────────┬───────────────────────┘
@@ -86,6 +97,42 @@ allowed-tools: ["Bash", "Read", "Write", "Edit"]
86
97
  执行失败 → 错误处理
87
98
  ```
88
99
 
100
+ ## ⛔ 模糊意图拦截规则
101
+
102
+ 在匹配映射表之前,先判断当前是否有 speccore 上下文,再决定是否拦截:
103
+
104
+ ### 1. 有 speccore 上下文(放行)
105
+
106
+ 如果当前对话中用户**之前已经明确使用过 speccore**(如执行过 analyze/split/execute 等命令,或提到过迭代/期次/Task 等),则视为有上下文:
107
+ - ✅ 模糊意图(如"分析需求"、"拆分任务")**直接按 speccore 处理**,无需重复确认
108
+ - 除非用户明确说"这次不用 speccore"、"不用 speccore 分析"、"正常讨论就行"等,才按正常 AI 对话处理
109
+
110
+ ### 2. 无 speccore 上下文(必须确认)
111
+
112
+ 新会话或用户从未提到过 speccore 相关概念时,检查用户输入是否包含以下关键词:
113
+
114
+ **直接放行(满足任一)**:
115
+ - `speccore`、`SpecCore`、`spec-core`
116
+ - `迭代`、`期次`、`Iteration-`、`Sprint-`
117
+ - `Task-`、`任务号`
118
+ - `010-requirements`、`020-specs`、`030-tasks`
119
+ - `.speccore/` 目录相关操作
120
+ - `/analyze`、`/split`、`/execute` 等快捷命令
121
+
122
+ **必须追问确认(无上述关键词)**:
123
+ | 用户说法 | 处理方式 |
124
+ | :--- | :--- |
125
+ | "分析需求" | ❌ 不直接执行。追问:"你是指用 speccore 分析迭代需求,还是一般性地讨论需求?" |
126
+ | "拆分任务" | ❌ 不直接执行。追问:"你是指用 speccore 拆分迭代任务,还是一般性地拆解工作?" |
127
+ | "做需求分析" | ❌ 不直接执行。追问确认 |
128
+ | "评审需求" | ❌ 不直接执行。追问确认 |
129
+ | "加个登录功能" | ❌ 不直接执行。追问:"你是指用 speccore 创建迭代任务,还是一般性地讨论功能?" |
130
+
131
+ **追问后的分支处理**:
132
+ - 用户回答"用 speccore" / "走 speccore" / "迭代分析" → ✅ 进入 speccore 流程
133
+ - 用户回答"不用" / "正常讨论" / "不是" / "一般性讨论" → ❌ 不走 speccore,按正常 AI 对话处理
134
+ - 用户回答含糊 → 再次确认,不猜测意图
135
+
89
136
  ---
90
137
 
91
138
  ## 完整意图映射表
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "speccore",
3
- "version": "8.3.29",
3
+ "version": "8.3.30",
4
4
  "description": "SpecCore - Code by Spec, Not by Vibe.",
5
5
  "main": "dist/index.js",
6
6
  "types": "dist/index.d.ts",