@mickorz/opencode-agentic-workflow 0.6.2 → 0.6.3
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/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@mickorz/opencode-agentic-workflow",
|
|
3
|
-
"version": "0.6.
|
|
3
|
+
"version": "0.6.3",
|
|
4
4
|
"description": "Durable Agentic Workflow Runtime for OpenCode V2: journal & resume, version registry, tracing, token/cost metrics, git worktree isolation",
|
|
5
5
|
"type": "module",
|
|
6
6
|
"license": "MIT",
|
|
@@ -10,7 +10,21 @@ description: >
|
|
|
10
10
|
# workflow-authoring（代码流程编写）
|
|
11
11
|
|
|
12
12
|
把用户的流程需求变成可复用的代码 workflow：**对话澄清 → 写 flows 目录
|
|
13
|
-
JS 模块 → 保存即用（未知 id 自动重扫注册）→ `workflow`
|
|
13
|
+
JS 模块 → 保存即用（未知 id 自动重扫注册）→ 自己调 `workflow` 工具试跑
|
|
14
|
+
→ 汇报结果**。
|
|
15
|
+
|
|
16
|
+
## 零语法契约（本 skill 的服务边界）
|
|
17
|
+
|
|
18
|
+
**用户永远只说需求，不说工具语法。** `flow=` / `topic=` /
|
|
19
|
+
`checkpointMode=` 这些参数全部由你（agent）组织：
|
|
20
|
+
|
|
21
|
+
- 用户说「创建一个 workflow js：需求是 xxx」→ 你走完澄清、写文件、
|
|
22
|
+
**立即自己调用 workflow 工具试跑**（topic 从需求里取一个小而真实的
|
|
23
|
+
样例，checkpointMode 用 auto-approve）、把运行结果汇报给用户——
|
|
24
|
+
一口气做完，中途不要把工具参数丢回给用户
|
|
25
|
+
- 用户以后想再跑：说人话即可（「用拼音口诀流程，词：知识库」/
|
|
26
|
+
「再跑一次发布说明，主题换成 y」）——由你翻译成工具参数
|
|
27
|
+
- 需求已明确就别问；有真歧义才问，且一次问全
|
|
14
28
|
|
|
15
29
|
> v0.6.0 起声明式 JSON 流程已移除（`workflow_define` 工具同步下线），
|
|
16
30
|
> 自定义流程只有代码形态。历史 JSON 用 `@mickorz/opencode-agentic-workflow/core`
|
|
@@ -105,29 +119,29 @@ export default defineWorkflow({
|
|
|
105
119
|
（拼音表/映射表/词表）时，**把数据直接内嵌进 .mjs 文件**（大表放
|
|
106
120
|
文件底部，配惰性索引）；库能力做不到的部分交给 `agent` 步
|
|
107
121
|
|
|
108
|
-
##
|
|
122
|
+
## 第三步：立即试跑 + 汇报（无需重启，你自己跑，不是让用户跑）
|
|
109
123
|
|
|
110
|
-
|
|
124
|
+
保存文件后**你直接调用 `workflow` 工具**——未知 flow id 会触发一次 flows
|
|
111
125
|
目录增量重扫，刚写的模块当场注册运行（v0.6.1 起；v1「定义即注册」的
|
|
112
|
-
|
|
126
|
+
代码形态对位）。参数自己组织：`flow=<id>, topic=<从需求取的小而真实样例>,
|
|
127
|
+
checkpointMode=auto-approve`（headless 必传）。关注：
|
|
113
128
|
|
|
114
|
-
-
|
|
129
|
+
- 步骤是否全 completed；失败步的报错（参数缺失/文件路径/评审否决）
|
|
130
|
+
- 产物是否落盘、内容是否符合预期
|
|
115
131
|
- `workflow not found` 且附 `flows load errors` 清单：文件写了但没注册
|
|
116
132
|
上——按指名的错误修文件再试
|
|
133
|
+
- 有 `background: true` 需求时用 `workflow_control status` 轮询
|
|
117
134
|
- **边界（如实）**：只有**新文件**能被重扫拾取；**改动已装载文件**
|
|
118
135
|
（含升 version）需重启生效（Node ESM 缓存按路径，重导返回旧模块）。
|
|
119
136
|
编辑既有流程后用 resumeRunId 前先重启
|
|
120
137
|
|
|
121
|
-
|
|
122
|
-
|
|
123
|
-
调用 `workflow` 工具：`flow=<id>, topic=<真实小主题>, checkpointMode=auto-approve`
|
|
124
|
-
（headless 必传）。关注：
|
|
138
|
+
试跑通过后**用自然语言向用户汇报**（不要贴工具语法）：
|
|
125
139
|
|
|
126
|
-
|
|
127
|
-
-
|
|
128
|
-
|
|
129
|
-
|
|
130
|
-
|
|
140
|
+
```
|
|
141
|
+
流程已创建并试跑通过：pinyin-mnemonic（中文词 -> 拼音首字母 -> 记忆口诀）
|
|
142
|
+
试跑：知识库 -> ZSK，口诀「知识三点连成库」
|
|
143
|
+
以后想用，直接说：「用拼音口诀流程，词：xxx」
|
|
144
|
+
```
|
|
131
145
|
|
|
132
146
|
## JSON → JS 迁移映射
|
|
133
147
|
|