dsh-workplan 3.0.6 → 3.1.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/CHANGELOG.md +27 -0
- package/README.en.md +2 -2
- package/README.md +16 -14
- package/README.zh.md +2 -2
- package/docs/release-notes-3.0.9.md +7 -0
- package/docs/release-notes-3.1.0.md +7 -0
- package/lib/caps.js +43 -0
- package/lib/comm-format.js +7 -7
- package/lib/{three-phase.js → five-step.js} +204 -132
- package/lib/host.js +124 -77
- package/lib/lessons.js +4 -4
- package/lib/llm-rules.js +71 -104
- package/lib/plan.js +186 -80
- package/lib/runtime.js +367 -139
- package/lib/v3-contract.js +10 -7
- package/package.json +2 -3
- package/src/caps.ts +49 -0
- package/src/comm-format.ts +7 -6
- package/src/{three-phase.ts → five-step.ts} +230 -167
- package/src/host.ts +124 -77
- package/src/lessons.ts +4 -4
- package/src/llm-rules.ts +83 -127
- package/src/plan.ts +181 -76
- package/src/runtime.ts +373 -137
- package/src/v3-contract.ts +10 -7
package/lib/host.js
CHANGED
|
@@ -12,7 +12,9 @@ import { fileURLToPath } from 'node:url';
|
|
|
12
12
|
* - the read-only dashboard route.
|
|
13
13
|
*/
|
|
14
14
|
import { applyHardeningHeaders, cancelToolOutputSchema, createWorkplanRuntime, dispatchToolOutputSchema, plannerOutputSchema, replanToolOutputSchema, statusToolOutputSchema, updateToolOutputSchema, } from './runtime.js';
|
|
15
|
-
import { DEPARTMENT_IDS, isRecord } from './plan.js';
|
|
15
|
+
import { DEPARTMENT_IDS, isRecord, START_EVIDENCE_MIN_CHARS_BRIEF } from './plan.js';
|
|
16
|
+
// [3.1.0] 人数上限单一真源(caps.ts):工具说明书与门禁/消毒/提示词同源。
|
|
17
|
+
import { MAX_COMPLEX_DELEGATE_MEMBERS, MIN_COMPLEX_DELEGATE_MEMBERS } from './caps.js';
|
|
16
18
|
import { autoResumeEnabledFrom } from './auto-resume.js';
|
|
17
19
|
import { pruneJournal } from './dept-journal.js';
|
|
18
20
|
/*
|
|
@@ -93,13 +95,13 @@ const PROMPT_SECTION = [
|
|
|
93
95
|
'3.0.0 任务书质量要求(用户要求 3/6):插件派给部门负责人的每个子任务都携带 qualityRequirements(结果质量要求),部门负责人派给专家的每条任务也必须携带 qualityRequirements。负责人→专家缺它平台直接拒绝派发(DELEGATE_QUALITY_REQUIREMENTS_MISSING);主 Agent→部门负责人缺它则该子任务在派发时被直接拒发(DISPATCH_QUALITY_REQUIREMENTS_MISSING,不启动部门 Agent),须 replan 补齐后重派。你审阅计划时先看每个子任务是否写了清楚的质量要求。',
|
|
94
96
|
'3.0.0 极简任务(用户要求 5,用户裁决 A=硬门槛):部门负责人派出的每条任务必须简单到像 1+1=2——一个动作、一个主产物、一项可独立验收,单句、≤300 字符、不含「并且/同时/另外/还要/以及/分别/顺便」等并列词;不满足即被拒绝并给出拆分提示(DELEGATE_TASK_NOT_ATOMIC)。',
|
|
95
97
|
'3.0.0 角色与汇报(用户要求 7/8/9/10/11/12):部门组员角色已取消,只保留部门负责人与全球顶尖专家(role 只允许 expert);专家完成后必须以 JSON 汇报(证据块里的 report:keyResults/keyInfo/importantInfo/leadRequirements,精简、禁止重复,F10);部门负责人必须全面汇总本部门全部专家汇报后,以 JSON 交回主 Agent(departmentSummary:keyResults/keyInfo/importantInfo/sources,精简、禁止累赘重复,F11);等所有部门的汇总都交回后,由你再全面、深入整理汇总成最终成果交付给用户(用户要求 12)。',
|
|
96
|
-
'3.0
|
|
98
|
+
'3.1.0 版本(用户要求 13):本插件当前版本为 3.1.0。涉及版本号的对外表述一律写 3.1.0。',
|
|
97
99
|
/*
|
|
98
|
-
* [
|
|
99
|
-
*
|
|
100
|
-
*
|
|
100
|
+
* [3.0.8] 主 Agent 五步开工证据协议(取代 2.5.1 两轮深度思考,用户已批准):
|
|
101
|
+
* 部门三层执行者已有开工/结算双门禁,主 Agent 自己也必须做到同一协议——
|
|
102
|
+
* 提示词告知 + dispatch 硬门禁(validateStartPhaseEvidence)双保险,与部门层同一哲学。
|
|
101
103
|
*/
|
|
102
|
-
'主 Agent
|
|
104
|
+
'主 Agent 五步开工证据协议(3.0.8 强制,与部门负责人/顶尖专家同一口径):你执行自己的任务时,必须完成五步工作法的前三步——第一步全面、全盘、深入梳理、研究、思考自己的任务(目标与验收、现状与事实、约束、未知、主要矛盾、边界);第二步基于刚才第一步完成好的所有结果,再全面、全盘、深入地开展梳理、研究和思考,研究需要哪些资源、哪些工具、理清具体一步步以最高效率执行、确保完美完成自己任务的方法、流程和步骤(含全程如何少走弯路:先查历史教训、先验证再动手、不重复试错),并写清依据;第三步把资源与工具真正备齐并给出就绪证据。首次调用 dsh_workplan_dispatch 必须随附 startPhases={ planning{ problemAnalysis(第一步任务梳理), resources(第二步资源研究), tools(第二步工具研究), approach(第二步方法流程步骤), approachBasis(第二步基于第一步全部结果的依据对应) }, preparation{ prepared(第三步已备清单), evidence(第三步就绪证据) } },未提交或不合格会被平台硬门禁拒绝(START_EVIDENCE_MISSING / START_EVIDENCE_INCOMPLETE);登记后持久化,续跑/重试/重启回放自动读档,无需重复提交;重规划产生的新计划是新任务,必须重新完成前三步并提交。派发顺序、督战、验收与交付必须严格按第二步理清的方法、流程、步骤执行,不得静默改道。四角色执行前门禁现已全覆盖:主 Agent 经 dispatch 门禁、负责人经 delegate review 门禁、专家经 phase-0 self_effort+startPhases 门禁(START_EVIDENCE_MISSING / START_EVIDENCE_INCOMPLETE),未登记合格开工证据一律不进入正式执行。',
|
|
103
105
|
/*
|
|
104
106
|
* [2.3.10][T2] 用户要求1(P3)提示词双保险:插件已在规划前/派发前自动发送
|
|
105
107
|
* 【规划预告】/【派发预告】(runtime.ts maybePlan / dispatchTool);这里把
|
|
@@ -164,10 +166,10 @@ const PROMPT_SECTION = [
|
|
|
164
166
|
/*
|
|
165
167
|
* [2.0.0] 自我学习与自我迭代(用户 2026-11-05 强制要求)。
|
|
166
168
|
*
|
|
167
|
-
* 部门 Agent
|
|
169
|
+
* 部门 Agent 在第五步收尾必须复盘并落盘为永久记忆;这条提示词让主 Agent 知道
|
|
168
170
|
* 记忆存在、存在哪里、怎么复核,而不是把「会学习」当成不可见的口号。
|
|
169
171
|
*/
|
|
170
|
-
'
|
|
172
|
+
'每个部门完成工作后,必须在第五步收尾提交复盘(问题 / 弯路 / 解决 / 防再犯规则),插件会自动把它写入永久教训记忆文件(默认 ~/.dsh/workplan/lessons.jsonl,可用 DSH_WORKPLAN_LESSONS_FILE 覆盖);下次派发同类子任务时,相关历史教训会自动出现在子 Agent 提示词里。',
|
|
171
173
|
'需要复核「到底记住了什么、哪些错误在重复发生」时,调用 `dsh_workplan_lessons`(action: list / search / stats)。它是只读工具;记忆里反复出现的教训(occurrences ≥ 2)必须在下一次计划里变成明确约束,不能让同类错误第三次发生。',
|
|
172
174
|
].join('\n');
|
|
173
175
|
/**
|
|
@@ -744,7 +746,7 @@ function createEscalateTool(runtime) {
|
|
|
744
746
|
* 相关领域全球顶尖专家(部门组员角色已取消)。」
|
|
745
747
|
*
|
|
746
748
|
* 落地为两步硬流程(服务端校验,提示词绕不过):
|
|
747
|
-
* - `review
|
|
749
|
+
* - `review`:提交「开工证据 + 分工表」(startPhases 五步第 1/2/3 步 +
|
|
748
750
|
* 每位下级的 member/role/task/reasoningEffort);分工表必须同时含
|
|
749
751
|
* ≥1 名 expert(顶尖专家);部门组员角色已取消(3.0.0)。
|
|
750
752
|
* - `dispatch`:未登记 review 产物 ⇒ 硬门禁拒绝;登记后为每位下级派生
|
|
@@ -752,7 +754,8 @@ function createEscalateTool(runtime) {
|
|
|
752
754
|
* 当前模型家族合法集合(qwen→low/medium/xhigh;非qwen→low/high/max)
|
|
753
755
|
* 钳制并留痕,随 agentOptions 全程生效(要求 5)。
|
|
754
756
|
* - `direct`:[2.5.5][T3] low(含未配置视同 low)任务负责人亲自执行登记:
|
|
755
|
-
* 仅收
|
|
757
|
+
* 仅收 startPhases 开工证据(problemAnalysis/approach ≥40 字、approachBasis/
|
|
758
|
+
* resources/prepared/evidence ≥20 字、tools ≥10)+可选 reasoningEffort='low',
|
|
756
759
|
* 拒 consolidation/分工表与复杂档;登记后平台以 low 档接续本会话亲自执行
|
|
757
760
|
* (文档同步,门禁在 runtime/llm-rules)。
|
|
758
761
|
*
|
|
@@ -762,21 +765,21 @@ function createEscalateTool(runtime) {
|
|
|
762
765
|
function createDelegateTool(runtime) {
|
|
763
766
|
return {
|
|
764
767
|
name: 'dsh_workplan_delegate',
|
|
765
|
-
description: '部门负责人专用的第三层派发(用户要求 1/2/3
|
|
766
|
-
+ '
|
|
767
|
-
+ '
|
|
768
|
-
+ '先 action="review"
|
|
769
|
-
// [2.5.4][T4] D1/D2 人数口径同步(与 llm-rules.ts
|
|
770
|
-
+
|
|
768
|
+
description: '部门负责人专用的第三层派发(用户要求 1/2/3,3.0.8 五步工作法单框架):你拥有本部门内再分配权限。执行自己的任务必须先完成五步前三步:'
|
|
769
|
+
+ '第一步全面、全盘、深入梳理、研究、思考自己的任务;第二步基于第一步完成好的所有结果研究需要哪些资源、哪些工具、具体实施方案(方法、流程、步骤,含依据);'
|
|
770
|
+
+ '第三步把资源与工具真正备齐并给出就绪证据。'
|
|
771
|
+
+ '先 action="review" 提交第 1/2/3 步开工证据(startPhases)'
|
|
772
|
+
// [2.5.4][T4] D1/D2 人数口径同步(与 llm-rules.ts 负责人任务书同源逐字一致;3.1.0 上限 25)
|
|
773
|
+
+ `(planning{ problemAnalysis, resources, tools, approach, approachBasis } + preparation{ prepared, evidence },开工证据字数下限:${START_EVIDENCE_MIN_CHARS_BRIEF} + 分工表:每位下级的 member/role/task/reasoningEffort,至少 1 名 expert 顶尖专家(部门组员角色已按用户要求 9 取消);low/未配置任务禁止下派——负责人亲自执行,开工证据经 dsh_workplan_delegate(action="direct") 登记(${START_EVIDENCE_MIN_CHARS_BRIEF};可选 reasoningEffort="low");复杂任务(medium/high/xhigh/max)合计不少于 ${MIN_COMPLEX_DELEGATE_MEMBERS} 人且最多 ${MAX_COMPLEX_DELEGATE_MEMBERS} 人,少于 ${MIN_COMPLEX_DELEGATE_MEMBERS} 人硬性阻断;`
|
|
771
774
|
+ '并可用 consolidation.taskReasoningEffort 为整个任务配置整体推理等级,配置后本任务重试/续跑全程沿用;下级档位以成员 self_effort 自配为权威(分工表档仅建议)),'
|
|
772
775
|
+ '再 action="dispatch" 把任务派给本部门相关领域全球顶尖专家(部门组员角色已取消,只保留 expert;固定一层下级、叶子层,第四层一律被拒)。'
|
|
773
776
|
+ '分配必须更简单:每位专家只承担一个动作、一个主产物、一项可独立验收的工作(简单到像 1+1=2:单句、≤300 字符、不含并列词,且每条必须带至少 1 条 qualityRequirements 质量要求;不满足即拒绝派发)。'
|
|
774
777
|
+ 'review 未提交前 dispatch 被硬门禁拒绝。每位下级的推理等级必须按其任务复杂度配置'
|
|
775
778
|
+ '(轻度=low;qwen 中等=medium、非 qwen 中等=high;qwen 非常复杂=xhigh、非 qwen 非常复杂=max),'
|
|
776
779
|
+ '平台按当前模型家族合法集合自动钳制越界档并留痕,等级在其任务全生命周期生效。'
|
|
777
|
-
+ 'action="status"
|
|
778
|
-
+ '
|
|
779
|
-
+ '
|
|
780
|
+
+ 'action="status" 查看登记与下级进度。第三层专家叶子用 action="self_effort" 自配推理等级并提交五步第 1/2/3 步开工证据'
|
|
781
|
+
+ '(先配置+先研究准备后开工:phase-0 以 low 启动,唯一职责=评估自身任务复杂度并提交 reasoningEffort+complexityRationale+startPhases{planning,preparation}+开工前预估 timeNotice{declaredMinutes:正整数分钟,reason?};'
|
|
782
|
+
+ '缺交/不合格开工证据硬拒 START_EVIDENCE_MISSING/START_EVIDENCE_INCOMPLETE、不接续;齐全登记后平台立即以自配档接续同一任务进入 phase-1,正式执行必须按第二步方法流程步骤进行、全程少走弯路;成员自配为权威、分工表档仅建议)。'
|
|
780
783
|
+ '3.0.5 硬规则:任一第三层成员处于待指示(escalated)时,review/dispatch/direct 一律拒绝改派、重派或降级;负责人必须梳理该成员问题与本部门全部任务状态,研究方案后用 dsh_workplan_instruct 答复原成员,原成员继续执行。',
|
|
781
784
|
parameters: {
|
|
782
785
|
type: 'object',
|
|
@@ -784,7 +787,7 @@ function createDelegateTool(runtime) {
|
|
|
784
787
|
action: {
|
|
785
788
|
type: 'string',
|
|
786
789
|
enum: ['review', 'dispatch', 'direct', 'status', 'self_effort'],
|
|
787
|
-
description: 'review
|
|
790
|
+
description: 'review=提交开工证据与分工表(负责人):startPhases 五步第 1/2/3 步证据 + 每位下级的 member/role/task/reasoningEffort;dispatch=正式派发给专家(负责人);direct=low 任务负责人亲自执行登记(仅收 startPhases 开工证据,' + START_EVIDENCE_MIN_CHARS_BRIEF + '+可选 reasoningEffort=\'low\';拒 consolidation/分工表与复杂档,防旁路);status=查看登记与进度;self_effort=第三层专家叶子自配推理等级+提交开工证据 startPhases+开工前预估 timeNotice(先配置+先研究准备后开工,缺一硬拒不接续)。',
|
|
788
791
|
},
|
|
789
792
|
reasoningEffort: {
|
|
790
793
|
type: 'string',
|
|
@@ -795,15 +798,33 @@ function createDelegateTool(runtime) {
|
|
|
795
798
|
type: 'string',
|
|
796
799
|
description: 'action="self_effort" 必带(schema 层不强制,缺交将被运行时拒绝 SELF_EFFORT_RATIONALE_MISSING):复杂度依据(为什么你的单项任务是该档:事实/依赖/验证难度)。',
|
|
797
800
|
},
|
|
798
|
-
|
|
801
|
+
startPhases: {
|
|
799
802
|
type: 'object',
|
|
800
|
-
description: 'action="self_effort"
|
|
803
|
+
description: 'action="self_effort" / "review" / "direct" 必填(3.0.8 开工证据硬门禁):五步工作法前三步证据——第一步全面、全盘、深入梳理、研究、思考自己的任务;第二步基于第一步完成好的所有结果再全面、全盘、深入地开展梳理、研究和思考,研究需要哪些资源、哪些工具、具体实施方案(方法、流程、步骤,含依据);第三步把资源与工具真正备齐并给出就绪证据。缺交/不合格硬拒(START_EVIDENCE_MISSING / START_EVIDENCE_INCOMPLETE),不登记、不接续正式执行;登记后持久化,重派/续跑读档放行。',
|
|
801
804
|
properties: {
|
|
802
|
-
|
|
803
|
-
|
|
804
|
-
|
|
805
|
+
planning: {
|
|
806
|
+
type: 'object',
|
|
807
|
+
properties: {
|
|
808
|
+
problemAnalysis: { type: 'array', items: { type: 'string' }, description: '第一步 · 任务梳理:全面、全盘、深入梳理、研究、思考自己的任务(目标与验收/现状/事实/约束/未知/主要矛盾/边界),至少 1 条、合计 ≥40 字。' },
|
|
809
|
+
resources: { type: 'array', items: { type: 'string' }, description: '第二步 · 资源研究:基于第一步全部结果,研究需要哪些资源(数据/文件/权限/人/知识/时间),至少 1 项、合计 ≥20 字。' },
|
|
810
|
+
tools: { type: 'array', items: { type: 'string' }, description: '第二步 · 工具研究:需要哪些工具、每个工具用来做什么,至少 1 项、合计 ≥10 字。' },
|
|
811
|
+
approach: { type: 'array', items: { type: 'string' }, description: '第二步 · 方法流程步骤:理清如何一步步以最高效率、少走弯路、完美完成任务的方法、流程和步骤,至少 1 条、合计 ≥40 字。' },
|
|
812
|
+
approachBasis: { type: 'array', items: { type: 'string' }, description: '第二步依据:如何基于第一步完成好的所有结果(逐条对应),至少 1 条、合计 ≥20 字。' },
|
|
813
|
+
},
|
|
814
|
+
required: ['problemAnalysis', 'approach', 'approachBasis', 'resources', 'tools'],
|
|
815
|
+
additionalProperties: false,
|
|
816
|
+
},
|
|
817
|
+
preparation: {
|
|
818
|
+
type: 'object',
|
|
819
|
+
properties: {
|
|
820
|
+
prepared: { type: 'array', items: { type: 'string' }, description: '第三步 · 已备齐的资源与工具清单(每项写清:准备了什么、在哪里、是否可用),至少 1 项、合计 ≥20 字。' },
|
|
821
|
+
evidence: { type: 'array', items: { type: 'string' }, description: '第三步 · 就绪证据:命令输出/文件路径/配置项/版本号/引用,至少 1 条、合计 ≥20 字。' },
|
|
822
|
+
},
|
|
823
|
+
required: ['prepared', 'evidence'],
|
|
824
|
+
additionalProperties: false,
|
|
825
|
+
},
|
|
805
826
|
},
|
|
806
|
-
required: ['
|
|
827
|
+
required: ['planning', 'preparation'],
|
|
807
828
|
additionalProperties: false,
|
|
808
829
|
},
|
|
809
830
|
timeNotice: {
|
|
@@ -818,17 +839,8 @@ function createDelegateTool(runtime) {
|
|
|
818
839
|
},
|
|
819
840
|
consolidation: {
|
|
820
841
|
type: 'object',
|
|
821
|
-
description: 'action="review" 必带(schema 层不强制,缺交将被运行时拒绝 DELEGATE_CONSOLIDATION_MISSING / DELEGATE_CONSOLIDATION_INCOMPLETE
|
|
842
|
+
description: 'action="review" 必带(schema 层不强制,缺交将被运行时拒绝 DELEGATE_CONSOLIDATION_MISSING / DELEGATE_CONSOLIDATION_INCOMPLETE):第三层分工表(3.0.8 起不再内嵌开工证据——开工证据一律经 startPhases 提交登记)。负责人自己的第 1/2/3 步开工证据未登记前 dispatch 被硬门禁拒绝。action="direct" 禁止携带(direct 不接受分工表)。',
|
|
822
843
|
properties: {
|
|
823
|
-
problemAnalysis: {
|
|
824
|
-
type: 'array',
|
|
825
|
-
items: { type: 'string' },
|
|
826
|
-
description: '第一轮 · 任务深研:全面、全盘、深入梳理、研究、思考自己的任务(目标与验收/现状/事实/约束/未知/主要矛盾/边界逐条写清),至少 1 条。',
|
|
827
|
-
},
|
|
828
|
-
constraints: { type: 'array', items: { type: 'string' }, description: '约束条件。' },
|
|
829
|
-
unknowns: { type: 'array', items: { type: 'string' }, description: '未知或待确认项。' },
|
|
830
|
-
approach: { type: 'array', items: { type: 'string' }, description: '第二轮 · 方法流程步骤:基于第一轮全部结果,再全面、全盘、深入梳理、研究、思考后理清的具体一步步执行、完美完成任务的方法、流程和步骤(每步做什么、产出什么、如何证明),至少 1 条。' },
|
|
831
|
-
approachBasis: { type: 'array', items: { type: 'string' }, description: '第二轮依据(必填,至少 1 条):第二轮如何基于第一轮完成好的所有结果——逐条写清第一轮的哪些事实/约束/矛盾决定了第二轮的哪些方法/流程/步骤。' },
|
|
832
844
|
taskReasoningEffort: {
|
|
833
845
|
type: 'string',
|
|
834
846
|
enum: ['low', 'medium', 'high', 'xhigh', 'max'],
|
|
@@ -836,8 +848,8 @@ function createDelegateTool(runtime) {
|
|
|
836
848
|
},
|
|
837
849
|
assignments: {
|
|
838
850
|
type: 'array',
|
|
839
|
-
// [3.0.0] 用户 2026-11-14 第 5/6/9
|
|
840
|
-
description:
|
|
851
|
+
// [3.0.0] 用户 2026-11-14 第 5/6/9 条:组员角色取消、任务极简、质量要求必填;3.1.0 上限随 caps.ts。
|
|
852
|
+
description: `分工表:至少 1 名 expert(本部门相关领域全球顶尖专家;部门组员角色已按用户要求 9 取消,role 只允许 expert);low/未配置任务禁止下派——负责人亲自执行,开工证据经 dsh_workplan_delegate(action="direct") 登记(${START_EVIDENCE_MIN_CHARS_BRIEF};可选 reasoningEffort="low");复杂任务(medium/high/xhigh/max)合计不少于 ${MIN_COMPLEX_DELEGATE_MEMBERS} 人且最多 ${MAX_COMPLEX_DELEGATE_MEMBERS} 人,少于 ${MIN_COMPLEX_DELEGATE_MEMBERS} 人硬性阻断,超过上限平台拒收(可精简名单或拆两轮派发,绝不静默丢人无痕)。每一条任务必须简单到像 1+1=2:一个动作、一个主产物、一项可独立验收(≤300 字符、单句、不含并列词),且必须带 qualityRequirements(至少 1 条可检查的质量要求);不满足即拒绝派发。`,
|
|
841
853
|
items: {
|
|
842
854
|
type: 'object',
|
|
843
855
|
properties: {
|
|
@@ -860,7 +872,7 @@ function createDelegateTool(runtime) {
|
|
|
860
872
|
},
|
|
861
873
|
},
|
|
862
874
|
},
|
|
863
|
-
required: ['
|
|
875
|
+
required: ['assignments'],
|
|
864
876
|
additionalProperties: false,
|
|
865
877
|
},
|
|
866
878
|
},
|
|
@@ -918,12 +930,13 @@ function createDelegateTool(runtime) {
|
|
|
918
930
|
};
|
|
919
931
|
}
|
|
920
932
|
/**
|
|
921
|
-
* [1.13.0]
|
|
933
|
+
* [1.13.0→3.0.8] 第四步(验证阶段)的插件核验工具(用户 2026-11-05;五步口径)。
|
|
922
934
|
*
|
|
923
|
-
*
|
|
924
|
-
*
|
|
925
|
-
*
|
|
926
|
-
*
|
|
935
|
+
* 五步工作法要求部门 Agent 先梳理问题(第一步)、再研究资源/工具/方案(第二步)、
|
|
936
|
+
* 再备齐就绪(第三步)、执行并逐项验证(第四步)、最后收尾与复盘(第五步)。
|
|
937
|
+
* 这个工具只做一件事:接收五步证据并给出核验结论。缺少 planning/preparation
|
|
938
|
+
* /execution 证据时会被 `runtime.verifySubtask` 以 `PHASE_GATE` 拒绝并列出待补项,
|
|
939
|
+
* 避免跳过前三步直接宣称验证通过。
|
|
927
940
|
*
|
|
928
941
|
* 注意(2.0.2 更正):2026-11-05 的「第一、二阶段禁用 dsh-workplan 插件」是
|
|
929
942
|
* 该次优化会话的过程约束,不是对所有后续会话的产品规则;插件不全局禁用。
|
|
@@ -931,10 +944,10 @@ function createDelegateTool(runtime) {
|
|
|
931
944
|
export function createVerifyTool(runtime) {
|
|
932
945
|
return {
|
|
933
946
|
name: 'dsh_workplan_verify',
|
|
934
|
-
description: '部门子 Agent
|
|
935
|
-
+ '插件逐项核验并返回 passed 或仍需补齐的 gaps。缺少 planning / execution 证据时返回 PHASE_GATE 与待补项;'
|
|
936
|
-
+ '
|
|
937
|
-
+ '核验通过不代表完成:最终仍要在结果块里写同一份 phases
|
|
947
|
+
description: '部门子 Agent 在第四步(验证阶段)使用的插件核验:提交 planning / preparation / execution / verification 五步证据,'
|
|
948
|
+
+ '插件逐项核验并返回 passed 或仍需补齐的 gaps。缺少 planning / preparation / execution 证据时返回 PHASE_GATE 与待补项;'
|
|
949
|
+
+ '只有「前三步开工证据(第一步任务梳理 + 第二步资源/工具/方案研究 + 第三步准备就绪)+ 实际执行步骤」齐全后,才会进入第四步核验。'
|
|
950
|
+
+ '核验通过不代表完成:最终仍要在结果块里写同一份 phases,由主计划按五步契约判定。',
|
|
938
951
|
parameters: {
|
|
939
952
|
type: 'object',
|
|
940
953
|
properties: {
|
|
@@ -948,12 +961,12 @@ export function createVerifyTool(runtime) {
|
|
|
948
961
|
properties: {
|
|
949
962
|
planning: {
|
|
950
963
|
type: 'object',
|
|
951
|
-
description: '
|
|
964
|
+
description: '第一步 + 第二步:全面、全盘、深入梳理、研究、思考自己的任务(问题梳理),再基于第一步全部结果研究资源、工具与实施方案(方法、流程、步骤,含依据)。',
|
|
952
965
|
properties: {
|
|
953
|
-
problemAnalysis: { type: 'array', items: { type: 'string' }, description: '
|
|
966
|
+
problemAnalysis: { type: 'array', items: { type: 'string' }, description: '第一步 · 任务梳理:全面、全盘、深入梳理、研究、思考自己的任务(目标与验收/现状/事实/约束/未知/主要矛盾/边界)' },
|
|
954
967
|
constraints: { type: 'array', items: { type: 'string' }, description: '约束条件' },
|
|
955
968
|
unknowns: { type: 'array', items: { type: 'string' }, description: '未知或待确认项' },
|
|
956
|
-
approach: { type: 'array', items: { type: 'string' }, description: '
|
|
969
|
+
approach: { type: 'array', items: { type: 'string' }, description: '第二步 · 方法流程步骤:基于第一步全部结果理清的具体一步步执行、完美完成任务的方法、流程和步骤(每一步做什么、产出什么、如何证明)' },
|
|
957
970
|
approachBasis: { type: 'array', items: { type: 'string' }, description: '第二步依据(必填):第二步的资源、工具、方案如何基于第一步完成好的所有结果——第一步的哪些事实/约束/矛盾决定了第二步的哪些资源/工具/步骤' },
|
|
958
971
|
resources: { type: 'array', items: { type: 'string' }, description: '第二步 · 资源研究:完成本任务需要哪些资源(数据/文件/权限/人/知识/时间),逐项写清用途与获取方式' },
|
|
959
972
|
tools: { type: 'array', items: { type: 'string' }, description: '第二步 · 工具研究:需要哪些工具、每个工具用来做什么、为什么选它' },
|
|
@@ -996,7 +1009,7 @@ export function createVerifyTool(runtime) {
|
|
|
996
1009
|
requirementCheck: { type: 'string', description: '逐条核对用户原要求的结果' },
|
|
997
1010
|
retrospective: {
|
|
998
1011
|
type: 'object',
|
|
999
|
-
description: '
|
|
1012
|
+
description: '第四步收尾的自我学习复盘:本次遇到的问题、走过的弯路、如何解决、以后如何预防再犯',
|
|
1000
1013
|
properties: {
|
|
1001
1014
|
problems: { type: 'array', items: { type: 'string' }, description: '本次全过程遇到的问题(现象 + 根因),至少 1 条' },
|
|
1002
1015
|
detours: { type: 'array', items: { type: 'string' }, description: '走过的弯路/返工/无效尝试;确实没有就写空数组' },
|
|
@@ -1041,7 +1054,7 @@ export function createVerifyTool(runtime) {
|
|
|
1041
1054
|
+ (gaps ? `|需补齐:${gaps}` : '')
|
|
1042
1055
|
+ '|先修复再回报,不要用 done 收尾。');
|
|
1043
1056
|
}
|
|
1044
|
-
return textContent(`${String(result.subtaskId ?? '')}
|
|
1057
|
+
return textContent(`${String(result.subtaskId ?? '')} 第四步核验通过:${String(result.summary ?? '')}`
|
|
1045
1058
|
+ '|把同一份 phases 写进结果块后提交。');
|
|
1046
1059
|
},
|
|
1047
1060
|
},
|
|
@@ -1054,7 +1067,7 @@ export function createVerifyTool(runtime) {
|
|
|
1054
1067
|
/**
|
|
1055
1068
|
* [2.0.0] 永久教训记忆的只读入口(用户 2026-11-05 自我学习要求)。
|
|
1056
1069
|
*
|
|
1057
|
-
*
|
|
1070
|
+
* 不提供写动作:记忆只能由「第四步复盘通过 → 完成判定」这条链写入,
|
|
1058
1071
|
* 防止主 Agent 事后手写一条“教训”绕过真实复盘证据。
|
|
1059
1072
|
*/
|
|
1060
1073
|
function createLessonsTool(runtime) {
|
|
@@ -1062,7 +1075,7 @@ function createLessonsTool(runtime) {
|
|
|
1062
1075
|
name: 'dsh_workplan_lessons',
|
|
1063
1076
|
description: '查看 dsh-workplan 的永久教训记忆(部门完成工作后自动落盘的复盘):'
|
|
1064
1077
|
+ 'action=list 按部门取最相关教训,action=search 按关键词检索,action=stats 看总数/重复数与文件位置。'
|
|
1065
|
-
+ '
|
|
1078
|
+
+ '只读,不修改计划状态;第四步验证时用它核对记住了什么、哪些同类错误在重复出现。',
|
|
1066
1079
|
parameters: {
|
|
1067
1080
|
type: 'object',
|
|
1068
1081
|
properties: {
|
|
@@ -1263,8 +1276,8 @@ function createReleaseTool(runtime) {
|
|
|
1263
1276
|
return {
|
|
1264
1277
|
name: 'dsh_workplan_release',
|
|
1265
1278
|
description: '解除当前会话计划的「认可闸门」并立即派发:先登记用户认可的留痕(gateHistory,durable 回放不丢),'
|
|
1266
|
-
+ '再调用派发链(与 dsh_workplan_dispatch 同一套闸门:终态/
|
|
1267
|
-
+ '仅当计划处于认可闸门之下时可用;若派发因
|
|
1279
|
+
+ '再调用派发链(与 dsh_workplan_dispatch 同一套闸门:终态/startPhases 等照常生效)。'
|
|
1280
|
+
+ '仅当计划处于认可闸门之下时可用;若派发因 startPhases 等门禁被拒,闸门保持已解除,'
|
|
1268
1281
|
+ '补齐后直接重发 dispatch 即可,认可事实无需重来。仅根会话可用。',
|
|
1269
1282
|
parameters: {
|
|
1270
1283
|
type: 'object',
|
|
@@ -1277,15 +1290,31 @@ function createReleaseTool(runtime) {
|
|
|
1277
1290
|
type: 'string',
|
|
1278
1291
|
description: '用户认可的留痕备注(例如认可的原文摘要),写入 gateHistory。',
|
|
1279
1292
|
},
|
|
1280
|
-
|
|
1293
|
+
startPhases: {
|
|
1281
1294
|
type: 'object',
|
|
1282
|
-
description: '可选:随解除一并提交的主 Agent
|
|
1295
|
+
description: '可选:随解除一并提交的主 Agent 五步第 1/2/3 步开工证据(与 dsh_workplan_dispatch.startPhases 同形状);提供则解除后立即开跑,缺省则派发按 START_EVIDENCE_MISSING 门禁返回补交指引。',
|
|
1283
1296
|
properties: {
|
|
1284
|
-
|
|
1285
|
-
|
|
1286
|
-
|
|
1297
|
+
planning: {
|
|
1298
|
+
type: 'object',
|
|
1299
|
+
properties: {
|
|
1300
|
+
problemAnalysis: { type: 'array', items: { type: 'string' } },
|
|
1301
|
+
resources: { type: 'array', items: { type: 'string' } },
|
|
1302
|
+
tools: { type: 'array', items: { type: 'string' } },
|
|
1303
|
+
approach: { type: 'array', items: { type: 'string' } },
|
|
1304
|
+
approachBasis: { type: 'array', items: { type: 'string' } },
|
|
1305
|
+
},
|
|
1306
|
+
required: ['problemAnalysis', 'approach', 'approachBasis', 'resources', 'tools'],
|
|
1307
|
+
},
|
|
1308
|
+
preparation: {
|
|
1309
|
+
type: 'object',
|
|
1310
|
+
properties: {
|
|
1311
|
+
prepared: { type: 'array', items: { type: 'string' } },
|
|
1312
|
+
evidence: { type: 'array', items: { type: 'string' } },
|
|
1313
|
+
},
|
|
1314
|
+
required: ['prepared', 'evidence'],
|
|
1315
|
+
},
|
|
1287
1316
|
},
|
|
1288
|
-
required: ['
|
|
1317
|
+
required: ['planning', 'preparation'],
|
|
1289
1318
|
},
|
|
1290
1319
|
mode: {
|
|
1291
1320
|
type: 'string',
|
|
@@ -1299,7 +1328,7 @@ function createReleaseTool(runtime) {
|
|
|
1299
1328
|
* 为 tools.register() 强制项。schema 覆盖 runtime.releaseTool 的全部返回形
|
|
1300
1329
|
* (ok/gateReleased/planId/note/hold/dispatch/code/error;dispatch 为 dispatchTool
|
|
1301
1330
|
* 的完整结果对象,保持开放对象不裁剪)。render 语义修正:判定「未能解除」
|
|
1302
|
-
* 以 gateReleased 为准——原实现只看 ok===false,会把「闸门已解除但
|
|
1331
|
+
* 以 gateReleased 为准——原实现只看 ok===false,会把「闸门已解除但 startPhases
|
|
1303
1332
|
* 门禁拒派发」误报成未解除(该分支 ok 恰为 false 但闸门已松)。
|
|
1304
1333
|
*/
|
|
1305
1334
|
output: {
|
|
@@ -1519,10 +1548,10 @@ function createDispatchTool(runtime) {
|
|
|
1519
1548
|
name: 'dsh_workplan_dispatch',
|
|
1520
1549
|
description: '派发当前会话尚未执行的任务分解计划。计划显示后必须先调用本工具;wait 会等到本轮结束,'
|
|
1521
1550
|
+ '把 durable 结果写入会话并返回每个子任务的状态/摘要。'
|
|
1522
|
-
+ '【
|
|
1523
|
-
+ '
|
|
1524
|
-
+ '
|
|
1525
|
-
+ '(
|
|
1551
|
+
+ '【3.0.8 主 Agent 五步开工证据协议】执行自己的任务必须先完成前三步:全面、全盘、深入梳理、研究、思考自己的任务(第一步任务梳理),'
|
|
1552
|
+
+ '基于第一步完成好的所有结果再全面、全盘、深入地开展梳理、研究和思考,研究需要哪些资源、哪些工具、理清具体一步步以最高效率、少走弯路、完美完成任务的方法、流程和步骤(第二步资源/工具/方案研究,含依据),'
|
|
1553
|
+
+ '再把资源与工具真正备齐并给出就绪证据(第三步准备就绪);最后才基于第二步的方法、流程、步骤开始执行:首次派发必须随附 startPhases 开工证据,未提交或不合格被硬门禁拒绝'
|
|
1554
|
+
+ '(START_EVIDENCE_MISSING / START_EVIDENCE_INCOMPLETE);登记后持久化,续跑/重试/重启回放自动读档,无需重复提交;重规划的新计划须重新提交。'
|
|
1526
1555
|
+ '返回值里的 complete=false 表示计划还没做完(可能只是本轮预算用尽),此时必须再次派发续跑,'
|
|
1527
1556
|
+ '不得把当前产物当作最终结果。重复调用是幂等的。',
|
|
1528
1557
|
parameters: {
|
|
@@ -1538,15 +1567,33 @@ function createDispatchTool(runtime) {
|
|
|
1538
1567
|
description: '默认 wait:等本轮结束后返回完整结果。async:立即返回 running,'
|
|
1539
1568
|
+ '本轮结束时自动写入结果消息;期间用 dsh_workplan_status 查看进度。',
|
|
1540
1569
|
},
|
|
1541
|
-
|
|
1570
|
+
startPhases: {
|
|
1542
1571
|
type: 'object',
|
|
1543
|
-
description: '主 Agent
|
|
1572
|
+
description: '主 Agent 五步第 1/2/3 步开工证据(本计划首次派发必填;已登记后续跑/重启自动读档):第一步全面、全盘、深入梳理、研究、思考自己的任务;第二步基于第一步完成好的所有结果再全面、全盘、深入地开展梳理、研究和思考,研究需要哪些资源、哪些工具、理清具体一步步执行、完美完成任务的方法、流程和步骤,并写清第二步基于第一步全部结果的依据;第三步把资源与工具真正备齐并给出就绪证据。派发顺序、督战、验收与交付必须按第二步理清的方法、流程、步骤执行。',
|
|
1544
1573
|
properties: {
|
|
1545
|
-
|
|
1546
|
-
|
|
1547
|
-
|
|
1574
|
+
planning: {
|
|
1575
|
+
type: 'object',
|
|
1576
|
+
properties: {
|
|
1577
|
+
problemAnalysis: { type: 'array', items: { type: 'string' }, description: '第一步 · 任务梳理:全面、全盘、深入梳理、研究、思考自己的任务(目标与验收/现状/事实/约束/未知/主要矛盾/边界逐条写清),至少 1 条、合计 ≥40 字。' },
|
|
1578
|
+
resources: { type: 'array', items: { type: 'string' }, description: '第二步 · 资源研究:基于第一步全部结果,研究需要哪些资源(数据/文件/权限/人/知识/时间),至少 1 项、合计 ≥20 字。' },
|
|
1579
|
+
tools: { type: 'array', items: { type: 'string' }, description: '第二步 · 工具研究:需要哪些工具、每个工具用来做什么,至少 1 项、合计 ≥10 字。' },
|
|
1580
|
+
approach: { type: 'array', items: { type: 'string' }, description: '第二步 · 方法流程步骤:理清的具体一步步执行、完美完成任务的方法、流程和步骤(派发顺序/督战/验收/交付如何做、如何证明),至少 1 条、合计 ≥40 字。' },
|
|
1581
|
+
approachBasis: { type: 'array', items: { type: 'string' }, description: '第二步依据(必填):第二步如何基于第一步完成好的所有结果——第一步的哪些事实/约束/矛盾决定了第二步的哪些资源/工具/步骤,至少 1 条、合计 ≥20 字。' },
|
|
1582
|
+
},
|
|
1583
|
+
required: ['problemAnalysis', 'approach', 'approachBasis', 'resources', 'tools'],
|
|
1584
|
+
additionalProperties: false,
|
|
1585
|
+
},
|
|
1586
|
+
preparation: {
|
|
1587
|
+
type: 'object',
|
|
1588
|
+
properties: {
|
|
1589
|
+
prepared: { type: 'array', items: { type: 'string' }, description: '第三步 · 已备齐的资源与工具清单(每项写清:准备了什么、在哪里、是否可用),至少 1 项、合计 ≥20 字。' },
|
|
1590
|
+
evidence: { type: 'array', items: { type: 'string' }, description: '第三步 · 就绪证据:命令输出/文件路径/配置项/版本号/引用,至少 1 条、合计 ≥20 字。' },
|
|
1591
|
+
},
|
|
1592
|
+
required: ['prepared', 'evidence'],
|
|
1593
|
+
additionalProperties: false,
|
|
1594
|
+
},
|
|
1548
1595
|
},
|
|
1549
|
-
required: ['
|
|
1596
|
+
required: ['planning', 'preparation'],
|
|
1550
1597
|
additionalProperties: false,
|
|
1551
1598
|
},
|
|
1552
1599
|
},
|
|
@@ -1819,9 +1866,9 @@ export function apply(ctx, config = {}) {
|
|
|
1819
1866
|
* 计划内某行的部门负责人子会话」硬校验;根会话与第三层叶子会话都会被拒。
|
|
1820
1867
|
*/
|
|
1821
1868
|
ctx.effect(() => ctx.tools.register(createDelegateTool(runtime)));
|
|
1822
|
-
/* [1.13.0]
|
|
1869
|
+
/* [1.13.0→3.0.8] 第四步核验:子会话唯一可用的插件工作能力,前三步会被 PHASE_GATE 拒绝。 */
|
|
1823
1870
|
ctx.effect(() => ctx.tools.register(createVerifyTool(runtime)));
|
|
1824
|
-
/* [2.0.0]
|
|
1871
|
+
/* [2.0.0] 永久教训记忆的只读复核入口(第四步验证用)。 */
|
|
1825
1872
|
ctx.effect(() => ctx.tools.register(createLessonsTool(runtime)));
|
|
1826
1873
|
ctx.effect(() => ctx.tools.register(createInstructTool(runtime)));
|
|
1827
1874
|
/*
|
|
@@ -1925,7 +1972,7 @@ export function apply(ctx, config = {}) {
|
|
|
1925
1972
|
}
|
|
1926
1973
|
export const meta = {
|
|
1927
1974
|
name,
|
|
1928
|
-
version: '3.0
|
|
1975
|
+
version: '3.1.0',
|
|
1929
1976
|
promptOrder: PROMPT_ORDER,
|
|
1930
1977
|
routes: ['/dsh-workplan/plans', '/dsh-workplan/vendor/chart.umd.js'],
|
|
1931
1978
|
};
|
package/lib/lessons.js
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. 防再犯:每次派发子任务前,按部门/关键词/时间/重复次数排序,把最相关的
|
|
@@ -56,7 +56,7 @@ function totalChars(items) {
|
|
|
56
56
|
return items.reduce((sum, item) => sum + item.length, 0);
|
|
57
57
|
}
|
|
58
58
|
/**
|
|
59
|
-
* 复盘证据的**唯一**校验入口:
|
|
59
|
+
* 复盘证据的**唯一**校验入口:five-step.ts 与运行时都调它,保证
|
|
60
60
|
* 「提示词要求什么」和「完成判定检查什么」是同一份契约。
|
|
61
61
|
*/
|
|
62
62
|
export function validateRetrospective(value) {
|
|
@@ -66,7 +66,7 @@ export function validateRetrospective(value) {
|
|
|
66
66
|
return {
|
|
67
67
|
ok: false,
|
|
68
68
|
retrospective: empty,
|
|
69
|
-
errors: ['phases.verification.retrospective
|
|
69
|
+
errors: ['phases.verification.retrospective 缺失:第四步收尾必须复盘「问题 / 弯路 / 解决 / 预防」四项'],
|
|
70
70
|
};
|
|
71
71
|
}
|
|
72
72
|
const problems = readList(value.problems);
|