@siming-org/cli 0.4.0 → 0.5.0
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.
- package/dist/index.js +6573 -3731
- package/package.json +3 -3
- package/templates/project-skills/task-create.md +97 -0
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@siming-org/cli",
|
|
3
|
-
"version": "0.
|
|
3
|
+
"version": "0.5.0",
|
|
4
4
|
"license": "MIT",
|
|
5
5
|
"author": "Wuchao",
|
|
6
6
|
"engines": {
|
|
@@ -27,8 +27,8 @@
|
|
|
27
27
|
"picocolors": "^1.1.1",
|
|
28
28
|
"yaml": "^2.6.0",
|
|
29
29
|
"zod": "^4.4.3",
|
|
30
|
-
"@siming-org/core": "0.
|
|
31
|
-
"@siming-org/server": "0.
|
|
30
|
+
"@siming-org/core": "0.5.0",
|
|
31
|
+
"@siming-org/server": "0.5.0"
|
|
32
32
|
},
|
|
33
33
|
"devDependencies": {
|
|
34
34
|
"tsup": "^8.3.5",
|
|
@@ -0,0 +1,97 @@
|
|
|
1
|
+
---
|
|
2
|
+
name: task-create
|
|
3
|
+
description: 本项目任务创建入口：需求访谈 → 类型/轨道判定 → 模板与剪枝匹配 → 结构化写入 siming。（项目级待定制骨架——按下方定制清单逐项替换后方可正式使用）
|
|
4
|
+
version: 1.0.0
|
|
5
|
+
category: process
|
|
6
|
+
---
|
|
7
|
+
|
|
8
|
+
# 任务创建入口（项目级 · 待定制骨架）
|
|
9
|
+
|
|
10
|
+
> ⚠️ **定制状态标记**：本文件是 Siming 官方分发的待定制骨架。下方「定制清单」全部勾选并替换占位内容前，本入口不得用于真实任务创建（占位值无法匹配本项目真实模板）。
|
|
11
|
+
|
|
12
|
+
## 定制清单（逐项完成后删除本段标记）
|
|
13
|
+
|
|
14
|
+
- [ ] ① 替换「模板实况表」：按本项目实际组装的模板填写模板 code、适用任务类型与剪枝规则
|
|
15
|
+
- [ ] ② 替换「模块映射」：backend / ui 轨道对应的真实目录范围
|
|
16
|
+
- [ ] ③ 替换「项目标识」：project key、仓库地址、分支模型
|
|
17
|
+
- [ ] ④ 替换「快速通道规则」：按本项目流程约定确认或改写
|
|
18
|
+
- [ ] ⑤ 核对「依赖能力」清单：引用的 Skill / Agent 名称在本项目实例内已存在
|
|
19
|
+
|
|
20
|
+
## 职责
|
|
21
|
+
|
|
22
|
+
本 Skill 是本项目创建 Siming 开发任务的唯一入口：接收用户需求描述，通过访谈补齐关键信息，判定任务类型与轨道，匹配项目模板与剪枝方式，并以结构化调用创建任务。禁止在未走完本入口流程时凭猜测直接创建任务。
|
|
23
|
+
|
|
24
|
+
## 项目标识（占位——定制项 ③）
|
|
25
|
+
|
|
26
|
+
- **Project Key**：`<本项目 project key，如 acme>`
|
|
27
|
+
- **仓库地址**：`<本仓库远程地址>`
|
|
28
|
+
- **分支模型**：`<如：main（生产）→ dev（开发）→ feature/T{NNN}-{slug}；feature 基于 dev 创建，合并 --no-ff>`
|
|
29
|
+
|
|
30
|
+
## 依赖能力
|
|
31
|
+
|
|
32
|
+
- workflow-discipline（DAG 节点执行与暂停点纪律）
|
|
33
|
+
- 本项目模板列表：`siming_template { action: "list" }` 动态读取（模板可能随流程演进变化，禁止凭记忆硬编码）
|
|
34
|
+
|
|
35
|
+
## 执行流程
|
|
36
|
+
|
|
37
|
+
### 1. 需求访谈
|
|
38
|
+
|
|
39
|
+
从用户输入中提取：目标描述（What）、背景与动机（Why）、验收期望、明确不做的事项。信息不足时按「澄清规则」追问，每次只问一个需要用户决定的问题。
|
|
40
|
+
|
|
41
|
+
### 2. 任务类型判定
|
|
42
|
+
|
|
43
|
+
| 类型 | 判定特征 |
|
|
44
|
+
|---|---|
|
|
45
|
+
| feature | 新增能力 / 新功能 |
|
|
46
|
+
| bugfix | 缺陷修复（含测试修复；须先根因调查） |
|
|
47
|
+
| ui-tweak | 纯界面微调（不改行为契约） |
|
|
48
|
+
| research | 调研 / 选型 / 方案论证（产出调研报告） |
|
|
49
|
+
|
|
50
|
+
### 3. 轨道判定
|
|
51
|
+
|
|
52
|
+
| 轨道 | 判定特征 |
|
|
53
|
+
|---|---|
|
|
54
|
+
| backend | 改动落在后端代码范围（服务端 / CLI / 脚本 / 数据层） |
|
|
55
|
+
| ui | 改动仅落在前端 / UI 组件 |
|
|
56
|
+
| mixed | 同时涉及后端与前端（双链串行） |
|
|
57
|
+
| research | 调研类型专用轨道 |
|
|
58
|
+
|
|
59
|
+
### 4. 模板匹配与剪枝（占位——定制项 ①）
|
|
60
|
+
|
|
61
|
+
> 下表为骨架占位：**必须替换为本项目真实模板实况**（以 `siming_template { action: "list" }` 动态读取结果为准）。
|
|
62
|
+
|
|
63
|
+
| 任务类型 | 模板 code | 剪枝规则 |
|
|
64
|
+
|---|---|---|
|
|
65
|
+
| feature | `<本项目完整开发流模板 code>` | `<如：不剪枝 / 按 track 自动剪枝>` |
|
|
66
|
+
| bugfix | `<本项目快速修复模板 code>` | `<如：按 track 剪枝，跳过 X 节点>` |
|
|
67
|
+
| ui-tweak | `<本项目快速修复模板 code>` | `<占位>` |
|
|
68
|
+
| research | `<本项目调研模板 code>` | `<占位>` |
|
|
69
|
+
|
|
70
|
+
**快速通道规则（占位——定制项 ④）**：`<如：bugfix 类型允许跳过 PRD 节点（仅跳 PRD，不跳验收与归档）；除此之外不使用任何快速通道>`
|
|
71
|
+
|
|
72
|
+
### 5. 模块映射（占位——定制项 ②）
|
|
73
|
+
|
|
74
|
+
| 轨道 | 本项目目录范围 |
|
|
75
|
+
|---|---|
|
|
76
|
+
| backend | `<如：packages/core、packages/server、packages/cli、scripts>` |
|
|
77
|
+
| ui | `<如：packages/web>` |
|
|
78
|
+
|
|
79
|
+
### 6. 结构化写入
|
|
80
|
+
|
|
81
|
+
类型、轨道、模板、剪枝全部确定后，创建任务：
|
|
82
|
+
|
|
83
|
+
- **MCP 形态（AI 宿主内首选）**：`siming_task { action: "create", templateId: "<模板 code>", projectId: "<本项目 24-hex id>", taskTitle: "<标题>", track: "<轨道>", type: "<类型>", skipNodes: [<仅当模板匹配规则要求>] }`
|
|
84
|
+
- **CLI 形态**：`siming task create --title "<标题>" --template "<模板 code>" --track "<轨道>" --type "<类型>" --project "<project key>"`（剪枝用 `--skip <nodeIds>`）
|
|
85
|
+
- 模板引用一律用 **code 形态**并以 projectId 指定项目域（24-hex 数据库 id 兼容）；code 经 `siming_template { action: "list" }` 获取，不存在时错误信息含相近候选清单可当场纠正。
|
|
86
|
+
|
|
87
|
+
创建成功后，调用 `siming_task { action: "context", taskId }`（CLI：`siming task context <taskId>`）读取首节点完整资料包，按节点提示词开工。同会话内节点流转（advance/approve）响应已含下一节点资料包，免重读 context。
|
|
88
|
+
|
|
89
|
+
## 澄清规则
|
|
90
|
+
|
|
91
|
+
出现以下任一情况，停止创建并向用户澄清（每次只问一个问题）：
|
|
92
|
+
|
|
93
|
+
1. 需求描述不足以判定任务类型；
|
|
94
|
+
2. 类型与轨道冲突（如「调研型需求但要求改代码」）；
|
|
95
|
+
3. 模板列表中没有与类型匹配的模板（呈现 `siming_template list` 实际结果与缺口，不猜模板名）；
|
|
96
|
+
4. 用户要求剪枝模板中不存在的节点（skip 只允许来自本 Skill 模板实况表的映射关系）；
|
|
97
|
+
5. 需求明显超出本项目范围（呈现判断依据，建议新开项目/任务承载）。
|