speccore 5.67.53 → 5.67.55
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.
|
@@ -2,66 +2,78 @@
|
|
|
2
2
|
name: spec-ask
|
|
3
3
|
description: >
|
|
4
4
|
SpecCore 意图引擎 — 宿主 AI 语义分析入口。
|
|
5
|
-
所有用户操作走此 Skill
|
|
6
|
-
Always invoked via execute_command("speccore ask '用户原话'").
|
|
5
|
+
所有用户操作走此 Skill。
|
|
7
6
|
allowed-tools: ["Bash", "Read", "Write", "Edit"]
|
|
8
7
|
disable-model-invocation: false
|
|
9
8
|
---
|
|
10
9
|
|
|
11
10
|
# SpecCore Ask — AI 语义分析引擎
|
|
12
11
|
|
|
13
|
-
##
|
|
12
|
+
## 🚨 核心铁律
|
|
14
13
|
|
|
15
|
-
1.
|
|
16
|
-
2.
|
|
17
|
-
|
|
18
|
-
|
|
14
|
+
1. **每步必确认** — 用户没明确说"自动/全自动/一键"的，每步展示计划→等确认→再执行
|
|
15
|
+
2. **自动模式分两级**:
|
|
16
|
+
- **部分自动**: "analyze 和 plan 自动执行，execute 前确认" → 只跳过确认的步骤
|
|
17
|
+
- **全自动**: "全自动执行/一键完成" → 所有步骤不等确认，全部自动跑
|
|
18
|
+
3. **迭代/任务命名必加 --topic** — 从用户原话提取英文主题词
|
|
19
|
+
4. **禁止 schedule** — 用户说"定时"时告知不可用、改为立即执行
|
|
20
|
+
5. **-i 参数用短名** — 传 `meeting-system` 而非 `Iteration-009-meeting-system`
|
|
21
|
+
6. **分析前先读源码** — 生成分析内容前必须 Read 相关源文件
|
|
19
22
|
|
|
20
23
|
## 执行流程
|
|
21
24
|
|
|
22
25
|
```
|
|
23
26
|
1. execute_command("speccore ask '用户原话'")
|
|
24
|
-
→
|
|
27
|
+
→ 读 KB 输出，了解可用命令
|
|
25
28
|
|
|
26
|
-
2.
|
|
27
|
-
|
|
28
|
-
|
|
29
|
-
|
|
30
|
-
|
|
29
|
+
2. 检查上下文，识别自动模式:
|
|
30
|
+
- "全自动/一键/全流程自动" → FULL_AUTO 全流程
|
|
31
|
+
- "analyze和plan自动，execute前确认" → PARTIAL_AUTO(1-2)
|
|
32
|
+
- "自动执行到split，plan和execute前确认" → PARTIAL_AUTO(1-2)
|
|
33
|
+
- 没说自动 → 每步确认
|
|
31
34
|
|
|
32
|
-
3.
|
|
33
|
-
|
|
34
|
-
|
|
35
|
-
|
|
36
|
-
|
|
37
|
-
|
|
35
|
+
3. 理解意图 → 拼计划 → 展示:
|
|
36
|
+
"""
|
|
37
|
+
[自动模式] 将自动执行 step 1-2 (analyze+plan)，step 3 (execute) 前暂停确认。
|
|
38
|
+
[全程确认] 每步展示结果再继续。
|
|
39
|
+
|
|
40
|
+
step 1: speccore analyze --prompt -I meeting-system --task user-login
|
|
41
|
+
step 2: speccore plan --prompt -I meeting-system --task user-login
|
|
42
|
+
step 3: speccore execute --prompt -I meeting-system --task user-login
|
|
38
43
|
|
|
39
44
|
是否确认？
|
|
40
|
-
|
|
45
|
+
"""
|
|
41
46
|
|
|
42
|
-
4.
|
|
43
|
-
|
|
44
|
-
|
|
45
|
-
|
|
46
|
-
step 2: execute_command("speccore plan --prompt -I Q1 --task 001")
|
|
47
|
-
(同上)
|
|
48
|
-
step 3: execute_command("speccore schedule create -I Q1 --task 001 --at ...")
|
|
47
|
+
4. 用户确认后按模式执行:
|
|
48
|
+
- PARTIAL_AUTO: step 1→2 连续执行，step 3 前暂停问"继续？"
|
|
49
|
+
- FULL_AUTO: 全部连续执行
|
|
50
|
+
- 手动: 每步暂停确认
|
|
49
51
|
```
|
|
50
52
|
|
|
51
|
-
##
|
|
53
|
+
## 关键命令
|
|
54
|
+
|
|
55
|
+
| 命令 | 格式 | 需要 AI |
|
|
56
|
+
|:---|:---|:---:|
|
|
57
|
+
| `analyze --prompt -I <短名> --task <短名>` | 分析任务 | ✅ |
|
|
58
|
+
| `plan --prompt -I <短名> --task <短名>` | 制定计划 | ✅ |
|
|
59
|
+
| `execute --prompt -I <短名> --task <短名>` | 执行开发 | ✅ |
|
|
60
|
+
| `context --set --iteration <完整名>` | 切换迭代 | ❌ |
|
|
61
|
+
| `dashboard` | 查看进度 | ❌ |
|
|
62
|
+
| `iteration split -i <短名>` | 拆分任务 | ✅ |
|
|
63
|
+
| `task new -n <名> --topic <英文> -i <短名>` | 创建任务 | ❌ |
|
|
64
|
+
|
|
65
|
+
## AI 分析质量要求
|
|
52
66
|
|
|
53
|
-
|
|
54
|
-
|
|
55
|
-
|
|
56
|
-
|
|
57
|
-
|
|
58
|
-
| `schedule create -I <iter> --task <id> --at "HH:MM"` | 创建定时调度 | ❌ |
|
|
59
|
-
| `context --set --iteration <name>` | 切换迭代上下文 | ❌ |
|
|
60
|
-
| `dashboard` | 查看进度面板 | ❌ |
|
|
67
|
+
执行 analyze --prompt 后:
|
|
68
|
+
1. **Read 迭代目录下所有源码文件**（REQUIREMENT.md、010-requirements/sources/ 下的文档）
|
|
69
|
+
2. **生成分析必须包含**: 功能点列表、接口清单、数据模型、业务规则、异常处理
|
|
70
|
+
3. **不要生成空洞模板** — 每个字段都要有具体内容
|
|
71
|
+
4. 分析写入 `020-specs/ANALYSIS.md`
|
|
61
72
|
|
|
62
|
-
##
|
|
73
|
+
## 禁止行为
|
|
63
74
|
|
|
64
|
-
-
|
|
65
|
-
-
|
|
66
|
-
-
|
|
67
|
-
-
|
|
75
|
+
- ❌ 用户没说自动就全自动跑
|
|
76
|
+
- ❌ schedule 命令（任何形式）
|
|
77
|
+
- ❌ 传完整迭代名到 -i 参数
|
|
78
|
+
- ❌ 分析时不读源码凭空生成
|
|
79
|
+
- ❌ 不展示计划直接执行
|
|
@@ -70,8 +70,8 @@ allowed-tools: ["Bash", "Read", "Write", "Edit"]
|
|
|
70
70
|
### 迭代管理
|
|
71
71
|
| 用户说法 | 提取参数 | CLI 命令 |
|
|
72
72
|
| :--- | :--- | :--- |
|
|
73
|
-
| 创建迭代/新建迭代 {name} | name, owner? | `speccore iteration create -n {name} --owner {owner}` |
|
|
74
|
-
| 创建 Sprint {n} | name, owner? | `speccore iteration create -n "Sprint-{n}" --owner {owner}` |
|
|
73
|
+
| 创建迭代/新建迭代 {name} | name, topic**, owner? | `speccore iteration create -n {name} --topic {topic} --owner {owner}` |
|
|
74
|
+
| 创建 Sprint {n} | name, topic**, owner? | `speccore iteration create -n "Sprint-{n}" --topic {topic} --owner {owner}` |
|
|
75
75
|
| 查看迭代列表 | - | `speccore iteration list` |
|
|
76
76
|
| 切换到迭代 {name} | name | `speccore context --set --iteration {name}` |
|
|
77
77
|
| 重命名迭代 {old} → {new} | old, new | `speccore rename --iteration {old} {new}` |
|
|
@@ -255,7 +255,7 @@ allowed-tools: ["Bash", "Read", "Write", "Edit"]
|
|
|
255
255
|
### 定时/批量意图
|
|
256
256
|
```
|
|
257
257
|
"每天晚上8点检查所有迭代的进度"
|
|
258
|
-
→ speccore ask "
|
|
258
|
+
→ 告知用户定时调度暂不支持，改为立即执行：speccore ask "检查所有迭代进度"
|
|
259
259
|
```
|
|
260
260
|
|
|
261
261
|
### 条件意图
|