@godv61/dsh-task-engine 0.26.1 → 0.27.1

package/docs/manual.html

@@ -35,9 +35,9 @@
   <header class="hero">
     <p class="eyebrow">DSH · ENGINEERING DELIVERY ENGINE</p>
     <h1>工程化交付引擎 使用手册</h1>
-    <p class="lead">这是一套装在 DeepSeek Harness 里的工程流程约束。流程预设规定阶段与门禁；技能、规则、提交文本和产物字段由使用者配置。在个人工作台里选择流程，把规则配置在技能下，再把技能挂到相应阶段。</p>
+    <p class="lead">这是一套装在 DeepSeek Harness 里的工程流程约束。流程预设规定阶段与门禁；技能、规则、提交文本和产物字段由使用者配置。在个人工作台里选择流程，把规则配置在技能下，再把技能挂到相应阶段。</p>
     <div class="badges">
-      <span class="badge">流程与工作方法分离</span>
+      <span class="badge">流程与工作方法分离</span>
       <span class="badge">standard / agile / minimal</span>
       <span class="badge">需求、方案人工确认</span>
       <span class="badge">范围受控本地提交</span>
@@ -72,17 +72,15 @@
         <pre><code>开发请求
   → dev_task（统一入口，硬约束在代码里执行）
   → eng-delivery（编排：读状态 → 选阶段 → 推进）
-      → 需求评审 · requirement-analysis
-      → 设计     · solution-design
-      → 开发     · code-implement
-      → 交付     · code-verify
-      → 代码审核 · code-review + code-commit</code></pre>
+      → 按所选流程进入当前阶段
+      → 读取该阶段由使用者绑定的技能和规则
+      → 检查门禁并推进到下一阶段</code></pre>
         <div class="callout">
           <p><strong>它不是常驻程序。</strong>只有你在「工程化开发引擎」预设的会话里提出开发请求时，才触发 <code>dev_task</code> 和这套门禁；换到别的预设，流程完全不介入。</p>
         </div>
-        <p>三样东西分工明确：<strong>流程预设</strong>决定「走哪条流水线、有哪些守卫」，<strong>Skill</strong> 决定「这一站做什么」，<strong>Rule</strong> 归属技能，决定该技能遵守什么。任务状态单独落盘，负责「跨会话恢复到哪一步」。推荐配置需要显式采用；采用后完全由使用者增删修改。</p>
+        <p>三样东西分工明确：<strong>流程预设</strong>决定「走哪条流水线、有哪些守卫」，<strong>Skill</strong> 决定「这一站做什么」，<strong>Rule</strong> 归属技能，决定该技能遵守什么。任务状态单独落盘，负责「跨会话恢复到哪一步」。推荐配置需要显式采用；采用后完全由使用者增删修改。</p>
         <div class="callout warn">
-          <p><strong>诚实边界：</strong>阶段流转、文件范围、任务绑定、流程快照 hash、钩子完整性、敏感路径风险策略是<b>代码硬校验</b>；提交格式仅在用户配置后校验。高风险任务的验证依据真实命令回执。审核结论、实施项完成及回执命令的覆盖面仍需人工或 CI 判断；需求确认、方案确认和风险降级由人工批准。</p>
+          <p><strong>诚实边界：</strong>阶段流转、文件范围、任务绑定、流程快照 hash、钩子完整性、敏感路径风险策略是<b>代码硬校验</b>；提交格式仅在用户配置后校验。高风险任务的验证依据真实命令回执。审核结论、实施项完成及回执命令的覆盖面仍需人工或 CI 判断；需求确认、方案确认和风险降级由人工批准。</p>
         </div>
       </section>
 
@@ -107,7 +105,7 @@ pnpm install &amp;&amp; pnpm run build &amp;&amp; pnpm dsh web</code></pre>
         <p><code>dsh plugin --profile &lt;name&gt; add &lt;package&gt;</code> 会在 <code>$DSH_HOME/profiles/&lt;name&gt;/</code> 里执行 <code>pnpm add</code>，并自动识别插件声明的 <code>dsh.bundle.patch</code>，把它挂进该 profile 的插件层栈——<b>不要</b>手写 <code>npm i</code> 装到别处，那样不会挂载。</p>
         <p>装完<b>重启 <code>dsh web</code></b> 生效，自动完成两件事：侧边栏多出「工程流程」工作台；预设列表多出「工程化开发引擎」。</p>
         <h3>2.4 启用</h3>
-        <p>新建会话 → 预设选「工程化开发引擎」。这个会话就挂上 <code>dev_task</code> + 内置技能 + 工程人设，开始按流程走。</p>
+        <p>新建会话 → 预设选「工程化开发引擎」。这个会话会启用 <code>dev_task</code> 与编排技能 <code>eng-delivery</code>，按配置的流程走。</p>
         <div class="callout"><p>想「正式开发」就选它；想「让 AI 自由探索」就选 <code>standard</code>。切换预设本身就是开关，零配置。</p></div>
       </section>
 
@@ -116,7 +114,7 @@ pnpm install &amp;&amp; pnpm run build &amp;&amp; pnpm dsh web</code></pre>
         <pre><code>D:\workspace\
 ├─ AGENTS.md       ← init 生成的项目描述（DSH 每会话自动注入）
 ├─ .dsh\
-│  ├─ eng.json       ← 流程预设 + 节点技能 + 技能规则（团队共享，可进 git）
+│  ├─ eng.json       ← 流程预设 + 节点技能 + 技能规则（团队共享，可进 git）
 │  ├─ skills\        ← 项目级 skill
 │  ├─ rules\         ← 项目级 rule
 │  └─ task-*.json    ← 每个任务的状态快照
@@ -127,11 +125,12 @@ pnpm install &amp;&amp; pnpm run build &amp;&amp; pnpm dsh web</code></pre>
           <table>
             <thead><tr><th>路径</th><th>作用</th><th>何时读取或修改</th></tr></thead>
             <tbody>
-              <tr><td><code>.dsh/eng.json</code></td><td>流程、阶段技能引用及技能规则配置</td><td>新任务创建时读取并冻结；工作台保存时写入</td></tr>
-              <tr><td><code>.dsh/skills/</code></td><td>项目级 skill（团队共享）</td><td>节点挂载命中时按需读取</td></tr>
+              <tr><td><code>.dsh/eng.json</code></td><td>流程、阶段技能引用及技能规则配置</td><td>新任务创建时读取并冻结；工作台保存时写入</td></tr>
+              <tr><td><code>.dsh/skills/</code></td><td>项目级 DSH skill（团队共享）</td><td>新建默认写入这里；节点挂载命中时按需读取</td></tr>
+              <tr><td><code>.agents/skills/</code></td><td>项目级 Codex skill（团队共享）</td><td>工作台自动发现；通过 dev_task load_skill 读取技能与所挂规则</td></tr>
               <tr><td><code>.dsh/rules/</code></td><td>项目级 rule（团队共享）</td><td>节点挂载命中时按需读取</td></tr>
               <tr><td><code>.dsh/task-*.json</code></td><td>当前任务的有效状态快照</td><td>确认、实施、验证、评审、切换阶段时更新</td></tr>
-              <tr><td><code>$DSH_HOME/skills/ · rules/</code></td><td>用户级 skill / rule</td><td>引用显式记录来源，同名资源互不混淆</td></tr>
+              <tr><td><code>$DSH_HOME/skills/ · rules/</code></td><td>用户级 skill / rule</td><td>引用显式记录来源，同名资源互不混淆</td></tr>
             </tbody>
           </table>
         </div>
@@ -139,14 +138,14 @@ pnpm install &amp;&amp; pnpm run build &amp;&amp; pnpm dsh web</code></pre>
 
       <section id="flows">
         <h2>4. 三套流程预设</h2>
-        <p>阶段图和流转门禁随预设固化；提交消息格式、产物字段及技能规则由使用者配置。需要一份起点时，可显式「采用推荐配置」。</p>
+        <p>阶段图和流转门禁随预设固化；提交消息格式、产物字段及技能规则由使用者配置。需要一份起点时，可显式「采用推荐配置」。</p>
         <div class="table-wrap">
           <table>
             <thead><tr><th>预设</th><th>阶段顺序</th><th>适用</th><th>守卫强度</th></tr></thead>
             <tbody>
-              <tr><td><code>standard</code> 完整研发</td><td>需求评审 → 设计 → 开发 → 交付 → 代码审核 → 完成</td><td>新功能、跨模块及高风险任务</td><td>人工确认 + 验证门 + 评审门</td></tr>
-              <tr><td><code>agile</code> 日常迭代</td><td>需求 → 开发 → 交付 → 审查</td><td>常规功能与缺陷修复</td><td>四阶段，终态需审查通过</td></tr>
-              <tr><td><code>minimal</code> 快速修改</td><td>开发 → 交付</td><td>局部低风险改动</td><td>实施项与交付门禁</td></tr>
+              <tr><td><code>standard</code> 完整研发</td><td>需求评审 → 设计 → 开发 → 交付 → 代码审核 → 完成</td><td>新功能、跨模块及高风险任务</td><td>人工确认 + 验证门 + 评审门</td></tr>
+              <tr><td><code>agile</code> 日常迭代</td><td>需求 → 开发 → 交付 → 审查</td><td>常规功能与缺陷修复</td><td>四阶段，终态需审查通过</td></tr>
+              <tr><td><code>minimal</code> 快速修改</td><td>开发 → 交付</td><td>局部低风险改动</td><td>实施项与交付门禁</td></tr>
             </tbody>
           </table>
         </div>
@@ -159,18 +158,12 @@ pnpm install &amp;&amp; pnpm run build &amp;&amp; pnpm dsh web</code></pre>
 
       <section id="skills">
         <h2>5. Skills：这一步做什么</h2>
-        <p>每个内置 Skill 尺寸很小、只做一件事。挂到对应节点后，走到那一步才加载，不会一次性全塞给模型。</p>
+        <p>插件仅内置 <code>eng-delivery</code>，用于会话编排。项目级与用户级业务技能由使用者自行创建或安装；工作台也可发现当前项目 <code>.agents/skills</code> 中已有的 Codex 技能。挂到节点后，走到那一步才加载。</p>
         <div class="table-wrap">
           <table>
             <thead><tr><th>Skill</th><th>职责</th><th>不负责</th></tr></thead>
             <tbody>
               <tr><td><code>eng-delivery</code></td><td>读任务状态、按阶段推进、确保不越轨</td><td>代替各阶段 Skill 的专业工作</td></tr>
-              <tr><td><code>requirement-analysis</code></td><td>目标、验收、非目标，落需求说明，等人确认</td><td>编码</td></tr>
-              <tr><td><code>solution-design</code></td><td>最小方案、技术基线、改动点，落设计文档</td><td>实现</td></tr>
-              <tr><td><code>code-implement</code></td><td>实现、做「规格 + 质量」两阶段评审，都过才标完成</td><td>无关重构</td></tr>
-              <tr><td><code>code-verify</code></td><td>按验收与风险验证、记录结果（高风险必须跑真实命令回执）</td><td>掩盖失败或自动修复</td></tr>
-              <tr><td><code>code-commit</code></td><td>校验阶段、范围、消息格式后提交</td><td>远程 push / 合并 / 发布</td></tr>
-              <tr><td><code>code-review</code></td><td>评审变更，落结论与问题清单</td><td>代替实现或验证</td></tr>
             </tbody>
           </table>
         </div>
@@ -178,46 +171,35 @@ pnpm install &amp;&amp; pnpm run build &amp;&amp; pnpm dsh web</code></pre>
 
       <section id="rules">
         <h2>6. Rules：这一步守什么</h2>
-        <p>Rule 是纯正文的约束，配置在技能下。节点引用技能，任务走到该节点时才读取技能及其规则；预设不会自动绑定它们。内置示例有：</p>
-        <div class="table-wrap">
-          <table>
-            <thead><tr><th>Rule</th><th>约束内容</th><th>典型触发</th></tr></thead>
-            <tbody>
-              <tr><td><code>coding-conventions</code></td><td>编码规范：复用优先、禁空 catch、禁全表更新等</td><td>写代码</td></tr>
-              <tr><td><code>commit-conventions</code></td><td>提交消息格式、只提交任务内文件、禁止 push / 合并 / 发布</td><td>本地提交</td></tr>
-              <tr><td><code>security-redlines</code></td><td>敏感数据、危险动作和权限边界</td><td>所有写操作</td></tr>
-            </tbody>
-          </table>
-        </div>
-        <p>内置资源只是可选示例，正文只读。团队可以创建自己的技能和规则，把规则绑定到技能，再决定哪些节点使用该技能；提交消息格式应在项目配置中设置。</p>
+        <p>Rule 是纯正文的约束，配置在技能下。节点引用技能，任务走到该节点时才读取技能及其规则的最新正文；预设不会自动绑定它们。插件不内置业务规则。团队可创建自己的技能和共享规则，再决定哪些节点使用技能；提交消息格式在项目配置中设置。</p>
       </section>
 
       <section id="configure">
-        <p>当前版本支持三个内置流程，阶段可选择技能，技能可绑定规则。可视化自定义流程不在当前计划内。</p>
+        <p>当前版本支持三个内置流程，阶段可选择技能，技能可绑定规则。可视化自定义流程不在当前计划内。</p>
         <h2>7. 配置流程与挂载</h2>
         <p>侧边栏点「工程流程」打开工作台，五个标签页：<strong>项目初始化 / 流程配置 / 任务 / 技能 skill / 规则 rule</strong>，默认落在「项目初始化」（详见第 8 节）。日常配流程只需在「流程配置」页做两件事：</p>
         <ol>
-          <li><strong>选流程预设</strong>：standard / agile / minimal；如需现成起点，可单独点击「采用推荐配置」。</li>
-          <li><strong>给节点选技能</strong>：先选节点，再用双栏选择器挑选技能；点技能的规则配置，在右侧栏绑定规则与证据类型，最后保存。</li>
+          <li><strong>选流程预设</strong>：standard / agile / minimal；如需现成起点，可单独点击「采用推荐配置」。</li>
+          <li><strong>给节点选技能</strong>：先选节点，再用双栏选择器挑选技能；点技能的规则配置，在右侧栏绑定规则与证据类型，最后保存。</li>
         </ol>
-        <p>「技能」和「规则」页提供搜索、来源筛选、新建、安装、查看、编辑与删除。内置资源是只读样本，可点「以此为模板新建」预填可编辑副本；副本的完成凭证、规则与阶段绑定需另行配置。点「安装技能」直接打开系统文件选择器，选择含 <code>SKILL.md</code> 的文件夹；点「安装规则」选择一个 <code>.md</code> 文件。选择后先显示预览：名称、正文、文件数、体积、目标路径和同名冲突。确认项目或个人范围后点击「确认安装」；预览本身不写入文件，改变范围后需要重新预览。</p>
-        <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>
+        <p>「技能」和「规则」页提供搜索、来源筛选、新建、安装、查看、编辑与删除。点「安装技能」选择含 <code>SKILL.md</code> 的文件夹；点「安装规则」选择一个 <code>.md</code> 文件。选择后先显示预览：名称、正文、文件数、体积、目标路径和同名冲突。确认项目或个人范围后点击「确认安装」；预览本身不写入文件，改变范围后需要重新预览。</p>
+        <p>新建项目资源默认写入工作区 <code>.dsh/skills</code> 或 <code>.dsh/rules</code>；个人资源写入 <code>$DSH_HOME</code> 对应目录。当前项目 <code>.agents/skills</code> 中已有的 Codex 技能也会显示，其正文在工作台只读，可编辑原文件；规则仍配置在该技能下，规则正文可引用项目 <code>.dsh/rules</code>。浏览器选择的是浏览器所在电脑的文件；高级目录模式读取 Harness 主机的目录。技能保留脚本、references、模板和二进制资源，排除常见缓存；上限 1000 文件、100 MB、单文件 20 MB、20 层目录，<code>SKILL.md</code> 和规则正文上限 1 MB。拒绝覆盖同名资源；主机扫描拒绝符号链接和 junction。浏览器上传不提供源链接元数据。</p>
         <p>资源删除前会显示名称与实际目标路径，确认后永久删除；可点击「保留」取消。任务台账支持搜索、风险与阶段筛选，并显示验证、审核和更新时间。流程配置读取与保存失败时显示错误，损坏任务记录不会被静默视为没有任务。</p>
         <pre><code>// .dsh/eng.json 等价内容
 {
   "flow": "standard",
   "stage_bindings": {
-    "开发": { "skill_refs": [{ "source": "bundled", "name": "code-implement" }] }
-  },
-  "skill_profiles": {
-    "bundled:code-implement": {
-      "rules": [{ "source": "project", "name": "my-coding-rule" }],
-      "evidence": "none"
-    }
-  }
-}</code></pre>
+    "开发": { "skill_refs": [{ "source": "project", "name": "my-implementation" }] }
+  },
+  "skill_profiles": {
+    "project:my-implementation": {
+      "rules": [{ "source": "project", "name": "my-coding-rule" }],
+      "evidence": "none"
+    }
+  }
+}</code></pre>
         <div class="callout warn"><p>页面实时校验：挂到不存在的阶段、空名等会红字提示并置灰保存；保存前主机再校验一遍。错误的配置存不进去。</p></div>
-        <p>技能和规则引用包含 <code>source</code> 与 <code>name</code>；内置、项目、用户目录中的同名资源可以区分。旧版节点级规则迁移时会保留为待分配规则并继续生效，建议逐条归到对应技能。</p>
+        <p>技能和规则引用包含 <code>source</code> 与 <code>name</code>；内置、项目、用户目录中的同名资源可以区分。旧版节点级规则迁移时会保留为待分配规则并继续生效，建议逐条归到对应技能。</p>
       </section>
 
       <section id="init">
@@ -277,7 +259,7 @@ pnpm install &amp;&amp; pnpm run build &amp;&amp; pnpm dsh web</code></pre>
             </tbody>
           </table>
         </div>
-        <p>新任务离开阶段前检查绑定技能是否成功加载；技能可以声明 <code>command</code>、<code>artifact</code>、<code>review</code>、<code>manual</code> 或 <code>none</code> 证据类型。只有需要命令回执的技能才出现在 <code>command_receipts_required</code> 中。挂在终态的技能在进入终态前执行。命令成功只证明该命令通过，不证明覆盖完整；文件变动后须重新验证。旧任务继续使用冻结快照。</p>
+        <p>新任务离开阶段前检查绑定技能是否成功加载；Codex 项目技能通过 <code>dev_task load_skill</code> 加载其正文及所挂规则。技能可以声明 <code>command</code>、<code>artifact</code>、<code>review</code>、<code>manual</code> 或 <code>none</code> 证据类型。只有需要命令回执的技能才出现在 <code>command_receipts_required</code> 中。挂在终态的技能在进入终态前执行。命令成功只证明该命令通过，不证明覆盖完整；文件变动后须重新验证。任务的流程配置按创建时的快照执行，Skill/Rule 正文在下一次交互读取最新版本。</p>
         <h3>贯穿全程的硬规则</h3>
         <ul>
           <li>阶段是硬状态：status 说你在哪，就只做那一步，绝不倒带重走、绝不跳。</li>
@@ -318,7 +300,7 @@ pnpm install &amp;&amp; pnpm run build &amp;&amp; pnpm dsh web</code></pre>
           <li>差异没变时复用有效证据，不重复跑相同命令。</li>
           <li>无法联调外部系统时必须如实写「未联调」，不能把编译成功说成功能通过。</li>
           <li><code>high_risk</code> 任务过验证门必须跑真实命令回执（引擎运行命令、取退出码，非自报通过）。</li>
-          <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>
+          <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>
           <li><b>验证命令始终在任务记录的项目根运行</b>（任务创建时自动发现并固化 <code>root</code>），不是会话当前目录——monorepo 里会话停在子目录时，<code>npm test</code> 等也会在放清单文件的项目根执行；回执记录的 <code>root</code> 与任务根强校验，不一致直接拒绝。</li>
         </ul>
         <h3>评审</h3>
@@ -334,7 +316,7 @@ pnpm install &amp;&amp; pnpm run build &amp;&amp; pnpm dsh web</code></pre>
             </tbody>
           </table>
         </div>
-        <p>流程骨架不规定提交消息格式；若采用推荐配置，会写入 <code>【任务 id】【TASK】结果说明</code> 等文本约定，之后可修改或删除。文件范围门禁按所选流程与任务配置检查。可安装本地提交钩子，让普通 <code>git commit</code> 经过相同的门禁：</p>
+        <p>流程骨架不规定提交消息格式；若采用推荐配置，会写入 <code>【任务 id】【TASK】结果说明</code> 等文本约定，之后可修改或删除。文件范围门禁按所选流程与任务配置检查。可安装本地提交钩子，让普通 <code>git commit</code> 经过相同的门禁：</p>
         <pre><code>dev_task operation=install_hook   # 装入 .git/hooks/commit-msg，装上后任何 git commit 都被同一套规则校验
 dev_task operation=verify_hook    # 随时比对安装钩子与内置门禁的 hash，被替换/篡改立即报错</code></pre>
         <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>
@@ -377,12 +359,12 @@ risk_level: high_risk   // 涉及鉴权，验证要加证据
         <div class="callout danger">
           <p>引擎只允许：读取仓库事实、修改<b>已确认任务范围内</b>的文件、按策略创建<b>范围受控的本地提交</b>。远程 push / 合并 / 发布、数据库写入，需人单独决定。</p>
         </div>
-        <details open><summary>切换预设就是开关吗？</summary><div>是。选「工程化开发引擎」才挂 <code>dev_task</code> 和内置技能；选 <code>standard</code> 等其它预设则完全不介入。</div></details>
-        <details><summary>想改内置 skill / rule 怎么办？</summary><div>内置正文只读；可以创建自己的技能或规则，给技能绑定规则，再把技能挂到节点。来源明确的同名资源不会互相混淆，推荐配置采用后也可自由增删。</div></details>
+        <details open><summary>切换预设就是开关吗？</summary><div>是。选「工程化开发引擎」才启用 <code>dev_task</code> 与编排技能；工作台中的 <code>standard</code>、<code>agile</code>、<code>minimal</code> 则选择该工具使用的流程骨架。</div></details>
+        <details><summary>技能和规则由谁提供？</summary><div>插件只内置用于会话编排的 <code>eng-delivery</code>。项目或个人技能与规则由你创建或安装；规则挂在技能下，再把技能挂到节点。空绑定时流程门禁照常运行。</div></details>
         <details><summary>任务文档要不要提交？</summary><div>要。<code>.dsh/task-*.json</code> 是团队共享、跨会话恢复的任务事实，随分支提交——引擎已豁免 <code>.dsh/task-*.json</code> 与 <code>.dsh/eng.json</code>，不受文件范围门拦截；忽略它别人只能看到代码，看不到确认内容和进度。</div></details>
         <details><summary>一个会话能同时做两个需求吗？</summary><div>一个任务对应一份状态文档、一个分支。新需求保存当前进度后切新分支，切回原分支即可恢复。</div></details>
         <details><summary>提交被拒是怎么回事？</summary><div>通常是四类：没建 dev_task 任务、阶段没到提交检查点、消息格式不符、提交文件不在任务范围内。按拒绝原因修正即可。</div></details>
-        <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>
+        <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>
         <details><summary>任务记录被手改会怎样？</summary><div>流程快照内容与保存的 SHA-256 不一致时会被拒绝；任务记录本身没有签名，能同时修改内容与 hash 的本地用户仍可伪造。文件版本与 <code>revision</code> 检查用于阻止并发覆盖，不提供身份认证。0.23.0 在读取内容前取得文件版本，使读取期间发生的并发写入也被拒绝。多用户隔离和可信状态签名需要 Harness 支持。</div></details>
         <details><summary>Remote 如何限制工作区？</summary><div>有 <code>workspaceRegistry.resolveByPath</code> 的 Harness 使用主机注册目录；未注册路径拒绝。旧主机保留绝对路径和系统目录检查，并提供严格注册 API。工作区注册不等于当前会话授权；共享多用户部署仍需要调用上下文和主机权限边界。</div></details>
         <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>
@@ -390,7 +372,7 @@ risk_level: high_risk   // 涉及鉴权，验证要加证据
         <p>状态查询中的 <code>evidence_blockers</code> 列出过期验证和附加技能回执；<code>commit.allowed</code> 同时检查这些阻塞及技能执行义务。<code>legal_next</code> 是流程定义的候选去向，不表示所有门禁已通过。</p>
         <details><summary>记录需求时提示字段不存在怎么办？</summary><div>先读取 <code>status.artifact_requirements</code>，按当前阶段列出的字段填写。标准需求为 <code>scope</code> 和 <code>acceptance_criteria</code>，敏捷流程只有 <code>scope</code>。疑问、假设或待确认取舍写入字段正文，不新增字段名。错误输入整次不保存，修正后再提交；不需要修改流程配置或历史任务记录。</div></details>
         <details><summary>验证命令被沙箱阻止怎么办？</summary><div><code>verify</code> 与 <code>skill_result</code> 默认使用会话权限。原命令被沙箱阻止后，用相同命令和 <code>sandbox_permissions: "danger-full-access"</code>、<code>justification</code> 申请单次重试。审批显示命令，批准后才执行；拒绝、取消或审批不可用时不执行、不写回执。授权只对本次调用生效，不改变会话权限。以本次回执的实际模式和退出码判断结果。</div></details>
-        <p class="stamp">适用于插件 0.26.1 · 最后更新：2026-09-24</p>
+        <p class="stamp">适用于当前研发版 · 最后更新：2026-09-26</p>
       </section>
     </main>
   </div>

package/docs/resource-install.md

@@ -23,9 +23,11 @@
 
 | 范围 | 技能 | 规则 |
 | :--- | :--- | :--- |
-| 项目 | 工作区 `.dsh/skills` | 工作区 `.dsh/rules` |
-| 个人 | `$DSH_HOME/skills` | `$DSH_HOME/rules` |
-
+| 项目 | 工作区 `.dsh/skills` | 工作区 `.dsh/rules` |
+| 个人 | `$DSH_HOME/skills` | `$DSH_HOME/rules` |
+
+工作台还会自动发现当前项目 `.agents/skills/<名称>/SKILL.md` 中的 Codex 技能。它保留在原目录，正文可查看；要改正文请编辑原文件。可在 DSH 工作台给该技能挂多条 `.dsh/rules` 规则；新建技能和规则仍默认存入 `.dsh`。
+
 `DSH_HOME` 默认是用户主目录下的 `.dsh`。删除确认框显示实际路径；确认删除后不经过回收站。内置资源只读，项目和个人资源可以查看、编辑和删除。
 
 ## 格式与大小限制

package/docs/roadmap.md

@@ -10,7 +10,7 @@
 | 能力 | 状态 |
 | :--- | :--- |
 | 三个内置流程（`standard`、`agile`、`minimal`） | ✅ 已发布，开箱即用 |
-| 阶段选择技能、规则归属技能 | ✅ 已发布 |
+| 阶段选择技能、规则归属技能 | ✅ 已发布 |
 | 任务台账、验证与审核回执、提交门禁 | ✅ 已发布 |
 | 项目级与个人级资源安装、来源保留 | ✅ 已发布 |
 | **自由编辑流程阶段与条件** | ❌ **不在计划内** |
@@ -31,4 +31,4 @@
 ## 产品范围
 
 本项目服务本机个人开发工作台。多用户服务器的会话权限架构不列为当前版本的必修项。日常改进优先
-解决工作区目标清晰、文件误操作、任务连续性和操作反馈。
+解决工作区目标清晰、文件误操作、任务连续性和操作反馈。

package/hooks/commit-msg

@@ -158,10 +158,6 @@ function checkFileScope(state2, committing, config2) {
 }
 
 // src/workflows.ts
-function bundled(skill, ...rules) {
-  const ref = (name) => ({ source: "bundled", name });
-  return { skill: ref(skill), rules: rules.map(ref) };
-}
 var STANDARD = {
   stages: ["\u9700\u6C42\u8BC4\u5BA1", "\u8BBE\u8BA1", "\u5F00\u53D1", "\u4EA4\u4ED8", "\u4EE3\u7801\u5BA1\u6838", "\u5B8C\u6210"],
   start_stage: "\u9700\u6C42\u8BC4\u5BA1",
@@ -188,19 +184,7 @@ var STANDARD_RECOMMENDATION = {
     { stage: "\u9700\u6C42\u8BC4\u5BA1", id: "requirement", name: "\u9700\u6C42\u8BF4\u660E", fields: ["scope", "acceptance_criteria"] },
     { stage: "\u8BBE\u8BA1", id: "design", name: "\u8BBE\u8BA1\u6587\u6863", fields: ["approach", "risks", "impact"] },
     { stage: "\u4EE3\u7801\u5BA1\u6838", id: "review", name: "\u8BC4\u5BA1\u8BB0\u5F55", fields: ["conclusion", "issues"] }
-  ],
-  stage_bindings: {
-    "\u9700\u6C42\u8BC4\u5BA1": { skills: [bundled("requirement-analysis", "security-redlines")] },
-    "\u8BBE\u8BA1": { skills: [bundled("solution-design")] },
-    "\u5F00\u53D1": { skills: [bundled("code-implement", "coding-conventions", "security-redlines")] },
-    "\u4EA4\u4ED8": { skills: [bundled("code-verify")] },
-    "\u4EE3\u7801\u5BA1\u6838": {
-      skills: [
-        bundled("code-review", "coding-conventions", "security-redlines"),
-        bundled("code-commit", "commit-conventions")
-      ]
-    }
-  }
+  ]
 };
 var AGILE = {
   stages: ["\u9700\u6C42", "\u5F00\u53D1", "\u4EA4\u4ED8", "\u5BA1\u67E5"],
@@ -234,18 +218,9 @@ var AGILE_RECOMMENDATION = {
   },
   artifacts: [
     { stage: "\u9700\u6C42", id: "requirement", name: "\u9700\u6C42\u8BF4\u660E", fields: ["scope"] },
-    // The 审查 stage binds code-review, whose instructions write this artifact with
-    // `record artifact=review`. Declaring it keeps that binding executable: the
-    // engine refuses an undeclared artifact, so a bound skill pointing at one would
-    // be a contract the recommendation made impossible to satisfy.
+    // Optional review record; the flow's review gate itself does not require a skill.
     { stage: "\u5BA1\u67E5", id: "review", name: "\u8BC4\u5BA1\u8BB0\u5F55", fields: ["conclusion", "issues"] }
-  ],
-  stage_bindings: {
-    "\u9700\u6C42": { skills: [bundled("requirement-analysis", "security-redlines")] },
-    "\u5F00\u53D1": { skills: [bundled("code-implement", "coding-conventions", "security-redlines")] },
-    "\u4EA4\u4ED8": { skills: [bundled("code-verify"), bundled("code-commit", "commit-conventions")] },
-    "\u5BA1\u67E5": { skills: [bundled("code-review", "coding-conventions", "security-redlines")] }
-  }
+  ]
 };
 var MINIMAL = {
   stages: ["\u5F00\u53D1", "\u4EA4\u4ED8"],
@@ -261,11 +236,7 @@ var MINIMAL_RECOMMENDATION = {
   // A fast-change flow checks each change once, not twice under two headings a
   // short change rarely distinguishes. The item still has to be reviewed — what
   // drops is the duplicated verdict, which is where the weight actually was.
-  review_depth: "single",
-  stage_bindings: {
-    "\u5F00\u53D1": { skills: [bundled("code-implement", "coding-conventions", "security-redlines")] },
-    "\u4EA4\u4ED8": { skills: [bundled("code-commit", "commit-conventions")] }
-  }
+  review_depth: "single"
 };
 function deriveCapabilities(config2) {
   const caps = [];