@godv61/dsh-task-engine 0.25.0 → 0.26.1

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.
Files changed (58) hide show
  1. package/.acceptance.mjs +150 -150
  2. package/.assessment-batch1.mjs +20 -20
  3. package/.enforce-test.mjs +138 -138
  4. package/.evidence-test.mjs +118 -119
  5. package/.filter-test.mjs +92 -92
  6. package/.hook-test.mjs +195 -195
  7. package/.p0-test.mjs +59 -59
  8. package/.preset-test.mjs +160 -160
  9. package/.revision-test.mjs +30 -16
  10. package/.roundtrip-test.mjs +178 -63
  11. package/.workflow-test.mjs +86 -0
  12. package/README.md +8 -8
  13. package/cordis.patch.yml +10 -10
  14. package/defaults/eng.json +70 -22
  15. package/docs/BRIEF-FOR-REVIEW.md +162 -162
  16. package/docs/CHANGELOG.md +18 -0
  17. package/docs/README.md +40 -40
  18. package/docs/configuration.md +14 -9
  19. package/docs/development.md +1 -1
  20. package/docs/faq.md +4 -4
  21. package/docs/listing/godv61__dsh-task-engine.yml +5 -5
  22. package/docs/listing/submission.md +83 -83
  23. package/docs/manual.html +32 -27
  24. package/docs/releases/0.23.2.md +21 -21
  25. package/docs/roadmap.md +34 -34
  26. package/docs/testing/0.23.2/R02/344/270/232/345/212/241/346/265/213/350/257/225/346/230/216/347/273/206.md +56 -56
  27. package/docs/testing/0.23.2/R03/344/270/232/345/212/241/346/265/213/350/257/225/346/230/216/347/273/206.md +38 -38
  28. package/docs/testing/0.23.2//346/265/213/350/257/225/346/212/245/345/221/212.md +65 -65
  29. package/hooks/commit-msg +70 -1
  30. package/lib/client.js +870 -571
  31. package/lib/client.js.map +3 -3
  32. package/lib/controller.d.ts +2 -1
  33. package/lib/controller.js +6 -3
  34. package/lib/controller.js.map +1 -1
  35. package/lib/dev-task.js +83 -15
  36. package/lib/dev-task.js.map +1 -1
  37. package/lib/engine.d.ts +15 -0
  38. package/lib/engine.js +29 -5
  39. package/lib/engine.js.map +1 -1
  40. package/lib/hook.js +3 -0
  41. package/lib/hook.js.map +1 -1
  42. package/lib/skill-audit.js +3 -3
  43. package/lib/skill-audit.js.map +1 -1
  44. package/lib/workflows.d.ts +4 -1
  45. package/lib/workflows.js +90 -2
  46. package/lib/workflows.js.map +1 -1
  47. package/package.json +1 -1
  48. package/preset/agent.cordis.yml +22 -22
  49. package/preset/enable.mjs +87 -87
  50. package/preset/persona.md +5 -5
  51. package/preset/preset.yml +1 -1
  52. package/rules/coding-conventions.md +6 -6
  53. package/rules/commit-conventions.md +6 -6
  54. package/rules/security-redlines.md +5 -5
  55. package/scripts/verify-dsh-compat.mjs +144 -144
  56. package/skills/code-implement/SKILL.md +1 -1
  57. package/skills/code-verify/SKILL.md +3 -3
  58. package/skills/eng-delivery/SKILL.md +10 -31
package/docs/README.md CHANGED
@@ -1,41 +1,41 @@
1
- # 使用文档
2
-
3
- [← 返回项目首页](../README.md)
4
-
5
- DSH Task Engine 是 DeepSeek Harness 的个人工程流程工作台。先完成安装,再按需要配置流程、技能和规则。
6
-
7
- ## 开始使用
8
-
9
- | 文档 | 内容 |
10
- | :--- | :--- |
11
- | [安装与启用](getting-started.md) | 安装到 Web profile、启用工程会话、确认安装结果。 |
12
- | [流程配置](configuration.md) | 三个内置流程、阶段绑定、配置文件与任务快照。 |
13
- | [技能与规则安装](resource-install.md) | 系统文件选择、安装预览、项目/个人范围和格式要求。 |
14
- | [常见问题](faq.md) | 预设区别、资源使用、项目目录与能力限制。 |
15
- | [完整 HTML 手册](manual.html) | 详细操作、工具说明与任务走查;下载后在浏览器中打开。 |
16
-
17
- ## 参与开发
18
-
19
- | 文档 | 内容 |
20
- | :--- | :--- |
21
- | [开发指南](development.md) | 构建、测试、包结构与可选 host 接入。 |
22
- | [功能规划](roadmap.md) | 已发布能力与规划中的范围。 |
23
- | [更新日志](CHANGELOG.md) | 按版本查阅变化;**这是版本信息的唯一权威来源**。 |
24
- | [插件收录材料](listing/submission.md) | Awesome DSH Plugin 的提交条件、条目内容与收录结果。 |
25
-
26
- ## 历史记录
27
-
28
- 以下文档是**各自版本当时的快照**,用于追溯当时的验证范围与已知边界。其中的测试数量、
29
- 实现细节和界面描述可能已被后续版本替代——当前行为以「开始使用」和[更新日志](CHANGELOG.md)为准。
30
-
31
- | 文档 | 内容 |
32
- | :--- | :--- |
33
- | [0.23.2 验证记录](testing/0.23.2/测试报告.md) | 两轮完整开发、归档回退与门禁专项的实际结果。 |
34
- | [0.23.2 发布说明](releases/0.23.2.md) | 验证命令单次审批修复、提交指引与管控边界。 |
35
- | [0.23.1 验证记录](testing/0.23.1/测试报告.md) | 自动化、安装包与实机证据的适用范围。 |
36
- | [0.23.1 发布说明](releases/0.23.1.md) | 真实项目发现的问题、修复及能力边界。 |
37
- | [0.23.1 回归迭代说明](workflow-regression.md) | 真实项目逐轮问题的处理记录。 |
38
- | [0.23.0 验证记录](testing/0.23.0/测试报告.md) | 资源导入、工作台交互与包入口的验证。 |
39
- | [0.23.0 发布说明](releases/0.23.0.md) | 早期安装交互及界面调整。 |
40
-
1
+ # 使用文档
2
+
3
+ [← 返回项目首页](../README.md)
4
+
5
+ DSH Task Engine 是 DeepSeek Harness 的个人工程流程工作台。先完成安装,再按需要配置流程、技能和规则。
6
+
7
+ ## 开始使用
8
+
9
+ | 文档 | 内容 |
10
+ | :--- | :--- |
11
+ | [安装与启用](getting-started.md) | 安装到 Web profile、启用工程会话、确认安装结果。 |
12
+ | [流程配置](configuration.md) | 三个内置流程、阶段绑定、配置文件与任务快照。 |
13
+ | [技能与规则安装](resource-install.md) | 系统文件选择、安装预览、项目/个人范围和格式要求。 |
14
+ | [常见问题](faq.md) | 预设区别、资源使用、项目目录与能力限制。 |
15
+ | [完整 HTML 手册](manual.html) | 详细操作、工具说明与任务走查;下载后在浏览器中打开。 |
16
+
17
+ ## 参与开发
18
+
19
+ | 文档 | 内容 |
20
+ | :--- | :--- |
21
+ | [开发指南](development.md) | 构建、测试、包结构与可选 host 接入。 |
22
+ | [功能规划](roadmap.md) | 已发布能力与规划中的范围。 |
23
+ | [更新日志](CHANGELOG.md) | 按版本查阅变化;**这是版本信息的唯一权威来源**。 |
24
+ | [插件收录材料](listing/submission.md) | Awesome DSH Plugin 的提交条件、条目内容与收录结果。 |
25
+
26
+ ## 历史记录
27
+
28
+ 以下文档是**各自版本当时的快照**,用于追溯当时的验证范围与已知边界。其中的测试数量、
29
+ 实现细节和界面描述可能已被后续版本替代——当前行为以「开始使用」和[更新日志](CHANGELOG.md)为准。
30
+
31
+ | 文档 | 内容 |
32
+ | :--- | :--- |
33
+ | [0.23.2 验证记录](testing/0.23.2/测试报告.md) | 两轮完整开发、归档回退与门禁专项的实际结果。 |
34
+ | [0.23.2 发布说明](releases/0.23.2.md) | 验证命令单次审批修复、提交指引与管控边界。 |
35
+ | [0.23.1 验证记录](testing/0.23.1/测试报告.md) | 自动化、安装包与实机证据的适用范围。 |
36
+ | [0.23.1 发布说明](releases/0.23.1.md) | 真实项目发现的问题、修复及能力边界。 |
37
+ | [0.23.1 回归迭代说明](workflow-regression.md) | 真实项目逐轮问题的处理记录。 |
38
+ | [0.23.0 验证记录](testing/0.23.0/测试报告.md) | 资源导入、工作台交互与包入口的验证。 |
39
+ | [0.23.0 发布说明](releases/0.23.0.md) | 早期安装交互及界面调整。 |
40
+
41
41
  > 0.23.3 起的版本变化全部记录在[更新日志](CHANGELOG.md)中,不再单独出具发布说明。
@@ -24,24 +24,27 @@
24
24
  }
25
25
  ```
26
26
 
27
- `stage_bindings` 的键是当前流程中的阶段名称,值只有 `skills`——**节点只选择技能,规则属于技能**。
27
+ `stage_bindings` 的键是当前流程中的阶段名称,`skill_refs` 只保存技能引用。`skill_profiles` 为每个技能保存唯一的规则列表和证据类型。
28
28
 
29
29
  ```json
30
30
  {
31
31
  "flow": "standard",
32
32
  "stage_bindings": {
33
33
  "开发": {
34
- "skills": [
35
- { "skill": { "source": "bundled", "name": "code-implement" },
36
- "rules": [{ "source": "bundled", "name": "coding-conventions" },
37
- { "source": "project", "name": "api-contract" }] }
38
- ]
34
+ "skill_refs": [{ "source": "bundled", "name": "code-implement" }]
35
+ }
36
+ },
37
+ "skill_profiles": {
38
+ "bundled:code-implement": {
39
+ "rules": [{ "source": "bundled", "name": "coding-conventions" },
40
+ { "source": "project", "name": "api-contract" }],
41
+ "evidence": "none"
39
42
  }
40
43
  }
41
44
  }
42
45
  ```
43
46
 
44
- **规则挂载在技能下,节点不提供规则追加、禁用或覆盖。** 打开一个技能就能看到它完整的规则列表;把它挂到任何节点,都是同一套规则。需要同一技能在不同节点用不同规则时,**复制成另一个独立技能**,再分别配置——不建立隐式继承关系。
47
+ **规则挂载在技能下,节点不提供规则追加、禁用或覆盖。** 在工作台“技能”页或流程页的技能规则侧栏配置规则;同一技能挂到任何节点,都是同一套规则。需要不同规则组合时,复制成另一个独立技能。旧版把规则内联在各节点技能绑定的配置仍可读取;保存后会转为上述格式。若旧内联绑定与 `skill_profiles` 同时存在,明确配置的技能档案优先,所有节点使用它的规则和凭证;若没有技能档案而同一旧技能在不同节点的规则不同,系统会要求先复制为独立技能,不会任意选一套覆盖另一套。
45
48
 
46
49
  规则引用带来源(`bundled:` / `project:` / `user:`),因此同名资源不会被混淆。同一份规则可被多个技能引用,不需要复制正文;编辑共享规则时界面会显示受影响的技能。
47
50
 
@@ -49,7 +52,9 @@
49
52
 
50
53
  **预设不带任何绑定。** 一个只写了 `flow` 的配置就是字面意思:该流程的节点没有绑定,阶段仍按流程骨架流转。要一份现成的工程起点,在工作台点「采用推荐配置」,它会把技能、提交信息格式与产物字段**写入**你的配置一次;此后这些值就是你的普通配置,删掉不会补回,升级也不覆盖。
51
54
 
52
- 进入阶段后,`dev_task` 披露该阶段全部技能的规则内容。新任务离开阶段前会检查 Harness 的 skill 工具成功加载记录;技能还可以**声明自己需要哪类证据**(`command` / `artifact` / `review` / `manual` / `none`),引擎按各自形态检查对应记录——需求或设计类技能产出的是文档,不必运行一条无关命令。未声明时沿用命令回执。`status.skill_obligations` 中的 `command_receipts_required` 列出确实需要命令回执的技能。安装一个技能不会自动执行其中的脚本。
55
+ 内置业务技能和规则作为只读样本保留。在“技能”或“规则”页选择“以此为模板新建”,可预填一份可编辑的项目或个人资源;复制只带正文,不自动复制该技能的规则档案,也不挂到任何阶段。保存后请单独配置完成凭证、规则与阶段引用。
56
+
57
+ 进入阶段后,`dev_task` 披露该阶段技能和规则的冻结正文。新任务离开阶段前会检查 Harness 的 skill 工具成功加载记录;技能可声明证据类型(`command` / `artifact` / `review` / `manual` / `none`)。`manual` 通过宿主人工审批记录,不要求执行命令;`artifact` 需要该阶段有产物定义且必填字段完整。未声明时沿用命令回执。`status.skill_obligations` 中的 `command_receipts_required` 列出需要命令回执的技能。
53
58
 
54
59
  挂在终态(例如"完成")的技能在进入终态前执行。测试技能通常建议挂在"交付";现有"完成"绑定也会在审核阶段执行后才放行。标准流程 v2 在审核通过后提交,并核对真实 Git HEAD。修改文件或声明范围后,旧验证回执失效。
55
60
 
@@ -69,6 +74,6 @@
69
74
 
70
75
  新任务记录创建时的完整流程快照,后续按该快照执行。修改项目配置影响之后创建的任务,不会自动迁移进行中的任务。
71
76
 
72
- 验证命令还可以由配置中的 `verify_command` 指定;未指定时根据项目类型选择默认命令。当前工作台保存流程时只写入 flow 和 stage_bindings,手写的额外字段可能被移除;使用此项时请检查保存后的文件。这一问题纳入后续配置编辑器改造。
77
+ 任务开始时会冻结所引用的技能和规则正文。资源类型、来源和名称共同构成身份,因此同名技能和规则不会混淆。缺失的必需资源会阻止新任务创建;已完成任务若需返工,使用 `revise` 显式重开。
73
78
 
74
79
  下一步:[资源安装](resource-install.md) · [常见问题](faq.md)
@@ -25,7 +25,7 @@ CI 在 Windows 的 Node 22/24 上运行。每次功能修改选择相关验证
25
25
  | 位置 | 职责 |
26
26
  | :--- | :--- |
27
27
  | [src/engine.ts](../src/engine.ts) | 状态机、阶段条件和提交规则检查。 |
28
- | [src/workflows.ts](../src/workflows.ts) | 三套内置流程及默认技能/规则绑定。 |
28
+ | [src/workflows.ts](../src/workflows.ts) | 三套流程骨架及可选的推荐配置。 |
29
29
  | [src/dev-task.ts](../src/dev-task.ts) | 模型使用的 dev_task 工具与任务文件操作。 |
30
30
  | [src/controller.ts](../src/controller.ts) | 工作台读取配置、任务和资源的 Remote 控制器。 |
31
31
  | [src/resource-import.ts](../src/resource-import.ts) | 导入校验、安装预览、独占写入与失败清理。 |
package/docs/faq.md CHANGED
@@ -16,19 +16,19 @@
16
16
 
17
17
  ## 安装资源后就会自动使用吗?
18
18
 
19
- 还需要到“流程配置”选择阶段并挂载资源。任务执行时按阶段披露对应内容;安装行为本身不会执行资源中的脚本。
19
+ 还需要为技能配置规则,再到“流程配置”选择阶段并挂载技能。任务执行时按阶段披露对应内容;安装行为本身不会执行资源中的脚本。
20
20
 
21
21
  ## 改了流程,原来的任务会变化吗?
22
22
 
23
23
  任务保存创建时的流程快照。修改项目配置不会自动改变进行中的任务;新任务使用保存后的配置。
24
24
 
25
- ## 能移除默认技能、覆盖内置规则吗?
25
+ ## 能移除推荐技能、修改内置规则吗?
26
26
 
27
- 预设绑定只能追加,内置资源只读且同名优先。需要自建资源时使用新名称;同名资源会同时保留在各自来源,绑定选择按名称去重。
27
+ 流程预设没有强制技能绑定。「采用推荐配置」只是一次性写入项目配置,之后可任意增删技能和规则。内置业务技能和规则是只读样本:可用“以此为模板新建”复制正文,改名后保存为自己的资源,再配置完成凭证、规则和阶段绑定。复制不会自动启用它们;不同来源的同名资源也不会混用。会话预设中的 `eng-delivery` 只负责按 `dev_task` 的状态与门禁编排,不决定业务方法。
28
28
 
29
29
  ## 工具显示验证或审核通过,能完全相信吗?
30
30
 
31
- 新建任务的验证需要真实命令回执,要求退出码为 0 且未超时、中止或被沙箱拒绝;代码修改后需重验。附加技能记录加载、命令和场景证据;审核和实施项结论仍由模型记录。命令覆盖是否充分、审核是否准确仍需判断,不能把一个成功退出码当作全部需求已验证。
31
+ 新建任务的验证需要真实命令回执,要求退出码为 0 且未超时、中止或被沙箱拒绝;代码修改后需重验。技能按配置记录加载情况及所需的命令、产物、审核或人工批准证据;审核和实施项结论仍需判断。命令覆盖是否充分、审核是否准确仍需判断,不能把一个成功退出码当作全部需求已验证。
32
32
 
33
33
  ## 验证命令被沙箱阻止怎么办?
34
34
 
@@ -1,6 +1,6 @@
1
- url: https://github.com/godv61/dsh-task-engine
2
- name: godv61/dsh-task-engine
3
- category: workflow
4
- description:
5
- en: 'Preset engineering workflows for DeepSeek Harness: a dev_task tool that gates stage transitions, artifacts, verification, review and commit scope, plus a web workbench for installing project or user skills and rules.'
1
+ url: https://github.com/godv61/dsh-task-engine
2
+ name: godv61/dsh-task-engine
3
+ category: workflow
4
+ description:
5
+ en: 'Preset engineering workflows for DeepSeek Harness: a dev_task tool that gates stage transitions, artifacts, verification, review and commit scope, plus a web workbench for installing project or user skills and rules.'
6
6
  zh: '为 DeepSeek Harness 提供预设工程流程:dev_task 工具把阶段流转、产物、验证、审核与提交范围做成硬门禁,并带一个安装项目级与个人级技能和规则的工作台。'
@@ -1,84 +1,84 @@
1
- # 插件收录申请
2
-
3
- **已收录:** [PR #5681](https://github.com/awesome-dsh-plugin/awesome-dsh-plugin/pull/5681)
4
- 于 2026-09-22 15:45:57 UTC 被维护者 `fkysly` 合并,**无修改要求**(0 条评审评论)。
5
- 条目已在列表的 `main` 上,中英两个 README 均已生成对应行。
6
-
7
- 提交时 `check`(7m40s)与 `Submission gate` 两项 CI 全部通过。PR 只新增
8
- `data/plugins/godv61__dsh-task-engine.yml`(+6 行),未触碰生成出来的 README。
9
-
10
- 条目页:[awesome-dsh-plugin.com](https://awesome-dsh-plugin.com)
11
-
12
- 目标:[awesome-dsh-plugin](https://github.com/awesome-dsh-plugin/awesome-dsh-plugin)。
13
-
14
- ## 提交内容
15
-
16
- 按[贡献指南](https://github.com/awesome-dsh-plugin/awesome-dsh-plugin/blob/main/contributing.md),
17
- PR **只新增一个文件**:`data/plugins/godv61__dsh-task-engine.yml`,内容复制本目录同名 YAML。
18
-
19
- **标题:** `Add godv61/dsh-task-engine`
20
-
21
- **分类:** `workflow` —— 插件本身提供工程流程预设与阶段门禁,分类与实际行为一致。
22
-
23
- > 注意:`data/plugins/` 下的条目文件是数据源,仓库根的两个 README 由脚本生成。
24
- > **不要手工编辑 README**,也不要往 `data/screenshots.json` 加键(新约定是插件仓库自己放 `screenshots.json`)。
25
-
26
- ## PR 正文
27
-
28
- > Adds `godv61/dsh-task-engine` under `workflow`.
29
- >
30
- > The plugin adds a `dev_task` tool that holds an engineering state machine: three preset flows
31
- > (`standard`, `agile`, `minimal`) with transitions gated on human confirmation, artifact
32
- > completeness, implementation items, real verification receipts, and review outcome — plus a
33
- > commit gate that checks stage, message format and file scope. A web workbench installs project- or
34
- > user-level skills and rules, binds them to individual stages, and shows the task ledger.
35
- >
36
- > Repository includes source, a `dsh.bundle` manifest with `cordis.patch.yml`, user documentation,
37
- > and a test suite (146 P0 assertions, 52 `node:test` cases including an end-to-end commit-hook
38
- > suite). Published on npm; `repository` points back at this repo.
39
-
40
- ## 提交前的自查(对照指南逐条)
41
-
42
- | 指南要求 | 本仓库状态 |
43
- | :--- | :--- |
44
- | `package.json` 声明 `dsh.bundle` | ✅ `"bundle": { "patch": "./cordis.patch.yml" }` |
45
- | 仓库根有 `cordis.patch.yml` | ✅ |
46
- | 真实可用代码(非占位/纯 README) | ✅ host 与 client 两个面均已实现并有测试 |
47
- | 仓库创建满 1 天 | ✅ 创建于 2026-09-15 08:10:50 UTC |
48
- | 已有 `dsh-plugin` topic | ✅ |
49
- | 活跃维护 | ✅ |
50
- | `repository` 指回本仓库 | ✅ `git+https://github.com/godv61/dsh-task-engine.git` |
51
- | npm 包 `repository` 回指同一仓库 | ✅ |
52
- | 非纯聚合包(自带行为) | ✅ 自带 `dev_task` 工具与工作台 UI |
53
- | 描述不含 `: `(冒号+空格) | ✅ 已加引号 |
54
- | 官方包用 `peerDependencies` | ✅ `@deepseek-ai/dsh-*` 均在 peer 中 |
55
- | peer 范围带显式预发布分支 | ✅ `^0.1.2-rc.1 \|\| ^0.1.3-alpha.1 \|\| ^0.1.6-alpha.2 \|\| ^0.1.7-alpha.1` |
56
-
57
- **关于 peer 范围**:指南特别警告过「不带显式预发布分支的范围会静默排除 harness 的预发布构建」。
58
- 本插件用的是显式 `||` 分支形式,正是指南推荐写法。
59
-
60
- ## 描述准确性
61
-
62
- 指南说明描述会被**当作对代码的声明并逐句核对**,因此上面那行只写了可验证的事实:
63
-
64
- | 描述中的说法 | 代码依据 |
65
- | :--- | :--- |
66
- | `dev_task` 工具 | `src/dev-task.ts` 的 `defineTool` |
67
- | 阶段流转门禁 | `src/engine.ts` 的 `assertAdvance` / `legalTargets` |
68
- | 产物门禁 | guard `artifacts_present` + `ArtifactDef` |
69
- | 验证门禁 | guard `verified` + 真实命令回执 |
70
- | 审核门禁 | guard `review_passed` |
71
- | 提交范围校验 | `checkFileScope` + `hooks/commit-msg` |
72
- | 三个预设流程 | `FLOW_OPTIONS`:`standard` / `agile` / `minimal` |
73
- | 工作台安装技能与规则 | `src/client/` 的 `ResourceManager` 等 |
74
-
75
- **描述里刻意不写具体数字**(如「7 个技能、3 条规则」):这类数字会随版本变化,
76
- 写死反而容易变成不准确声明。
77
-
78
- ## 备注
79
-
80
- 本目录此前一份材料提到「仓库创建满 24 小时」与手工核对 `created_at`。指南现已说明
81
- **该门槛由 CI 自动检查**,无需在 PR 里论证,故此处不再展开。
82
-
83
- 截图可选:可在本仓库根放 `screenshots.json` 声明,市场会自动读取,无需在本列表仓库提交图片。
1
+ # 插件收录申请
2
+
3
+ **已收录:** [PR #5681](https://github.com/awesome-dsh-plugin/awesome-dsh-plugin/pull/5681)
4
+ 于 2026-09-22 15:45:57 UTC 被维护者 `fkysly` 合并,**无修改要求**(0 条评审评论)。
5
+ 条目已在列表的 `main` 上,中英两个 README 均已生成对应行。
6
+
7
+ 提交时 `check`(7m40s)与 `Submission gate` 两项 CI 全部通过。PR 只新增
8
+ `data/plugins/godv61__dsh-task-engine.yml`(+6 行),未触碰生成出来的 README。
9
+
10
+ 条目页:[awesome-dsh-plugin.com](https://awesome-dsh-plugin.com)
11
+
12
+ 目标:[awesome-dsh-plugin](https://github.com/awesome-dsh-plugin/awesome-dsh-plugin)。
13
+
14
+ ## 提交内容
15
+
16
+ 按[贡献指南](https://github.com/awesome-dsh-plugin/awesome-dsh-plugin/blob/main/contributing.md),
17
+ PR **只新增一个文件**:`data/plugins/godv61__dsh-task-engine.yml`,内容复制本目录同名 YAML。
18
+
19
+ **标题:** `Add godv61/dsh-task-engine`
20
+
21
+ **分类:** `workflow` —— 插件本身提供工程流程预设与阶段门禁,分类与实际行为一致。
22
+
23
+ > 注意:`data/plugins/` 下的条目文件是数据源,仓库根的两个 README 由脚本生成。
24
+ > **不要手工编辑 README**,也不要往 `data/screenshots.json` 加键(新约定是插件仓库自己放 `screenshots.json`)。
25
+
26
+ ## PR 正文
27
+
28
+ > Adds `godv61/dsh-task-engine` under `workflow`.
29
+ >
30
+ > The plugin adds a `dev_task` tool that holds an engineering state machine: three preset flows
31
+ > (`standard`, `agile`, `minimal`) with transitions gated on human confirmation, artifact
32
+ > completeness, implementation items, real verification receipts, and review outcome — plus a
33
+ > commit gate that checks stage, message format and file scope. A web workbench installs project- or
34
+ > user-level skills and rules, binds them to individual stages, and shows the task ledger.
35
+ >
36
+ > Repository includes source, a `dsh.bundle` manifest with `cordis.patch.yml`, user documentation,
37
+ > and a test suite (146 P0 assertions, 52 `node:test` cases including an end-to-end commit-hook
38
+ > suite). Published on npm; `repository` points back at this repo.
39
+
40
+ ## 提交前的自查(对照指南逐条)
41
+
42
+ | 指南要求 | 本仓库状态 |
43
+ | :--- | :--- |
44
+ | `package.json` 声明 `dsh.bundle` | ✅ `"bundle": { "patch": "./cordis.patch.yml" }` |
45
+ | 仓库根有 `cordis.patch.yml` | ✅ |
46
+ | 真实可用代码(非占位/纯 README) | ✅ host 与 client 两个面均已实现并有测试 |
47
+ | 仓库创建满 1 天 | ✅ 创建于 2026-09-15 08:10:50 UTC |
48
+ | 已有 `dsh-plugin` topic | ✅ |
49
+ | 活跃维护 | ✅ |
50
+ | `repository` 指回本仓库 | ✅ `git+https://github.com/godv61/dsh-task-engine.git` |
51
+ | npm 包 `repository` 回指同一仓库 | ✅ |
52
+ | 非纯聚合包(自带行为) | ✅ 自带 `dev_task` 工具与工作台 UI |
53
+ | 描述不含 `: `(冒号+空格) | ✅ 已加引号 |
54
+ | 官方包用 `peerDependencies` | ✅ `@deepseek-ai/dsh-*` 均在 peer 中 |
55
+ | peer 范围带显式预发布分支 | ✅ `^0.1.2-rc.1 \|\| ^0.1.3-alpha.1 \|\| ^0.1.6-alpha.2 \|\| ^0.1.7-alpha.1` |
56
+
57
+ **关于 peer 范围**:指南特别警告过「不带显式预发布分支的范围会静默排除 harness 的预发布构建」。
58
+ 本插件用的是显式 `||` 分支形式,正是指南推荐写法。
59
+
60
+ ## 描述准确性
61
+
62
+ 指南说明描述会被**当作对代码的声明并逐句核对**,因此上面那行只写了可验证的事实:
63
+
64
+ | 描述中的说法 | 代码依据 |
65
+ | :--- | :--- |
66
+ | `dev_task` 工具 | `src/dev-task.ts` 的 `defineTool` |
67
+ | 阶段流转门禁 | `src/engine.ts` 的 `assertAdvance` / `legalTargets` |
68
+ | 产物门禁 | guard `artifacts_present` + `ArtifactDef` |
69
+ | 验证门禁 | guard `verified` + 真实命令回执 |
70
+ | 审核门禁 | guard `review_passed` |
71
+ | 提交范围校验 | `checkFileScope` + `hooks/commit-msg` |
72
+ | 三个预设流程 | `FLOW_OPTIONS`:`standard` / `agile` / `minimal` |
73
+ | 工作台安装技能与规则 | `src/client/` 的 `ResourceManager` 等 |
74
+
75
+ **描述里刻意不写具体数字**(如「7 个技能、3 条规则」):这类数字会随版本变化,
76
+ 写死反而容易变成不准确声明。
77
+
78
+ ## 备注
79
+
80
+ 本目录此前一份材料提到「仓库创建满 24 小时」与手工核对 `created_at`。指南现已说明
81
+ **该门槛由 CI 自动检查**,无需在 PR 里论证,故此处不再展开。
82
+
83
+ 截图可选:可在本仓库根放 `screenshots.json` 声明,市场会自动读取,无需在本列表仓库提交图片。
84
84
  当前未声明,市场会从 README 自动抽取。
package/docs/manual.html CHANGED
@@ -35,9 +35,9 @@
35
35
  <header class="hero">
36
36
  <p class="eyebrow">DSH · ENGINEERING DELIVERY ENGINE</p>
37
37
  <h1>工程化交付引擎 使用手册</h1>
38
- <p class="lead">这是一套装在 DeepSeek Harness 里的工程流程约束。它把「需求评审 → 设计 → 开发 → 交付 → 代码审核」做成硬门槛:阶段不能跳、关键节点必须人来拍板、验证和提交都被机械检查。在个人工作台里选一套流程,再给每个节点挂上合适的技能和规则。</p>
38
+ <p class="lead">这是一套装在 DeepSeek Harness 里的工程流程约束。流程预设规定阶段与门禁;技能、规则、提交文本和产物字段由使用者配置。在个人工作台里选择流程,把规则配置在技能下,再把技能挂到相应阶段。</p>
39
39
  <div class="badges">
40
- <span class="badge">选流程预设即可</span>
40
+ <span class="badge">流程与工作方法分离</span>
41
41
  <span class="badge">standard / agile / minimal</span>
42
42
  <span class="badge">需求、方案人工确认</span>
43
43
  <span class="badge">范围受控本地提交</span>
@@ -80,9 +80,9 @@
80
80
  <div class="callout">
81
81
  <p><strong>它不是常驻程序。</strong>只有你在「工程化开发引擎」预设的会话里提出开发请求时,才触发 <code>dev_task</code> 和这套门禁;换到别的预设,流程完全不介入。</p>
82
82
  </div>
83
- <p>三样东西分工明确:<strong>流程预设</strong>决定「走哪条流水线、有哪些守卫」,<strong>Skill</strong> 决定「这一站做什么」,<strong>Rule</strong> 决定「这一站守什么」。任务状态单独落盘,负责「跨会话恢复到哪一步」。</p>
83
+ <p>三样东西分工明确:<strong>流程预设</strong>决定「走哪条流水线、有哪些守卫」,<strong>Skill</strong> 决定「这一站做什么」,<strong>Rule</strong> 归属技能,决定该技能遵守什么。任务状态单独落盘,负责「跨会话恢复到哪一步」。推荐配置需要显式采用;采用后完全由使用者增删修改。</p>
84
84
  <div class="callout warn">
85
- <p><strong>诚实边界:</strong>阶段流转、提交格式、文件范围、消息里的任务绑定、流程快照 hash、钩子完整性、敏感路径风险策略是<b>代码硬校验</b>(不匹配直接拒绝);<b>高风险任务的「验证通过」也是真实命令回执</b>——引擎实际运行 <code>verify</code> 命令、取退出码(<code>exit_code === 0</code> 且非超时/中止)才放行,不是模型自报。仍属模型自报、需人工或 CI 兜底的是:旧任务的常规风险验证声明、「评审通过」「实施项完成」,以及回执命令本身的覆盖面。只有「需求确认」「方案确认」两扇门由人工批准点亮,风险降级(high_risk → standard)也由人工批准。</p>
85
+ <p><strong>诚实边界:</strong>阶段流转、文件范围、任务绑定、流程快照 hash、钩子完整性、敏感路径风险策略是<b>代码硬校验</b>;提交格式仅在用户配置后校验。高风险任务的验证依据真实命令回执。审核结论、实施项完成及回执命令的覆盖面仍需人工或 CI 判断;需求确认、方案确认和风险降级由人工批准。</p>
86
86
  </div>
87
87
  </section>
88
88
 
@@ -116,7 +116,7 @@ pnpm install &amp;&amp; pnpm run build &amp;&amp; pnpm dsh web</code></pre>
116
116
  <pre><code>D:\workspace\
117
117
  ├─ AGENTS.md ← init 生成的项目描述(DSH 每会话自动注入)
118
118
  ├─ .dsh\
119
- │ ├─ eng.json ← 流程预设 + 节点挂载(团队共享,可进 git)
119
+ │ ├─ eng.json ← 流程预设 + 节点技能 + 技能规则(团队共享,可进 git)
120
120
  │ ├─ skills\ ← 项目级 skill
121
121
  │ ├─ rules\ ← 项目级 rule
122
122
  │ └─ task-*.json ← 每个任务的状态快照
@@ -127,11 +127,11 @@ pnpm install &amp;&amp; pnpm run build &amp;&amp; pnpm dsh web</code></pre>
127
127
  <table>
128
128
  <thead><tr><th>路径</th><th>作用</th><th>何时读取或修改</th></tr></thead>
129
129
  <tbody>
130
- <tr><td><code>.dsh/eng.json</code></td><td>声明用哪套流程 + 每个节点挂哪些 skill / rule</td><td>任务推进前读取;工作台保存时写入</td></tr>
130
+ <tr><td><code>.dsh/eng.json</code></td><td>流程、阶段技能引用及技能规则配置</td><td>新任务创建时读取并冻结;工作台保存时写入</td></tr>
131
131
  <tr><td><code>.dsh/skills/</code></td><td>项目级 skill(团队共享)</td><td>节点挂载命中时按需读取</td></tr>
132
132
  <tr><td><code>.dsh/rules/</code></td><td>项目级 rule(团队共享)</td><td>节点挂载命中时按需读取</td></tr>
133
133
  <tr><td><code>.dsh/task-*.json</code></td><td>当前任务的有效状态快照</td><td>确认、实施、验证、评审、切换阶段时更新</td></tr>
134
- <tr><td><code>$DSH_HOME/skills/ · rules/</code></td><td>用户级 skill / rule</td><td>同名时让位于内置(内置 &gt; 用户 &gt; 项目)</td></tr>
134
+ <tr><td><code>$DSH_HOME/skills/ · rules/</code></td><td>用户级 skill / rule</td><td>引用显式记录来源,同名资源互不混淆</td></tr>
135
135
  </tbody>
136
136
  </table>
137
137
  </div>
@@ -139,14 +139,14 @@ pnpm install &amp;&amp; pnpm run build &amp;&amp; pnpm dsh web</code></pre>
139
139
 
140
140
  <section id="flows">
141
141
  <h2>4. 三套流程预设</h2>
142
- <p>阶段图、守卫、提交规则都随预设固化好,团队只选一套,不改流程图。</p>
142
+ <p>阶段图和流转门禁随预设固化;提交消息格式、产物字段及技能规则由使用者配置。需要一份起点时,可显式「采用推荐配置」。</p>
143
143
  <div class="table-wrap">
144
144
  <table>
145
145
  <thead><tr><th>预设</th><th>阶段顺序</th><th>适用</th><th>守卫强度</th></tr></thead>
146
146
  <tbody>
147
- <tr><td><code>standard</code> 标准研发</td><td>需求评审 → 设计 → 开发 → 交付 → 代码审核 → 完成</td><td>默认;流程最完整</td><td>含产物门 + 人工确认 + 评审门</td></tr>
148
- <tr><td><code>agile</code> 敏捷轻量</td><td>需求 → 开发 → 交付 → 审查</td><td>快速迭代、少产物</td><td>四阶段,产物要求更轻</td></tr>
149
- <tr><td><code>minimal</code> 纯代码</td><td>开发 → 交付</td><td>只有代码、无评审流程</td><td>只留提交门禁</td></tr>
147
+ <tr><td><code>standard</code> 完整研发</td><td>需求评审 → 设计 → 开发 → 交付 → 代码审核 → 完成</td><td>新功能、跨模块及高风险任务</td><td>人工确认 + 验证门 + 评审门</td></tr>
148
+ <tr><td><code>agile</code> 日常迭代</td><td>需求 → 开发 → 交付 → 审查</td><td>常规功能与缺陷修复</td><td>四阶段,终态需审查通过</td></tr>
149
+ <tr><td><code>minimal</code> 快速修改</td><td>开发 → 交付</td><td>局部低风险改动</td><td>实施项与交付门禁</td></tr>
150
150
  </tbody>
151
151
  </table>
152
152
  </div>
@@ -178,7 +178,7 @@ pnpm install &amp;&amp; pnpm run build &amp;&amp; pnpm dsh web</code></pre>
178
178
 
179
179
  <section id="rules">
180
180
  <h2>6. Rules:这一步守什么</h2>
181
- <p>Rule 是纯正文的约束,只有挂在节点上、且走到那一步时才读。内置三条:</p>
181
+ <p>Rule 是纯正文的约束,配置在技能下。节点引用技能,任务走到该节点时才读取技能及其规则;预设不会自动绑定它们。内置示例有:</p>
182
182
  <div class="table-wrap">
183
183
  <table>
184
184
  <thead><tr><th>Rule</th><th>约束内容</th><th>典型触发</th></tr></thead>
@@ -189,30 +189,35 @@ pnpm install &amp;&amp; pnpm run build &amp;&amp; pnpm dsh web</code></pre>
189
189
  </tbody>
190
190
  </table>
191
191
  </div>
192
- <p>最重要的轻量原则:团队想改「提交消息格式」「交付要自测」这类约定,新建一个项目级规则 / 技能(用<b>新名字</b>)再挂到对应节点,而不是改一堆参数;内置 skill / rule 的正文<b>不可被同名覆盖</b>。</p>
192
+ <p>内置资源只是可选示例,正文只读。团队可以创建自己的技能和规则,把规则绑定到技能,再决定哪些节点使用该技能;提交消息格式应在项目配置中设置。</p>
193
193
  </section>
194
194
 
195
195
  <section id="configure">
196
- <p>当前版本支持三个内置流程及追加阶段资源。可视化自定义流程曾列入评估,结论是不实现:它把流程设计的负担转嫁给使用者,而三个内置流程已覆盖个人项目的常见需要。</p>
196
+ <p>当前版本支持三个内置流程,阶段可选择技能,技能可绑定规则。可视化自定义流程不在当前计划内。</p>
197
197
  <h2>7. 配置流程与挂载</h2>
198
198
  <p>侧边栏点「工程流程」打开工作台,五个标签页:<strong>项目初始化 / 流程配置 / 任务 / 技能 skill / 规则 rule</strong>,默认落在「项目初始化」(详见第 8 节)。日常配流程只需在「流程配置」页做两件事:</p>
199
199
  <ol>
200
- <li><strong>选流程预设</strong>:standard / agile / minimal 点一下即切。</li>
201
- <li><strong>给节点挂 skill / rule</strong>:先选一个节点(如「开发」),再勾选它用什么 skill、守哪条 rule,保存。</li>
200
+ <li><strong>选流程预设</strong>:standard / agile / minimal;如需现成起点,可单独点击「采用推荐配置」。</li>
201
+ <li><strong>给节点选技能</strong>:先选节点,再用双栏选择器挑选技能;点技能的规则配置,在右侧栏绑定规则与证据类型,最后保存。</li>
202
202
  </ol>
203
- <p>「技能」和「规则」页提供搜索、来源筛选、新建、安装、查看、编辑与删除。内置资源只读。点「安装技能」直接打开系统文件选择器,选择含 <code>SKILL.md</code> 的文件夹;点「安装规则」选择一个 <code>.md</code> 文件。选择后先显示预览:名称、正文、文件数、体积、目标路径和同名冲突。确认项目或个人范围后点击「确认安装」;预览本身不写入文件,改变范围后需要重新预览。</p>
203
+ <p>「技能」和「规则」页提供搜索、来源筛选、新建、安装、查看、编辑与删除。内置资源是只读样本,可点「以此为模板新建」预填可编辑副本;副本的完成凭证、规则与阶段绑定需另行配置。点「安装技能」直接打开系统文件选择器,选择含 <code>SKILL.md</code> 的文件夹;点「安装规则」选择一个 <code>.md</code> 文件。选择后先显示预览:名称、正文、文件数、体积、目标路径和同名冲突。确认项目或个人范围后点击「确认安装」;预览本身不写入文件,改变范围后需要重新预览。</p>
204
204
  <p>项目资源写入工作区 <code>.dsh/skills</code> 或 <code>.dsh/rules</code>;个人资源写入 <code>$DSH_HOME</code> 对应目录。浏览器选择的是浏览器所在电脑的文件;高级目录模式读取 Harness 主机的目录。技能保留脚本、references、模板和二进制资源,排除常见缓存;上限 1000 文件、100 MB、单文件 20 MB、20 层目录,<code>SKILL.md</code> 和规则正文上限 1 MB。拒绝覆盖同名资源;主机扫描拒绝符号链接和 junction。浏览器上传不提供源链接元数据。</p>
205
205
  <p>资源删除前会显示名称与实际目标路径,确认后永久删除;可点击「保留」取消。任务台账支持搜索、风险与阶段筛选,并显示验证、审核和更新时间。流程配置读取与保存失败时显示错误,损坏任务记录不会被静默视为没有任务。</p>
206
206
  <pre><code>// .dsh/eng.json 等价内容
207
207
  {
208
208
  "flow": "standard",
209
209
  "stage_bindings": {
210
- "需求评审": { "skills": ["requirement-analysis"], "rules": ["security-redlines"] },
211
- "开发": { "skills": ["code-implement"], "rules": ["coding-conventions"] }
210
+ "开发": { "skill_refs": [{ "source": "bundled", "name": "code-implement" }] }
211
+ },
212
+ "skill_profiles": {
213
+ "bundled:code-implement": {
214
+ "rules": [{ "source": "project", "name": "my-coding-rule" }],
215
+ "evidence": "none"
216
+ }
212
217
  }
213
218
  }</code></pre>
214
219
  <div class="callout warn"><p>页面实时校验:挂到不存在的阶段、空名等会红字提示并置灰保存;保存前主机再校验一遍。错误的配置存不进去。</p></div>
215
- <p>三层来源与优先级:同名 skill / rule,<strong>内置 &gt; 用户 &gt; 项目</strong>——内置不可被同名覆盖(新建同名会被拒,解析同名只读内置版)。要加团队约定,新建一个<b>不同名</b>的项目级 / 用户级资源再挂到节点上。</p>
220
+ <p>技能和规则引用包含 <code>source</code> 与 <code>name</code>;内置、项目、用户目录中的同名资源可以区分。旧版节点级规则迁移时会保留为待分配规则并继续生效,建议逐条归到对应技能。</p>
216
221
  </section>
217
222
 
218
223
  <section id="init">
@@ -272,7 +277,7 @@ pnpm install &amp;&amp; pnpm run build &amp;&amp; pnpm dsh web</code></pre>
272
277
  </tbody>
273
278
  </table>
274
279
  </div>
275
- <p>新任务离开阶段前检查绑定技能是否通过 skill 工具成功加载;附加技能需通过 <code>skill_result</code> 记录执行场景与真实验收命令;状态中的 <code>command_receipts_required</code> 列出这些技能,七个内置技能无需重复登记。挂在“完成”的技能在前一阶段执行。命令成功只证明该命令通过,不证明测试覆盖完整。审核改动后须重跑验证。旧任务继续使用冻结快照。</p>
280
+ <p>新任务离开阶段前检查绑定技能是否成功加载;技能可以声明 <code>command</code>、<code>artifact</code>、<code>review</code>、<code>manual</code> 或 <code>none</code> 证据类型。只有需要命令回执的技能才出现在 <code>command_receipts_required</code> 中。挂在终态的技能在进入终态前执行。命令成功只证明该命令通过,不证明覆盖完整;文件变动后须重新验证。旧任务继续使用冻结快照。</p>
276
281
  <h3>贯穿全程的硬规则</h3>
277
282
  <ul>
278
283
  <li>阶段是硬状态:status 说你在哪,就只做那一步,绝不倒带重走、绝不跳。</li>
@@ -313,7 +318,7 @@ pnpm install &amp;&amp; pnpm run build &amp;&amp; pnpm dsh web</code></pre>
313
318
  <li>差异没变时复用有效证据,不重复跑相同命令。</li>
314
319
  <li>无法联调外部系统时必须如实写「未联调」,不能把编译成功说成功能通过。</li>
315
320
  <li><code>high_risk</code> 任务过验证门必须跑真实命令回执(引擎运行命令、取退出码,非自报通过)。</li>
316
- <li><code>verify</code> 不带 <code>command</code> 时引擎自动选命令:<code>.dsh/eng.json</code> 的 <code>verify_command</code> 优先,其次按项目语言用默认(node → <code>npm test</code>、java → <code>mvn -q test</code>、python → <code>python -m pytest</code>、go → <code>go test ./...</code>、rust → <code>cargo test</code>);识别不出语言且未配置时保留自报路径。跑命令依赖宿主 shell 服务,未挂载会明确报错。</li>
321
+ <li><code>verify</code> 不带 <code>command</code> 时引擎自动选命令:<code>.dsh/eng.json</code> 的 <code>verify_command</code> 优先,其次按项目语言用默认(node → <code>npm test</code>、java → <code>mvn -q test</code>、python → <code>python -m pytest</code>、go → <code>go test ./...</code>、rust → <code>cargo test</code>);新任务若没有可用默认命令,须显式提供真实命令。跑命令依赖宿主 shell 服务,未挂载会明确报错。</li>
317
322
  <li><b>验证命令始终在任务记录的项目根运行</b>(任务创建时自动发现并固化 <code>root</code>),不是会话当前目录——monorepo 里会话停在子目录时,<code>npm test</code> 等也会在放清单文件的项目根执行;回执记录的 <code>root</code> 与任务根强校验,不一致直接拒绝。</li>
318
323
  </ul>
319
324
  <h3>评审</h3>
@@ -329,7 +334,7 @@ pnpm install &amp;&amp; pnpm run build &amp;&amp; pnpm dsh web</code></pre>
329
334
  </tbody>
330
335
  </table>
331
336
  </div>
332
- <p>内置流程的提交消息要求 <code>【任务 id】【TASK】结果说明</code>,第一段填写当前任务 id,第二段使用 <code>dev_task status</code> 返回的 <code>commit.label</code>;自定义格式由任务冻结流程决定。只提交任务 <code>files</code> 范围内的文件。要彻底封死模型绕过 <code>dev_task</code> 直接 <code>git commit</code>,给仓库装一道机械钩子:</p>
337
+ <p>流程骨架不规定提交消息格式;若采用推荐配置,会写入 <code>【任务 id】【TASK】结果说明</code> 等文本约定,之后可修改或删除。文件范围门禁按所选流程与任务配置检查。可安装本地提交钩子,让普通 <code>git commit</code> 经过相同的门禁:</p>
333
338
  <pre><code>dev_task operation=install_hook # 装入 .git/hooks/commit-msg,装上后任何 git commit 都被同一套规则校验
334
339
  dev_task operation=verify_hook # 随时比对安装钩子与内置门禁的 hash,被替换/篡改立即报错</code></pre>
335
340
  <p><strong>钩子的额外硬校验(0.21/0.22):</strong>① 任务记录的流程快照带 SHA-256 hash,被手改过的快照一律拒绝提交;② 触及敏感路径(<code>.env</code>、credentials、secrets、<code>.git</code>;<code>.dsh</code> 的任务记录与流程配置由快照 hash 与豁免保护,项目级 rules/skills 属常规内容)的提交,要求任务为 <code>high_risk</code> 且验证有真实命令回执,否则拒绝;③ 删除、类型变换、重命名的旧·新路径都受范围检查。</p>
@@ -373,19 +378,19 @@ risk_level: high_risk // 涉及鉴权,验证要加证据
373
378
  <p>引擎只允许:读取仓库事实、修改<b>已确认任务范围内</b>的文件、按策略创建<b>范围受控的本地提交</b>。远程 push / 合并 / 发布、数据库写入,需人单独决定。</p>
374
379
  </div>
375
380
  <details open><summary>切换预设就是开关吗?</summary><div>是。选「工程化开发引擎」才挂 <code>dev_task</code> 和内置技能;选 <code>standard</code> 等其它预设则完全不介入。</div></details>
376
- <details><summary>想改内置 skill / rule 怎么办?</summary><div>内置正文不可被同名覆盖(同名新建会被拒)。要加团队约定,新建一个<b>不同名</b>的项目级 skill / rule 再挂到对应节点,与内置并存。</div></details>
381
+ <details><summary>想改内置 skill / rule 怎么办?</summary><div>内置正文只读;可以创建自己的技能或规则,给技能绑定规则,再把技能挂到节点。来源明确的同名资源不会互相混淆,推荐配置采用后也可自由增删。</div></details>
377
382
  <details><summary>任务文档要不要提交?</summary><div>要。<code>.dsh/task-*.json</code> 是团队共享、跨会话恢复的任务事实,随分支提交——引擎已豁免 <code>.dsh/task-*.json</code> 与 <code>.dsh/eng.json</code>,不受文件范围门拦截;忽略它别人只能看到代码,看不到确认内容和进度。</div></details>
378
383
  <details><summary>一个会话能同时做两个需求吗?</summary><div>一个任务对应一份状态文档、一个分支。新需求保存当前进度后切新分支,切回原分支即可恢复。</div></details>
379
384
  <details><summary>提交被拒是怎么回事?</summary><div>通常是四类:没建 dev_task 任务、阶段没到提交检查点、消息格式不符、提交文件不在任务范围内。按拒绝原因修正即可。</div></details>
380
- <details><summary>git 钩子能防住所有绕过吗?</summary><div>不能,这是它的定位:<code>.git/hooks/commit-msg</code> 是<b>本地即时反馈</b>,拦常规 <code>git commit</code>(校验任务、阶段、范围、消息、快照 hash、敏感路径),但挡不住 <code>git commit --no-verify</code>、<code>core.hooksPath</code> 替换或直接手改 task 记录。<b>最终可信门禁在 CI</b>:CI 里重新校验 task id、快照 hash、staged 范围、提交消息、真实验证退出码、高风险回执,并检测钩子是否被绕过。三层分工:钩子 = 本地反馈,host 工具流 = 正常路径强约束,CI = 最终验证。</div></details>
385
+ <details><summary>git 钩子能防住所有绕过吗?</summary><div>不能。<code>.git/hooks/commit-msg</code> 提供<b>本地即时反馈</b>,拦常规 <code>git commit</code>(校验任务、阶段、范围、消息、快照 hash、敏感路径),但挡不住 <code>git commit --no-verify</code>、<code>core.hooksPath</code> 替换或直接手改任务记录。若项目需要强制约束,应在自己的受保护分支和 CI 中配置独立检查;插件本身不会自动为使用者仓库安装远程 CI 门禁。</div></details>
381
386
  <details><summary>任务记录被手改会怎样?</summary><div>流程快照内容与保存的 SHA-256 不一致时会被拒绝;任务记录本身没有签名,能同时修改内容与 hash 的本地用户仍可伪造。文件版本与 <code>revision</code> 检查用于阻止并发覆盖,不提供身份认证。0.23.0 在读取内容前取得文件版本,使读取期间发生的并发写入也被拒绝。多用户隔离和可信状态签名需要 Harness 支持。</div></details>
382
387
  <details><summary>Remote 如何限制工作区?</summary><div>有 <code>workspaceRegistry.resolveByPath</code> 的 Harness 使用主机注册目录;未注册路径拒绝。旧主机保留绝对路径和系统目录检查,并提供严格注册 API。工作区注册不等于当前会话授权;共享多用户部署仍需要调用上下文和主机权限边界。</div></details>
383
388
  <details><summary>dev_task 写文件被沙箱拒绝(file access denied)怎么办?</summary><div>沙箱按调用策略放行写入,偶发的越界误判可用一次性升级重试:同一操作加 <code>sandbox_permissions: "workspace-write"(或 "danger-full-access")</code> 并配 <code>justification</code>(一句话说明原因),升级需要<b>人工批准</b>;无审批服务时直接拒绝。日常任务记录写入默认已在会话工作区内放行,通常无需升级。</div></details>
384
389
  <details><summary>「完成」等于上线了吗?</summary><div>不等于。<code>done</code> 只表示本地验证与必要评审通过;上线、合并、发布需人另行决定。</div></details>
385
390
  <p>状态查询中的 <code>evidence_blockers</code> 列出过期验证和附加技能回执;<code>commit.allowed</code> 同时检查这些阻塞及技能执行义务。<code>legal_next</code> 是流程定义的候选去向,不表示所有门禁已通过。</p>
386
391
  <details><summary>记录需求时提示字段不存在怎么办?</summary><div>先读取 <code>status.artifact_requirements</code>,按当前阶段列出的字段填写。标准需求为 <code>scope</code> 和 <code>acceptance_criteria</code>,敏捷流程只有 <code>scope</code>。疑问、假设或待确认取舍写入字段正文,不新增字段名。错误输入整次不保存,修正后再提交;不需要修改流程配置或历史任务记录。</div></details>
387
- <details><summary>验证命令被沙箱阻止怎么办?</summary><div><code>verify</code> 与 <code>skill_result</code> 默认使用会话权限。原命令被沙箱阻止后,用相同命令和 <code>sandbox_permissions: "danger-full-access"</code>、<code>justification</code> 申请单次重试。审批显示命令,批准后才执行;拒绝、取消或审批不可用时不执行、不写回执。授权只对本次调用生效,不改变会话权限。以本次回执的实际模式和退出码判断结果。</div></details>
388
- <p class="stamp">适用于插件 0.23.7 及之后 · 最后更新:2026-09-23</p>
392
+ <details><summary>验证命令被沙箱阻止怎么办?</summary><div><code>verify</code> 与 <code>skill_result</code> 默认使用会话权限。原命令被沙箱阻止后,用相同命令和 <code>sandbox_permissions: "danger-full-access"</code>、<code>justification</code> 申请单次重试。审批显示命令,批准后才执行;拒绝、取消或审批不可用时不执行、不写回执。授权只对本次调用生效,不改变会话权限。以本次回执的实际模式和退出码判断结果。</div></details>
393
+ <p class="stamp">适用于插件 0.26.1 · 最后更新:2026-09-24</p>
389
394
  </section>
390
395
  </main>
391
396
  </div>
@@ -1,21 +1,21 @@
1
- # 0.23.2 发布说明
2
-
3
- [← 文档导航](../README.md)
4
-
5
- 本版修复验证命令的单次权限审批,并统一提交消息指引。
6
-
7
- ## 验证命令在批准后执行
8
-
9
- 0.23.1 的 `verify` / `skill_result` 先运行命令,再为写入任务台账申请权限;即使用户批准 `danger-full-access`,测试命令仍可能在 `workspace-write` 下失败。实机中,`npm test` 的 Node 子进程因此报 `spawn EPERM`,任务无法完成交付验证。
10
-
11
- 本版先校验参数并取得批准,再将批准模式传给本次验证命令。审批展示实际命令与工作区;回执保存复用同一次批准。拒绝、取消或审批服务不可用时不执行命令、不写台账。后续调用继续使用原会话策略。`verify` / `skill_result` 的调用字段保持兼容。
12
-
13
- ## 提交指引与引擎一致
14
-
15
- 内置流程的第一组括号填写当前任务 id,第二组使用 `status.commit.label`,例如 `【DSH-REG-R03】【TASK】实现批次统计 CLI`。规则与手册不再把模块名写成第一段;自定义格式仍由任务冻结流程决定。
16
-
17
- ## 验证范围与管控边界
18
-
19
- 实机测试使用独立 `dshtest` 仓库与标准流程,由 DSH 编写业务代码,观察者审阅审批、执行独立验收并修复插件。每轮业务代码、任务台账与会话日志保留在本地归档,完成轮次回退到同一空业务基线。结果与干预见[测试报告](../testing/0.23.2/测试报告.md)。本次不代表 QMS 页面、数据库或生产环境验收。
20
-
21
- 插件控制 `dev_task` 的阶段、证据与提交登记;通用文件编辑工具不会逐次经过该状态机,模型也可能错误解读证据。直接 Git 提交的机械约束需要安装[提交钩子](../manual.html),本次独立业务轮次验证的是通过 `dev_task` 完成的受控路径。不要把技能指引等同于对所有工具调用的强制拦截。
1
+ # 0.23.2 发布说明
2
+
3
+ [← 文档导航](../README.md)
4
+
5
+ 本版修复验证命令的单次权限审批,并统一提交消息指引。
6
+
7
+ ## 验证命令在批准后执行
8
+
9
+ 0.23.1 的 `verify` / `skill_result` 先运行命令,再为写入任务台账申请权限;即使用户批准 `danger-full-access`,测试命令仍可能在 `workspace-write` 下失败。实机中,`npm test` 的 Node 子进程因此报 `spawn EPERM`,任务无法完成交付验证。
10
+
11
+ 本版先校验参数并取得批准,再将批准模式传给本次验证命令。审批展示实际命令与工作区;回执保存复用同一次批准。拒绝、取消或审批服务不可用时不执行命令、不写台账。后续调用继续使用原会话策略。`verify` / `skill_result` 的调用字段保持兼容。
12
+
13
+ ## 提交指引与引擎一致
14
+
15
+ 内置流程的第一组括号填写当前任务 id,第二组使用 `status.commit.label`,例如 `【DSH-REG-R03】【TASK】实现批次统计 CLI`。规则与手册不再把模块名写成第一段;自定义格式仍由任务冻结流程决定。
16
+
17
+ ## 验证范围与管控边界
18
+
19
+ 实机测试使用独立 `dshtest` 仓库与标准流程,由 DSH 编写业务代码,观察者审阅审批、执行独立验收并修复插件。每轮业务代码、任务台账与会话日志保留在本地归档,完成轮次回退到同一空业务基线。结果与干预见[测试报告](../testing/0.23.2/测试报告.md)。本次不代表 QMS 页面、数据库或生产环境验收。
20
+
21
+ 插件控制 `dev_task` 的阶段、证据与提交登记;通用文件编辑工具不会逐次经过该状态机,模型也可能错误解读证据。直接 Git 提交的机械约束需要安装[提交钩子](../manual.html),本次独立业务轮次验证的是通过 `dev_task` 完成的受控路径。不要把技能指引等同于对所有工具调用的强制拦截。