speccore 5.67.53 → 5.67.54
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,65 @@
|
|
|
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
|
-
3.
|
|
18
|
-
4.
|
|
14
|
+
1. **每步必确认** — 用户没明确说"自动/全自动/一键"的,每步展示计划→等确认→再执行
|
|
15
|
+
2. **迭代/任务命名必加 --topic** — 从用户原话提取英文主题词,不要传中文或空
|
|
16
|
+
3. **禁止 schedule** — schedule 命令已废弃,用户说"定时"时直接告知不可用、改为立即执行
|
|
17
|
+
4. **-i 参数用短名** — 传 `meeting-system` 而非 `Iteration-009-meeting-system`
|
|
18
|
+
5. **分析前先读源码** — 生成分析内容前必须 Read 相关源文件,不要凭空写
|
|
19
19
|
|
|
20
20
|
## 执行流程
|
|
21
21
|
|
|
22
22
|
```
|
|
23
23
|
1. execute_command("speccore ask '用户原话'")
|
|
24
|
-
→
|
|
24
|
+
→ 读 KB 输出,了解可用命令
|
|
25
25
|
|
|
26
|
-
2.
|
|
27
|
-
示例: "分析Q1任务001,列计划,17:30执行" →
|
|
28
|
-
step 1: speccore analyze --prompt -I Q1 --task 001
|
|
29
|
-
step 2: speccore plan --prompt -I Q1 --task 001
|
|
30
|
-
step 3: speccore schedule create -I Q1 --task 001 --at "17:30"
|
|
26
|
+
2. 检查上下文(context.json),确认当前迭代
|
|
31
27
|
|
|
32
|
-
3.
|
|
33
|
-
|
|
28
|
+
3. 理解意图 → 拼计划 → 展示给用户:
|
|
29
|
+
"""
|
|
34
30
|
我理解你要:
|
|
35
|
-
1. 分析 Q1 的任务
|
|
36
|
-
2. 为任务
|
|
37
|
-
3. 定时 17:30 执行
|
|
31
|
+
1. 分析 Q1 的任务 user-login(将读取源码后生成分析报告)
|
|
32
|
+
2. 为任务 user-login 制定开发计划
|
|
38
33
|
|
|
39
34
|
是否确认?
|
|
40
|
-
|
|
35
|
+
"""
|
|
41
36
|
|
|
42
|
-
4.
|
|
43
|
-
step 1: execute_command("speccore analyze --prompt -I Q1 --task 001")
|
|
44
|
-
exitCode=10 → 读 SPECCORE_PROMPT → 你生成分析内容 → write back
|
|
45
|
-
exitCode=0 → 继续
|
|
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 ...")
|
|
37
|
+
4. 用户确认后逐步执行,每步检查结果
|
|
49
38
|
```
|
|
50
39
|
|
|
51
|
-
##
|
|
40
|
+
## 关键命令
|
|
52
41
|
|
|
53
|
-
| 命令 |
|
|
54
|
-
|
|
55
|
-
| `analyze --prompt -I
|
|
56
|
-
| `plan --prompt -I
|
|
57
|
-
| `execute --prompt -I
|
|
58
|
-
| `
|
|
59
|
-
| `
|
|
60
|
-
| `
|
|
42
|
+
| 命令 | 格式 | 需要 AI |
|
|
43
|
+
|:---|:---|:---:|
|
|
44
|
+
| `analyze --prompt -I <短名> --task <短名>` | 分析任务 | ✅ |
|
|
45
|
+
| `plan --prompt -I <短名> --task <短名>` | 制定计划 | ✅ |
|
|
46
|
+
| `execute --prompt -I <短名> --task <短名>` | 执行开发 | ✅ |
|
|
47
|
+
| `context --set --iteration <完整名>` | 切换迭代 | ❌ |
|
|
48
|
+
| `dashboard` | 查看进度 | ❌ |
|
|
49
|
+
| `iteration split -i <短名>` | 拆分任务 | ✅ |
|
|
50
|
+
| `task new -n <名> --topic <英文> -i <短名>` | 创建任务 | ❌ |
|
|
61
51
|
|
|
62
|
-
##
|
|
52
|
+
## AI 分析质量要求
|
|
63
53
|
|
|
64
|
-
|
|
65
|
-
|
|
66
|
-
|
|
67
|
-
|
|
54
|
+
执行 analyze --prompt 后:
|
|
55
|
+
1. **Read 迭代目录下所有源码文件**(REQUIREMENT.md、010-requirements/sources/ 下的文档)
|
|
56
|
+
2. **生成分析必须包含**: 功能点列表、接口清单、数据模型、业务规则、异常处理
|
|
57
|
+
3. **不要生成空洞模板** — 每个字段都要有具体内容
|
|
58
|
+
4. 分析写入 `020-specs/ANALYSIS.md`
|
|
59
|
+
|
|
60
|
+
## 禁止行为
|
|
61
|
+
|
|
62
|
+
- ❌ 用户没说自动就全自动跑
|
|
63
|
+
- ❌ schedule 命令(任何形式)
|
|
64
|
+
- ❌ 传完整迭代名到 -i 参数
|
|
65
|
+
- ❌ 分析时不读源码凭空生成
|
|
66
|
+
- ❌ 不展示计划直接执行
|
|
@@ -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
|
### 条件意图
|