dsh-workplan 3.0.3 → 3.0.9
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/CHANGELOG.md +76 -0
- package/README.en.md +15 -7
- package/README.md +32 -20
- package/README.zh.md +8 -7
- package/client.js +181 -27
- package/docs/release-notes-3.0.3.md +7 -0
- package/docs/release-notes-3.0.9.md +7 -0
- package/lib/approval-gate.js +79 -3
- package/lib/client.js +181 -27
- package/lib/comm-format.js +6 -6
- package/lib/dept-journal.js +223 -6
- package/lib/{three-phase.js → five-step.js} +210 -134
- package/lib/host.js +316 -79
- package/lib/lessons.js +87 -19
- package/lib/llm-rules.js +25 -82
- package/lib/notice-ledger.js +238 -0
- package/lib/plan.js +275 -68
- package/lib/runtime.js +747 -161
- package/lib/understanding.js +85 -6
- package/lib/v3-contract.js +48 -15
- package/package.json +2 -3
- package/src/approval-gate.ts +77 -3
- package/src/client.ts +178 -24
- package/src/comm-format.ts +6 -6
- package/src/dept-journal.ts +219 -7
- package/src/{three-phase.ts → five-step.ts} +236 -169
- package/src/host.ts +316 -79
- package/src/lessons.ts +92 -19
- package/src/llm-rules.ts +30 -101
- package/src/notice-ledger.ts +251 -0
- package/src/plan.ts +276 -66
- package/src/runtime.ts +800 -159
- package/src/understanding.ts +100 -6
- package/src/v3-contract.ts +49 -16
package/src/lessons.ts
CHANGED
|
@@ -7,8 +7,8 @@
|
|
|
7
7
|
* 记忆并预防再犯。
|
|
8
8
|
*
|
|
9
9
|
* 实现分三块,缺一块就只是口号:
|
|
10
|
-
* 1.
|
|
11
|
-
* 必填项;缺少问题/弯路/解决/预防就无法记成 done(见
|
|
10
|
+
* 1. 证据契约:第四步(验证阶段)的 `phases.verification.retrospective` 是
|
|
11
|
+
* 必填项;缺少问题/弯路/解决/预防就无法记成 done(见 five-step.ts)。
|
|
12
12
|
* 2. 永久记忆:复盘通过后立刻落盘到 JSONL(默认 `~/.dsh/workplan/lessons.jsonl`,
|
|
13
13
|
* 可用 `DSH_WORKPLAN_LESSONS_FILE` 覆盖),追加写、跨会话跨项目长期保留。
|
|
14
14
|
* 3. 防再犯:每次派发子任务前,按部门/关键词/时间/重复次数排序,把最相关的
|
|
@@ -18,7 +18,7 @@
|
|
|
18
18
|
* 本模块不依赖 harness 服务,只做纯函数 + 同步文件读写,便于离线回放与测试。
|
|
19
19
|
*/
|
|
20
20
|
import { createHash } from 'node:crypto'
|
|
21
|
-
import { appendFileSync, existsSync, mkdirSync, readFileSync, renameSync, writeFileSync } from 'node:fs'
|
|
21
|
+
import { appendFileSync, chmodSync, copyFileSync, existsSync, lstatSync, mkdirSync, readFileSync, renameSync, writeFileSync } from 'node:fs'
|
|
22
22
|
import { homedir } from 'node:os'
|
|
23
23
|
import { dirname, join } from 'node:path'
|
|
24
24
|
|
|
@@ -95,7 +95,7 @@ function totalChars(items: string[]): number {
|
|
|
95
95
|
}
|
|
96
96
|
|
|
97
97
|
/**
|
|
98
|
-
* 复盘证据的**唯一**校验入口:
|
|
98
|
+
* 复盘证据的**唯一**校验入口:five-step.ts 与运行时都调它,保证
|
|
99
99
|
* 「提示词要求什么」和「完成判定检查什么」是同一份契约。
|
|
100
100
|
*/
|
|
101
101
|
export function validateRetrospective(value: any): RetrospectiveValidation {
|
|
@@ -105,7 +105,7 @@ export function validateRetrospective(value: any): RetrospectiveValidation {
|
|
|
105
105
|
return {
|
|
106
106
|
ok: false,
|
|
107
107
|
retrospective: empty,
|
|
108
|
-
errors: ['phases.verification.retrospective
|
|
108
|
+
errors: ['phases.verification.retrospective 缺失:第四步收尾必须复盘「问题 / 弯路 / 解决 / 预防」四项'],
|
|
109
109
|
}
|
|
110
110
|
}
|
|
111
111
|
const problems = readList(value.problems)
|
|
@@ -189,26 +189,41 @@ export function resolveLessonsFile(env: NodeJS.ProcessEnv = process.env): string
|
|
|
189
189
|
return join(homedir(), '.dsh', 'workplan', 'lessons.jsonl')
|
|
190
190
|
}
|
|
191
191
|
|
|
192
|
-
|
|
193
|
-
|
|
192
|
+
type JsonLinesSnapshot = {
|
|
193
|
+
rows: any[]
|
|
194
|
+
/** 无法解析的行原样保留:重写文件时必须带回去,禁止静默丢弃。 */
|
|
195
|
+
corrupt: string[]
|
|
196
|
+
/** 读失败与「文件不存在」必须分开:前者绝不能当成空文件。 */
|
|
197
|
+
readError: unknown | null
|
|
198
|
+
}
|
|
199
|
+
|
|
200
|
+
function readJsonLinesSnapshot(file: string): JsonLinesSnapshot {
|
|
201
|
+
if (!existsSync(file)) return { rows: [], corrupt: [], readError: null }
|
|
194
202
|
let text = ''
|
|
195
203
|
try {
|
|
196
204
|
text = readFileSync(file, 'utf8')
|
|
197
|
-
} catch {
|
|
198
|
-
return []
|
|
205
|
+
} catch (readError) {
|
|
206
|
+
return { rows: [], corrupt: [], readError }
|
|
199
207
|
}
|
|
200
208
|
const rows: any[] = []
|
|
209
|
+
const corrupt: string[] = []
|
|
201
210
|
for (const line of text.split('\n')) {
|
|
202
211
|
const trimmed = line.trim()
|
|
203
212
|
if (!trimmed) continue
|
|
204
213
|
try {
|
|
205
214
|
const parsed = JSON.parse(trimmed)
|
|
206
215
|
if (isRecord(parsed)) rows.push(parsed)
|
|
216
|
+
else corrupt.push(trimmed)
|
|
207
217
|
} catch {
|
|
208
|
-
//
|
|
218
|
+
// 单行损坏不能拖垮整份记忆:读端跳过该行,写端原样保留。
|
|
219
|
+
corrupt.push(trimmed)
|
|
209
220
|
}
|
|
210
221
|
}
|
|
211
|
-
return rows
|
|
222
|
+
return { rows, corrupt, readError: null }
|
|
223
|
+
}
|
|
224
|
+
|
|
225
|
+
function readJsonLines(file: string): any[] {
|
|
226
|
+
return readJsonLinesSnapshot(file).rows
|
|
212
227
|
}
|
|
213
228
|
|
|
214
229
|
function coerceRecord(raw: any): LessonRecord | null {
|
|
@@ -240,12 +255,52 @@ export function readLessons(file: string = resolveLessonsFile()): LessonRecord[]
|
|
|
240
255
|
.filter((item): item is LessonRecord => item !== null)
|
|
241
256
|
}
|
|
242
257
|
|
|
243
|
-
|
|
244
|
-
|
|
245
|
-
|
|
258
|
+
/**
|
|
259
|
+
* [3.0.3] 防符号链接投毒:写入前确认目标不是符号链接,否则抛错拒绝
|
|
260
|
+
* (风格同 LESSONS_READ_FAILED)。攻击者把教训文件或临时文件路径换成
|
|
261
|
+
* 符号链接后,一次「原子重写」就会被重定向去覆盖无关文件。
|
|
262
|
+
*/
|
|
263
|
+
function assertLessonsWriteTarget(file: string, what: string) {
|
|
264
|
+
let stat
|
|
265
|
+
try {
|
|
266
|
+
stat = lstatSync(file)
|
|
267
|
+
} catch {
|
|
268
|
+
return // 不存在:正常新写。
|
|
269
|
+
}
|
|
270
|
+
if (stat.isSymbolicLink()) {
|
|
271
|
+
throw new Error(`LESSONS_WRITE_REFUSED: 拒绝向符号链接${what}写入 ${file},以免被重定向覆盖无关文件`)
|
|
272
|
+
}
|
|
273
|
+
}
|
|
274
|
+
|
|
275
|
+
function writeLessonsAtomic(file: string, records: LessonRecord[], corrupt: string[] = []) {
|
|
276
|
+
assertLessonsWriteTarget(file, '')
|
|
277
|
+
assertLessonsWriteTarget(`${file}.bak`, '备份')
|
|
278
|
+
mkdirSync(dirname(file), { recursive: true, mode: 0o700 })
|
|
279
|
+
const lines = [
|
|
280
|
+
...records.map((item) => JSON.stringify(item)),
|
|
281
|
+
// 坏行原样留在文件末尾:下次读端仍会跳过,但绝不会因为一次重写就消失。
|
|
282
|
+
...corrupt,
|
|
283
|
+
]
|
|
284
|
+
const body = lines.length > 0 ? `${lines.join('\n')}\n` : ''
|
|
285
|
+
// 覆盖前留一代备份;备份失败不阻断主写入(主写入仍走临时文件 + 原子改名)。
|
|
286
|
+
if (existsSync(file)) {
|
|
287
|
+
try {
|
|
288
|
+
copyFileSync(file, `${file}.bak`)
|
|
289
|
+
} catch {
|
|
290
|
+
// 备份是尽力而为:权限不足等情况下,主写入的失败会由调用方显式上报。
|
|
291
|
+
}
|
|
292
|
+
}
|
|
246
293
|
const tmp = `${file}.tmp-${process.pid}`
|
|
247
|
-
|
|
294
|
+
assertLessonsWriteTarget(tmp, '临时文件')
|
|
295
|
+
writeFileSync(tmp, body, { encoding: 'utf8', mode: 0o600 })
|
|
248
296
|
renameSync(tmp, file)
|
|
297
|
+
// 已存在文件收紧到 0o600(rename 覆盖了同名符号链接之外的目标时,
|
|
298
|
+
// 权限可能带着旧文件的宽松位):best-effort,文件系统不支持时不断写。
|
|
299
|
+
try {
|
|
300
|
+
chmodSync(file, 0o600)
|
|
301
|
+
} catch {
|
|
302
|
+
// best-effort。
|
|
303
|
+
}
|
|
249
304
|
}
|
|
250
305
|
|
|
251
306
|
export type RecordLessonInput = {
|
|
@@ -281,7 +336,22 @@ export function recordLesson(input: RecordLessonInput): RecordLessonResult | nul
|
|
|
281
336
|
problems: retro.problems,
|
|
282
337
|
prevention: retro.prevention,
|
|
283
338
|
})
|
|
284
|
-
const
|
|
339
|
+
const snapshot = readJsonLinesSnapshot(file)
|
|
340
|
+
/*
|
|
341
|
+
* 数据安全红线:读失败 ≠ 没有历史。
|
|
342
|
+
* 以前这里把 EACCES/EMFILE/EIO 当成空数组,随后「读-改-写」会把整份永久记忆
|
|
343
|
+
* 覆盖成刚写入的这一条。现在读失败直接抛错,由 runtime 的 catch 记录到状态里;
|
|
344
|
+
* 坏行则原样带回写端,重写时不会丢。
|
|
345
|
+
*/
|
|
346
|
+
if (snapshot.readError) {
|
|
347
|
+
const message = snapshot.readError instanceof Error
|
|
348
|
+
? snapshot.readError.message
|
|
349
|
+
: String(snapshot.readError)
|
|
350
|
+
throw new Error(`LESSONS_READ_FAILED: 无法读取 ${file},已拒绝写入以免覆盖历史教训(${message})`)
|
|
351
|
+
}
|
|
352
|
+
const records = snapshot.rows
|
|
353
|
+
.map(coerceRecord)
|
|
354
|
+
.filter((item): item is LessonRecord => item !== null)
|
|
285
355
|
const sameRow = records.findIndex((item) =>
|
|
286
356
|
item.planId === input.planId && item.subtaskId === input.subtaskId)
|
|
287
357
|
const sameIssue = records.findIndex((item) =>
|
|
@@ -322,10 +392,13 @@ export function recordLesson(input: RecordLessonInput): RecordLessonResult | nul
|
|
|
322
392
|
// 时间正序保留最近 N 条;id 冲突(同一毫秒重复)时无需特殊处理,读端按行。
|
|
323
393
|
const kept = records.slice(Math.max(0, records.length - MAX_LESSON_RECORDS))
|
|
324
394
|
try {
|
|
325
|
-
writeLessonsAtomic(file, kept)
|
|
326
|
-
} catch {
|
|
395
|
+
writeLessonsAtomic(file, kept, snapshot.corrupt)
|
|
396
|
+
} catch (error) {
|
|
397
|
+
// 符号链接投毒是拒绝不是故障:不上 append 兜底,直接向上抛。
|
|
398
|
+
if (error instanceof Error && error.message.startsWith('LESSONS_WRITE_REFUSED')) throw error
|
|
327
399
|
try {
|
|
328
|
-
mkdirSync(dirname(file), { recursive: true })
|
|
400
|
+
mkdirSync(dirname(file), { recursive: true, mode: 0o700 })
|
|
401
|
+
assertLessonsWriteTarget(file, '')
|
|
329
402
|
appendFileSync(file, `${JSON.stringify(base)}\n`, 'utf8')
|
|
330
403
|
} catch {
|
|
331
404
|
return null
|
package/src/llm-rules.ts
CHANGED
|
@@ -33,14 +33,8 @@ import {
|
|
|
33
33
|
type ModelFamily,
|
|
34
34
|
type TaskComplexity,
|
|
35
35
|
} from './plan.js'
|
|
36
|
-
// [
|
|
37
|
-
|
|
38
|
-
import {
|
|
39
|
-
MIN_PLANNING_APPROACH_CHARS,
|
|
40
|
-
MIN_PLANNING_BASIS_CHARS,
|
|
41
|
-
MIN_PLANNING_PROBLEM_CHARS,
|
|
42
|
-
threePhasePromptLines,
|
|
43
|
-
} from './three-phase.js'
|
|
36
|
+
// [3.0.8] 注入 five-step 的五步提示词段落(buildDelegateePrompt 使用)。
|
|
37
|
+
import { fiveStepPromptLines, START_EVIDENCE_MIN_CHARS_BRIEF } from './five-step.js'
|
|
44
38
|
// [3.0.0] 用户 2026-11-14 第 5、6、7、9 条要求的纯逻辑契约(零依赖模块):
|
|
45
39
|
// 极简任务硬门槛 + 质量要求硬门槛 + 专家精简 JSON 汇报契约。
|
|
46
40
|
import {
|
|
@@ -182,20 +176,21 @@ export function buildLlmRulesBrief(info: LlmRulesBriefInfo = {}): string {
|
|
|
182
176
|
lines.push(`- 部门负责人已为本任务配置整体推理等级 \`${info.taskEffort}\`(effortOverride,负责人自配档):本任务每次派发/重试/续跑全程沿用该等级,不得中途丢弃或覆盖;下级自己的等级以 self_effort 自配为权威(分工表档仅建议)。`)
|
|
183
177
|
}
|
|
184
178
|
if (info.tier === 'delegate') {
|
|
185
|
-
lines.push(`- 你是部门第三层执行者(本部门相关领域全球顶尖专家${info.memberName ? `:${info.memberName}` : ''}
|
|
179
|
+
lines.push(`- 你是部门第三层执行者(本部门相关领域全球顶尖专家${info.memberName ? `:${info.memberName}` : ''})。执行自己的任务必须遵守五步工作法的前三步(3.0.8 单一框架):第一步全面、全盘、深入梳理、研究、思考自己的任务;第二步基于第一步完成好的所有结果,研究需要哪些资源、哪些工具、具体实施方案(方法、流程、步骤,含依据);第三步把资源与工具真正备齐并给出就绪证据;然后进入第四步具体执行,全程少走弯路(先查历史教训、先验证再动手、不重复试错)。前三步证据经 phase-0(low 档启动)由 dsh_workplan_delegate(action="self_effort") 一并提交 startPhases={ planning{ problemAnalysis[], approach[], approachBasis[], resources[], tools[] }, preparation{ prepared[], evidence[] } },未登记合格证据平台不会接续你进入正式执行。分工表给你的档位仅为建议:你必须在 phase-0 经 self_effort 按自己任务复杂度提交自配档(reasoningEffort+complexityRationale),平台登记后立即以自配档接续你执行正式任务;越界档会被钳制并留痕。开工前必须先预估本人任务耗时(整数分钟)并经 self_effort 的 timeNotice 上报部门负责人,未上报不接续(T6/D9 硬门禁)。必须确保自身任务完成品质非常高的前提下,完美、超高效率地执行。`)
|
|
186
180
|
} else {
|
|
187
181
|
// [2.5.4][T4] 人数口径同步(D1/D2):非复杂≤6;复杂(medium/high/xhigh/max)≥8 且 ≤12,少于 8 硬性阻断。
|
|
188
|
-
lines.push('- 部门负责人(本任务书的直接接收者)强制流程(用户要求 1/2/3,
|
|
182
|
+
lines.push('- 部门负责人(本任务书的直接接收者)强制流程(用户要求 1/2/3,3.0.8 五步工作法单框架):你拥有本部门内的再分配权限——执行自己的任务必须先完成五步前三步(第一步任务梳理;第二步基于第一步全部结果研究资源、工具与具体实施方案;第三步把资源与工具真正备齐并给出就绪证据),正式执行与再分配全程少走弯路(先查历史教训、先验证再动手、不重复试错),经 dsh_workplan_delegate(action="review") 一并提交分工表(assignments + taskReasoningEffort)与第 1/2/3 步证据(startPhases={ planning{ problemAnalysis[], approach[], approachBasis[], resources[], tools[] }, preparation{ prepared[], evidence[] } }),并在 consolidation.taskReasoningEffort 里按你接到任务的复杂度配置你自己的整体推理等级(先配置后开工:phase-0 以 low 启动,登记后平台立即以自配档接续本会话进入 phase-1,重试/续跑全程生效);第 1/2/3 步证据与分工表未提交前,dsh_workplan_delegate(action="dispatch") 会被平台拒绝(硬门禁)。梳理完成后必须把任务拆得更简单——每位下级只承担单一目标、单一主产物、可独立验收的一项工作——再合理分配给本部门多名相关领域全球顶尖专家(部门组员角色已按用户要求 9 取消,分工表只允许 role="expert",至少 1 名;low/未配置任务禁止下派——负责人亲自执行,第 1/2/3 步证据经 dsh_workplan_delegate(action="direct") 登记(' + START_EVIDENCE_MIN_CHARS_BRIEF + ';可选 reasoningEffort="low");复杂任务(medium/high/xhigh/max)合计不少于 8 人且最多 12 人,少于 8 人硬性阻断);每位下级必须在 phase-0 经 dsh_workplan_delegate(action="self_effort") 按自己分到的单项任务复杂度自配推理等级(轻度=low;qwen 中等=medium、非 qwen 中等=high;qwen 非常复杂=xhigh、非 qwen 非常复杂=max),专家自配为权威(分工表 per-expert 档仅建议),平台登记后以自配档接续下级会话,全程应用;平台会按上述等级集合自动钳制越界档并留痕,等级在其任务全生命周期生效且不可被覆盖。第三层为叶子层:任何第四层派发一律被拒绝。')
|
|
189
183
|
/*
|
|
190
184
|
* [3.0.0] 用户 2026-11-14 第 3、5、6、7、8、10、11 条要求:负责人侧四条硬规则。
|
|
191
185
|
* 与代码门禁同源(planDelegations 的 checkAtomicAssignment、comm-format 的
|
|
192
186
|
* F10/F11),提示词只是把代码已经在执行的规则提前说清楚。
|
|
193
187
|
*/
|
|
194
|
-
lines.push('- 极简任务硬门槛(用户要求 5,用户裁决 A=硬门槛):你派出的每一条任务必须简单到像 1+1=2
|
|
188
|
+
lines.push('- 极简任务硬门槛(用户要求 5,用户裁决 A=硬门槛):你派出的每一条任务必须简单到像 1+1=2——一个动作、一个主产物、一项可独立验收;出现「并且/并/同时/另外/还要/以及/分别/顺便/然后/接着/再」或分号并列、或一个任务里写了多句(含英文句点分隔的多句)、或超过 300 字符,平台直接拒绝派发(DELEGATE_TASK_NOT_ATOMIC)并给出拆分提示,实例:不要派「分析并修复并写测试」,要拆成「读 X 定位原因」「按原因改 Y」「写 Z 用例」三条。')
|
|
195
189
|
lines.push('- 质量要求硬门槛(用户要求 6):每一条分派都必须带 qualityRequirements(至少 1 条、每条 ≤400 字符、最多 8 条),写清「成果必须达到什么要求、什么算合格、怎么算不合格」;缺它平台拒绝派发(DELEGATE_QUALITY_REQUIREMENTS_MISSING)。任务书会把这块原文交给专家。')
|
|
196
190
|
lines.push('- 专家汇报必须精简且是 JSON(用户要求 7):专家完成后在证据块里给出 report(keyResults/keyInfo/importantInfo/leadRequirements 四个字符串数组,每数组 ≤6 条、每条 ≤200 字符,禁止重复);你收到后逐条核对,缺项或重复会被格式门禁退回(F10)。')
|
|
197
191
|
lines.push('- 你的汇总必须精简且是 JSON(用户要求 8/10/11):汇总本部门全部专家汇报后,在证据块里给出 departmentSummary(keyResults/keyInfo/importantInfo/sources 四个字符串数组,sources 必须覆盖全部已派发专家,禁止累赘重复);不合格会被退回(F11)。汇总完成后直接交回主 Agent,不需要另建文件。')
|
|
198
192
|
lines.push('- 执行时间与验收:你和每位全球顶尖专家均没有总时长、单次时长、空闲或回执硬截止。开工预估及其汇总只用于协调与告知,未报齐时如实显示部分和,但不构成分钟判据;不得以耗时、预估超额或未经时间批准为由拒绝 done,extendMs 已停用。完成只由真实结果、产物、结构化证据和质量验收决定;用户显式取消与真实错误仍然有效。')
|
|
193
|
+
lines.push('- 专家遇阻处置(3.0.5 硬规则,机制已强制):任何专家调用 dsh_workplan_escalate 后,禁止用 review/dispatch/direct 把该问题改派、重派或降级给其他专家;你必须先用 action="status" 全面梳理该成员的问题与本部门全部 delegates 执行状态,再研究形成解决方案,最后用 dsh_workplan_instruct 答复原 member;平台在该成员待指示期间会硬拒一切改派动作,投递成功后强制原专家继续执行。')
|
|
199
194
|
}
|
|
200
195
|
return lines.join('\n')
|
|
201
196
|
}
|
|
@@ -211,16 +206,13 @@ export function buildLlmRulesBrief(info: LlmRulesBriefInfo = {}): string {
|
|
|
211
206
|
* 唯一入口。
|
|
212
207
|
*/
|
|
213
208
|
export interface ConsolidationInput {
|
|
214
|
-
problemAnalysis?: unknown
|
|
215
|
-
constraints?: unknown
|
|
216
|
-
unknowns?: unknown
|
|
217
|
-
approach?: unknown
|
|
218
209
|
/**
|
|
219
|
-
* [
|
|
220
|
-
*
|
|
221
|
-
*
|
|
210
|
+
* [3.0.8] 五步工作法单框架收口:负责人 review 的 consolidation 不再携带
|
|
211
|
+
* problemAnalysis/constraints/unknowns/approach/approachBasis(原两轮思考
|
|
212
|
+
* 产物)——第 1/2/3 步证据改由 startPhases 承载,经开工闸
|
|
213
|
+
* validateStartPhaseEvidence 判据(与主 Agent/专家同一口径),登记后 durable
|
|
214
|
+
* 持久化,review/dispatch/direct 共用。consolidation 只留分工表与整体等级配置。
|
|
222
215
|
*/
|
|
223
|
-
approachBasis?: unknown
|
|
224
216
|
assignments?: unknown
|
|
225
217
|
/**
|
|
226
218
|
* [2.5.0] 用户要求 2:部门负责人为「整个任务」配置的整体推理等级。
|
|
@@ -268,12 +260,6 @@ export interface DelegationPlan {
|
|
|
268
260
|
*/
|
|
269
261
|
taskEffortDeclared?: string | null
|
|
270
262
|
consolidation?: {
|
|
271
|
-
problemAnalysis: string[]
|
|
272
|
-
constraints: string[]
|
|
273
|
-
unknowns: string[]
|
|
274
|
-
approach: string[]
|
|
275
|
-
/** [2.5.1] 第二轮基于第一轮全部结果的依据对应(两轮深度思考协议必填)。 */
|
|
276
|
-
approachBasis: string[]
|
|
277
263
|
assignments: number
|
|
278
264
|
taskReasoningEffort?: string | null
|
|
279
265
|
}
|
|
@@ -291,12 +277,8 @@ const MAX_COMPLEX_DELEGATE_MEMBERS = 12
|
|
|
291
277
|
/** [2.5.4][T4] D1:除 low 外全部算复杂——medium/high/xhigh/max 均触发 ≥8 人门禁,xhigh 不豁免。 */
|
|
292
278
|
const COMPLEX_DECLARED_EFFORTS: readonly string[] = Object.freeze(['medium', 'high', 'xhigh', 'max'])
|
|
293
279
|
|
|
294
|
-
|
|
295
|
-
|
|
296
|
-
.map((item: any) => String(item ?? '').trim())
|
|
297
|
-
.filter(Boolean)
|
|
298
|
-
.slice(0, limit)
|
|
299
|
-
}
|
|
280
|
+
// [3.0.8] 梳理产物(problemAnalysis/approach/approachBasis 等)已随两轮思考
|
|
281
|
+
// deepThink 门禁废除,分工表闸不再读取清单字段,readTrimmedStrings 一并退役。
|
|
300
282
|
|
|
301
283
|
/**
|
|
302
284
|
* 梳理产物校验 + 分工表校验 + 等级钳制,三合一(一次调用给出全部拒因)。
|
|
@@ -326,23 +308,15 @@ export function planDelegations(input: {
|
|
|
326
308
|
const empty = { ok: false as const, code: 'DELEGATE_CONSOLIDATION_MISSING', members: [], clamped: [], taskEffort: null, taskEffortClamped: null }
|
|
327
309
|
const consolidation = input?.consolidation
|
|
328
310
|
if (!consolidation || typeof consolidation !== 'object') {
|
|
329
|
-
return { ...empty, error: '
|
|
330
|
-
}
|
|
331
|
-
const problemAnalysis = readTrimmedStrings(consolidation.problemAnalysis, 12)
|
|
332
|
-
if (problemAnalysis.length === 0) {
|
|
333
|
-
return { ...empty, code: 'DELEGATE_CONSOLIDATION_INCOMPLETE', error: '梳理产物不完整:problemAnalysis 至少 1 条(现状/事实/约束/未知/主要矛盾逐条写清),未梳理完不得进入再分配。' }
|
|
311
|
+
return { ...empty, error: '尚未提交分工表:先用 dsh_workplan_delegate(action="review") 提交分工表(assignments + taskReasoningEffort),派发才会放行(用户要求 4 的硬门禁)。' }
|
|
334
312
|
}
|
|
335
313
|
/*
|
|
336
|
-
* [
|
|
337
|
-
*
|
|
338
|
-
*
|
|
339
|
-
*
|
|
340
|
-
*
|
|
314
|
+
* [3.0.8] 深度梳理质量闸(problemAnalysis≥40 字)已随两轮思考 deepThink 门禁
|
|
315
|
+
* 一并废除:第 1/2/3 步证据(problemAnalysis/approach/approachBasis/resources/
|
|
316
|
+
* tools/preparation)改由开工闸 startPhases 承载(validateStartPhaseEvidence,
|
|
317
|
+
* review 时随 consolidation 一并校验),同一判据不再两处重复。此处只校验
|
|
318
|
+
* 分工表与整体等级,拒因顺序不变。
|
|
341
319
|
*/
|
|
342
|
-
const problemChars = problemAnalysis.reduce((sum, item) => sum + item.length, 0)
|
|
343
|
-
if (problemChars < MIN_PLANNING_PROBLEM_CHARS) {
|
|
344
|
-
return { ...empty, code: 'DELEGATE_CONSOLIDATION_INCOMPLETE', error: `梳理产物太薄:problemAnalysis 合计 ${problemChars} 字,至少 ${MIN_PLANNING_PROBLEM_CHARS} 字——第一轮必须全面、全盘、深入梳理、研究、思考自己的任务,逐条写清目标与验收、现状、约束、未知、主要矛盾与边界;一句话不能冒充深度梳理。` }
|
|
345
|
-
}
|
|
346
320
|
/*
|
|
347
321
|
* [2.5.4][T4] 复杂判定必须用「声明档」(钳制前):
|
|
348
322
|
* declared = consolidation.taskReasoningEffort ?? input.taskEffortFallback。
|
|
@@ -375,7 +349,7 @@ export function planDelegations(input: {
|
|
|
375
349
|
return {
|
|
376
350
|
...empty,
|
|
377
351
|
code: 'DELEGATE_LOW_TASK_FORBIDDEN',
|
|
378
|
-
error: '本任务为 low 档(或未配置,视同 low):按用户裁决 D1–D5 禁止第三层下派,review/dispatch
|
|
352
|
+
error: '本任务为 low 档(或未配置,视同 low):按用户裁决 D1–D5 禁止第三层下派,review/dispatch 一律硬拒,无任何例外通道。请部门负责人亲自执行:完成五步第 1/2/3 步(任务梳理 + 资源/工具/方案研究 + 准备)后经 dsh_workplan_delegate(action="direct") 登记 startPhases={ planning{ problemAnalysis[], approach[], approachBasis[], resources[], tools[] }, preparation{ prepared[], evidence[] } }(' + START_EVIDENCE_MIN_CHARS_BRIEF + ';可选 reasoningEffort="low";不接受分工表),平台将以 low 档接续本会话亲自执行。已完成的历史派发不回溯。',
|
|
379
353
|
}
|
|
380
354
|
}
|
|
381
355
|
const memberCap = complexTask ? MAX_COMPLEX_DELEGATE_MEMBERS : MAX_DELEGATE_MEMBERS
|
|
@@ -480,50 +454,10 @@ export function planDelegations(input: {
|
|
|
480
454
|
}
|
|
481
455
|
}
|
|
482
456
|
/*
|
|
483
|
-
* [
|
|
484
|
-
*
|
|
485
|
-
*
|
|
486
|
-
* 思考自己的任务;
|
|
487
|
-
* 第二轮(approach):基于第一轮完成好的所有结果,再全面、全盘、深入地
|
|
488
|
-
* 开展梳理、研究和思考,理清具体一步步执行、完美完成任务的方法、流程、
|
|
489
|
-
* 步骤;approachBasis 写清第二轮如何基于第一轮全部结果(依赖可审计)。
|
|
490
|
-
* 放在角色配比校验之后:缺 problemAnalysis/assignments/角色配比的旧拒因
|
|
491
|
-
* 顺序不变,两轮产物门禁是新增的最后一道闸。
|
|
457
|
+
* [3.0.8] 两轮思考产物闸(approach≥40 字 / approachBasis≥20 字)已废除:第 1/2
|
|
458
|
+
* 步证据经 review 的 startPhases 开工闸校验(与主 Agent/专家同一判据),不再在
|
|
459
|
+
* 分工表闸重复。下方直接是复杂任务人数下限闸,拒因顺序不变。
|
|
492
460
|
*/
|
|
493
|
-
const approach = readTrimmedStrings(consolidation.approach, 12)
|
|
494
|
-
if (approach.length === 0) {
|
|
495
|
-
return {
|
|
496
|
-
...empty,
|
|
497
|
-
code: 'DELEGATE_CONSOLIDATION_INCOMPLETE',
|
|
498
|
-
error: '两轮深度思考未完成:approach 至少 1 条——第二轮必须基于第一轮完成好的所有结果,再全面、全盘、深入地开展梳理、研究和思考,理清自己该具体如何一步步执行、达到最终完美完成自己任务的方法、流程和步骤;未理清前不得进入执行与再分配。',
|
|
499
|
-
}
|
|
500
|
-
}
|
|
501
|
-
// [2.5.4][T3R1] 第二轮方法流程步骤质量闸:与主 Agent/叶子同一 40 字下限。
|
|
502
|
-
const approachChars = approach.reduce((sum, item) => sum + item.length, 0)
|
|
503
|
-
if (approachChars < MIN_PLANNING_APPROACH_CHARS) {
|
|
504
|
-
return {
|
|
505
|
-
...empty,
|
|
506
|
-
code: 'DELEGATE_CONSOLIDATION_INCOMPLETE',
|
|
507
|
-
error: `梳理产物太薄:approach 合计 ${approachChars} 字,至少 ${MIN_PLANNING_APPROACH_CHARS} 字——第二轮要基于第一轮全部结果理清具体一步步执行、完美完成任务的方法、流程和步骤,而不是一句目标。`,
|
|
508
|
-
}
|
|
509
|
-
}
|
|
510
|
-
const approachBasis = readTrimmedStrings(consolidation.approachBasis, 12)
|
|
511
|
-
if (approachBasis.length === 0) {
|
|
512
|
-
return {
|
|
513
|
-
...empty,
|
|
514
|
-
code: 'DELEGATE_CONSOLIDATION_INCOMPLETE',
|
|
515
|
-
error: '两轮深度思考未完成:approachBasis 至少 1 条——第二轮的方法、流程、步骤必须基于第一轮完成好的所有结果,逐条写清第一轮的哪些事实/约束/矛盾决定了第二轮的哪些方法/流程/步骤(依赖依据,不可省略)。',
|
|
516
|
-
}
|
|
517
|
-
}
|
|
518
|
-
// [2.5.4][T3R1] 第二轮依据质量闸:与主 Agent/叶子同一 20 字下限。
|
|
519
|
-
const basisChars = approachBasis.reduce((sum, item) => sum + item.length, 0)
|
|
520
|
-
if (basisChars < MIN_PLANNING_BASIS_CHARS) {
|
|
521
|
-
return {
|
|
522
|
-
...empty,
|
|
523
|
-
code: 'DELEGATE_CONSOLIDATION_INCOMPLETE',
|
|
524
|
-
error: `梳理产物太薄:approachBasis 合计 ${basisChars} 字,至少 ${MIN_PLANNING_BASIS_CHARS} 字——要写清第二轮的方法、流程、步骤如何基于第一轮梳理、研究、思考完成好的所有结果(拆解理由与依赖对应,不可省略)。`,
|
|
525
|
-
}
|
|
526
|
-
}
|
|
527
461
|
/*
|
|
528
462
|
* [2.5.4][T4] 用户决策 D1/D2 人数下限硬门禁(新增的最后一道闸):
|
|
529
463
|
* 复杂任务(声明档 medium/high/xhigh/max)expert+member 合计必须 ≥8 人,
|
|
@@ -576,11 +510,6 @@ export function planDelegations(input: {
|
|
|
576
510
|
// [2.5.5][T3] 钳制前原始声明随 ok 返回,供平台持久化为 taskReasoningEffortDeclared。
|
|
577
511
|
taskEffortDeclared: typeof rawTaskEffort === 'string' ? rawTaskEffort : null,
|
|
578
512
|
consolidation: {
|
|
579
|
-
problemAnalysis,
|
|
580
|
-
constraints: readTrimmedStrings(consolidation.constraints, 12),
|
|
581
|
-
unknowns: readTrimmedStrings(consolidation.unknowns, 12),
|
|
582
|
-
approach,
|
|
583
|
-
approachBasis,
|
|
584
513
|
assignments: members.length,
|
|
585
514
|
taskReasoningEffort: taskEffort,
|
|
586
515
|
},
|
|
@@ -632,18 +561,18 @@ export function buildDelegateePrompt(input: {
|
|
|
632
561
|
input.rulesBrief,
|
|
633
562
|
'',
|
|
634
563
|
'执行要求(用户强制要求 5 原文口径):',
|
|
635
|
-
'-
|
|
564
|
+
'- 执行自己的任务必须先完成下方「五步工作法」的前三步(3.0.8 单一框架):第一步全面、全盘、深入梳理、研究、思考自己的任务;第二步基于第一步完成好的所有结果研究需要哪些资源、哪些工具、具体实施方案(方法、流程、步骤,含依据 approachBasis);第三步把资源与工具真正备齐并给出就绪证据。前三步证据经 phase-0 的 self_effort 一并提交 startPhases,未登记合格证据平台不会接续你进入正式执行;第四步执行必须严格基于第二步理清的方法、流程、步骤,全程少走弯路(先查历史教训、先验证再动手、不重复试错)。',
|
|
636
565
|
'- 你的推理等级以自配为权威(分工表档仅建议):phase-0(low 档启动)唯一职责是经 dsh_workplan_delegate(action="self_effort") 提交自配档;phase-1 以登记生效的自配档全程应用(规划、执行、验证、复盘全生命周期),不得自行换档。',
|
|
637
566
|
'- 开工前必须先预估本人任务耗时(整数分钟)并经 self_effort 的 timeNotice={ declaredMinutes: 正整数分钟, reason? } 上报部门负责人,未上报不接续(T6/D9 硬门禁:ESTIMATE_MISSING/ESTIMATE_INVALID);该上报只是协调信息,必须如实预估。你和部门负责人执行任务均没有总时长、单次时长、空闲或回执硬截止;预估或实际耗时不会触发延期、超时接手,也不影响 done 验收。',
|
|
638
567
|
'- 必须在确保自身任务完成品质非常高的前提下,完美、超高效率地执行;严禁低效执行与浪费 token。',
|
|
639
568
|
'- 你是第三层叶子执行者:不得派生任何第四层 Agent/子会话;无法完成时在结论首行写 BLOCKED: 原因 并说明缺什么,不要空转。',
|
|
640
|
-
'-
|
|
569
|
+
'- 遇阻上报通道(3.0.5 四步闭环):遇阻(缺权限/缺输入/依赖产物缺失/需求自相矛盾/无法验证/需要负责人决定方向)时,第一动作是调用 dsh_workplan_escalate({ "question": "需要负责人回答的单个问题", "options": ["可选方向"], "needs": ["需要谁提供什么"] })。流程必须严格为:你先向部门负责人报告具体问题→负责人全面梳理你的问题与本部门全部已派发任务执行状态→负责人研究形成解决方案→负责人用 dsh_workplan_instruct 把方案告诉你→你继续执行原任务。平台禁止负责人在你待指示期间把你改派给其他专家;你必须是继续执行的人。调用 escalate 成功后停止推进、只做只读核对,不要自行选定一个选项继续。',
|
|
641
570
|
'- 完成后把结论与逐项证据(命令输出/文件/引用)用简洁中文回报给部门负责人会话;同时把同一份结构化结论写入 reports/wp-member-<你的成员名>-<任务代号>.json(相对工作目录,目录不存在就创建)作为结算兜底。',
|
|
642
|
-
`- 结果块契约:以 ${EVIDENCE_MARKER_BEGIN} 开头、${EVIDENCE_MARKER_END} 结尾,内含合法 JSON(status ∈ done/blocked/partial、phases
|
|
571
|
+
`- 结果块契约:以 ${EVIDENCE_MARKER_BEGIN} 开头、${EVIDENCE_MARKER_END} 结尾,内含合法 JSON(status ∈ done/blocked/partial、phases 五步证据、acceptance 逐条带证据)。`,
|
|
643
572
|
'',
|
|
644
573
|
renderExpertReportSpec(),
|
|
645
574
|
'',
|
|
646
|
-
...
|
|
575
|
+
...fiveStepPromptLines(),
|
|
647
576
|
].filter(Boolean).join('\n'))
|
|
648
577
|
}
|
|
649
578
|
|
|
@@ -660,8 +589,8 @@ export function buildPhaseZeroDelegateePrompt(input: { departmentLabel?: string;
|
|
|
660
589
|
...(qualityBlock ? [qualityBlock] : []),
|
|
661
590
|
`工作目录:${input.cwd || '(未知)'}`,
|
|
662
591
|
...(input.extraContext ? ['', input.extraContext] : []),
|
|
663
|
-
'
|
|
664
|
-
'
|
|
665
|
-
'不要执行任务本身,不得派生任何第四层 Agent/子会话。缺交或不合格
|
|
592
|
+
'本阶段唯一职责(先配置+先研究准备,后开工):评估你分到的单项任务的复杂度,并完成五步工作法前三步(任务梳理、资源/工具/方案研究、准备就绪),然后调用 dsh_workplan_delegate(action="self_effort") 一次性提交:reasoningEffort(你的自配推理等级:轻度=low;qwen 中等=medium、非 qwen 中等=high;qwen 非常复杂=xhigh、非 qwen 非常复杂=max)+ complexityRationale(复杂度依据,必填)+ startPhases={ planning{ problemAnalysis[], approach[], approachBasis[], resources[], tools[] }, preparation{ prepared[], evidence[] } }(第 1/2/3 步证据,必填)+ timeNotice={ declaredMinutes: 正整数分钟, reason? }(开工前预估,必填)。未提交/不合格预估会被硬拒(ESTIMATE_MISSING/ESTIMATE_INVALID):没有告知部门负责人预估时间,先拦截,再告知此人,你必须自己预估时间,汇报给对应负责人后,才可以重试或继续执行。',
|
|
593
|
+
'startPhases 五步前三步口径(与主 Agent/负责人同一判据):第一步 problemAnalysis=先全面、全盘、深入梳理、研究、思考自己分到的任务(目标与验收/现状/事实/约束/未知/主要矛盾/边界,合计≥40字);第二步 resources=需要哪些资源(数据/文件/权限/人/知识/时间,合计≥20字)+ tools=需要哪些工具、每个用来做什么(合计≥10字)+ approach=基于第一步完成好的所有结果理清的具体一步步执行、确保完美完成的方法、流程和步骤(合计≥40字,含如何少走弯路:先查历史教训、先验证再动手、不重复试错)+ approachBasis=第二步如何基于第一步全部结果的依据对应(合计≥20字);第三步 preparation.prepared=已备齐的资源/工具清单(合计≥20字)+ preparation.evidence=逐项就绪证据(命令输出/文件路径/配置项/版本号/引用,合计≥20字)。',
|
|
594
|
+
'不要执行任务本身,不得派生任何第四层 Agent/子会话。缺交或不合格 startPhases 会被硬拒(START_EVIDENCE_MISSING / START_EVIDENCE_INCOMPLETE),不登记、不接续。三项齐全提交后结束本回合;平台会立即以你的自配档接续本会话进入 phase-1(正式任务),正式执行必须严格按你第二步理清的方法、流程、步骤进行。越界档由平台按模型家族合法集合钳制并留痕。',
|
|
666
595
|
].join('\n')
|
|
667
596
|
}
|