@godv61/dsh-task-engine 0.26.1 → 0.27.1

package/.workflow-test.mjs

@@ -4,10 +4,20 @@ import { mkdtempSync, mkdirSync, writeFileSync, rmSync } from 'node:fs'
 import { tmpdir } from 'node:os'
 import { join, resolve, sep } from 'node:path'
 import { registerDevTask } from './lib/dev-task.js'
-import { newTask } from './lib/engine.js'
-import { adoptRecommendation, resolveFlow } from './lib/workflows.js'
-import Controller from './lib/controller.js'
-import { registerShippedSkills } from './lib/shipped-skills.js'
+import { newTask, validateWorkflow } from './lib/engine.js'
+import { adoptRecommendation, resolveFlow, retainStageBindings } from './lib/workflows.js'
+import Controller from './lib/controller.js'
+import { registerShippedSkills } from './lib/shipped-skills.js'
+
+test('switching to minimal drops only stages outside its graph', () => {
+  const requirement = { skills: [{ skill: { source: 'project', name: 'requirements' }, rules: [] }] }
+  const development = { skills: [{ skill: { source: 'project', name: 'implement' }, rules: [] }] }
+  const result = retainStageBindings('minimal', { '需求': requirement, '开发': development })
+  assert.deepEqual(result.dropped, ['需求'])
+  assert.deepEqual(result.bindings, { '开发': development })
+  const resolved = resolveFlow('minimal', { flow: 'minimal', stage_bindings: result.bindings })
+  assert.deepEqual(validateWorkflow(resolved.config), [])
+})
 
 /**
  * The preset as a project would actually run it: the skeleton plus the shipped
@@ -24,7 +34,7 @@ function adoptedFlow(id, extra) {
 }
 
 
-function fixture(stage = '开发', extra = {}, services = {}) {
+function fixture(stage = '开发', extra = {}, services = {}) {
   const cwd = resolve('test-project')
   // A project running the standard flow: the skeleton plus the adopted
   // recommendation, with one extra skill mounted on 完成 for the tests that need
@@ -36,12 +46,15 @@ function fixture(stage = '开发', extra = {}, services = {}) {
     ...adopted,
     stage_bindings: {
       ...adopted.stage_bindings,
-      完成: { skills: [{ skill: { source: 'bundled', name: 'software-testing' }, rules: [] }] },
+      完成: { skills: [{ skill: { source: 'project', name: 'software-testing' }, rules: [] }] },
     },
   }).config
   const state = newTask({ id: 'LIVE-1', title: 'EAM regression', branch: 'test', work_size: 'standard', risk_level: 'standard', flow: { flow: 'standard', version: 3, config }, root: cwd })
   Object.assign(state, { stage, execution_version: 1, files: ['app.js'], requirement_confirmed: true, solution_confirmed: true, ...extra })
-  const records = new Map([[join(cwd, '.dsh/task-LIVE-1.json'), JSON.stringify(state)], [join(cwd, 'app.js'), 'source']])
+  const records = new Map([[join(cwd, '.dsh/task-LIVE-1.json'), JSON.stringify(state)],
+    [join(cwd, 'app.js'), 'source'],
+    [join(cwd, '.dsh/skills/software-testing/SKILL.md'), 'test instructions'],
+    [join(cwd, '.dsh/skills/human-check/SKILL.md'), 'manual check instructions']])
   const events = [], runs = []
   const session = { id: 'test-session', header: { cwd }, snapshotEvents: () => events }
   const policy = { mode: 'workspace-write', workspaceRoot: cwd, sessionId: session.id }
@@ -73,93 +86,99 @@ function fixture(stage = '开发', extra = {}, services = {}) {
   }
   return { call: args => execute(JSON.parse(JSON.stringify({ task_id: 'LIVE-1', ...args })), exec), load, runs, policy, exec, records, cwd,
     state: () => JSON.parse(records.get(join(cwd, '.dsh/task-LIVE-1.json'))) }
-}
-
-test('manual skill evidence is approved by the host without a shell command', async () => {
-  const config = resolveFlow('minimal', { flow: 'minimal', stage_bindings: {
-    '开发': { skills: [{ skill: { source: 'project', name: 'human-check' }, rules: [], evidence: 'manual' }] },
-  } }).config
-  const approvals = []
-  const f = fixture('开发', { flow: { flow: 'minimal', version: 3, config } }, {
-    approval: { request: async request => { approvals.push(request); return 'allowed-once' } },
-  })
-  f.load('human-check')
-  await f.call({ operation: 'skill_result', skill_name: 'human-check', evidence: ['checked by owner'] })
-  assert.equal(f.runs.length, 0)
-  assert.equal(approvals.length, 1)
-  assert.equal(f.state().skill_results['开发']['human-check'].approved, true)
-  assert.deepEqual(JSON.parse(await f.call({ operation: 'status' })).skill_blockers, [])
-  const denied = fixture('开发', { flow: { flow: 'minimal', version: 3, config } }, {
-    approval: { request: async () => 'rejected' },
-  })
-  denied.load('human-check')
-  await assert.rejects(denied.call({ operation: 'skill_result', skill_name: 'human-check', evidence: ['claimed approval'] }), /not approved/)
-  assert.equal(denied.state().skill_results?.['开发']?.['human-check'], undefined)
-})
-
-test('completion rejects unresolved terminal skills and rules', async () => {
-  const config = resolveFlow('minimal', { flow: 'minimal', stage_bindings: {
-    '交付': { skills: [{ skill: { source: 'project', name: 'must-run' }, rules: [{ source: 'project', name: 'missing' }], evidence: 'command' }] },
-  } }).config
-  const f = fixture('交付', {
-    flow: { flow: 'minimal', version: 3, config },
-    items: [{ id: 'A', title: 'small', status: 'done', review: { spec: { outcome: 'pass' }, quality: { outcome: 'pass' } } }],
-    commits: [{ label: 'TASK', hash: 'abcdef1' }],
-  })
-  const status = JSON.parse(await f.call({ operation: 'status' }))
-  assert.ok(status.skill_blockers.length > 0)
-  assert.ok(status.missing_rules.length > 0)
-  await assert.rejects(f.call({ operation: 'complete' }), /cannot complete.*must-run|cannot complete.*missing/)
-  assert.equal(f.state().completed, undefined)
-})
-
-test('same-named skill and rule freeze separately and disclose the rule body', async () => {
-  const f = fixture()
-  f.records.delete(join(f.cwd, '.dsh/task-LIVE-1.json'))
-  f.records.set(join(f.cwd, '.dsh/eng.json'), JSON.stringify({ flow: 'minimal', stage_bindings: {
-    '开发': { skills: [{ skill: { source: 'project', name: 'custom' }, rules: [{ source: 'project', name: 'custom' }], evidence: 'none' }] },
-  } }))
-  f.records.set(join(f.cwd, '.dsh/skills/custom/SKILL.md'), 'SKILL BODY')
-  f.records.set(join(f.cwd, '.dsh/rules/custom.md'), 'RULE BODY')
-  await f.call({ operation: 'create', title: 'collision', branch: 'main', files: ['app.js'] })
-  const resources = f.state().flow.resources.filter(resource => resource.ref.name === 'custom')
-  assert.deepEqual(resources.map(resource => resource.kind).sort(), ['rule', 'skill'])
-  assert.equal(JSON.parse(await f.call({ operation: 'status' })).bindings.rules[0].content, 'RULE BODY')
-  f.records.set(join(f.cwd, '.dsh/skills/custom/SKILL.md'), 'CHANGED SKILL')
-  assert.equal(JSON.parse(await f.call({ operation: 'status' })).bindings.skill_contents[0].content, 'SKILL BODY')
-})
-
-test('task creation applies skill_profiles rules even when legacy inline bindings are empty', async () => {
-  const f = fixture()
-  const skill = { source: 'project', name: 'custom' }
-  const rule = { source: 'project', name: 'my-rule' }
-  f.records.delete(join(f.cwd, '.dsh/task-LIVE-1.json'))
-  f.records.set(join(f.cwd, '.dsh/eng.json'), JSON.stringify({ flow: 'minimal',
-    stage_bindings: {
-      '开发': { skills: [{ skill, rules: [], evidence: 'none' }] },
-      '交付': { skills: [{ skill, rules: [], evidence: 'none' }] },
-    },
-    skill_profiles: { 'project:custom': { rules: [rule], evidence: 'none' } },
-  }))
-  f.records.set(join(f.cwd, '.dsh/skills/custom/SKILL.md'), 'SKILL BODY')
-  await assert.rejects(f.call({ operation: 'create', title: 'profile regression', branch: 'main', files: ['app.js'] }), /rule:project:my-rule/)
-  f.records.set(join(f.cwd, '.dsh/rules/my-rule.md'), 'RULE BODY')
-  await f.call({ operation: 'create', title: 'profile regression', branch: 'main', files: ['app.js'] })
-  assert.deepEqual(f.state().flow.config.stage_bindings['开发'].skills[0].rules, [rule])
-  assert.deepEqual(f.state().flow.config.stage_bindings['交付'].skills[0].rules, [rule])
-  assert.equal(f.state().flow.resources.find(resource => resource.kind === 'rule')?.content, 'RULE BODY')
-  assert.equal(JSON.parse(await f.call({ operation: 'status' })).bindings.rules[0].content, 'RULE BODY')
-})
-
-test('task creation rejects an unavailable skill or rule before writing a record', async () => {
-  const f = fixture()
-  f.records.delete(join(f.cwd, '.dsh/task-LIVE-1.json'))
-  f.records.set(join(f.cwd, '.dsh/eng.json'), JSON.stringify({ flow: 'minimal', stage_bindings: {
-    '开发': { skills: [{ skill: { source: 'project', name: 'missing-skill' }, rules: [] }] },
-  } }))
-  await assert.rejects(f.call({ operation: 'create', title: 'missing', branch: 'main' }), /unreadable bound resources/)
-  assert.equal(f.records.has(join(f.cwd, '.dsh/task-LIVE-1.json')), false)
-})
+}
+
+test('manual skill evidence is approved by the host without a shell command', async () => {
+  const config = resolveFlow('minimal', { flow: 'minimal', stage_bindings: {
+    '开发': { skills: [{ skill: { source: 'project', name: 'human-check' }, rules: [], evidence: 'manual' }] },
+  } }).config
+  const approvals = []
+  const f = fixture('开发', { flow: { flow: 'minimal', version: 3, config } }, {
+    approval: { request: async request => { approvals.push(request); return 'allowed-once' } },
+  })
+  f.load('human-check')
+  await f.call({ operation: 'skill_result', skill_name: 'human-check', evidence: ['checked by owner'] })
+  assert.equal(f.runs.length, 0)
+  assert.equal(approvals.length, 1)
+  assert.equal(f.state().skill_results['开发']['human-check'].approved, true)
+  assert.deepEqual(JSON.parse(await f.call({ operation: 'status' })).skill_blockers, [])
+  const denied = fixture('开发', { flow: { flow: 'minimal', version: 3, config } }, {
+    approval: { request: async () => 'rejected' },
+  })
+  denied.load('human-check')
+  await assert.rejects(denied.call({ operation: 'skill_result', skill_name: 'human-check', evidence: ['claimed approval'] }), /not approved/)
+  assert.equal(denied.state().skill_results?.['开发']?.['human-check'], undefined)
+})
+
+test('completion rejects unresolved terminal skills and rules', async () => {
+  const config = resolveFlow('minimal', { flow: 'minimal', stage_bindings: {
+    '交付': { skills: [{ skill: { source: 'project', name: 'must-run' }, rules: [{ source: 'project', name: 'missing' }], evidence: 'command' }] },
+  } }).config
+  const f = fixture('交付', {
+    flow: { flow: 'minimal', version: 3, config },
+    items: [{ id: 'A', title: 'small', status: 'done', review: { spec: { outcome: 'pass' }, quality: { outcome: 'pass' } } }],
+    commits: [{ label: 'TASK', hash: 'abcdef1' }],
+  })
+  const status = JSON.parse(await f.call({ operation: 'status' }))
+  assert.ok(status.skill_blockers.length > 0)
+  assert.ok(status.missing_rules.length > 0)
+  await assert.rejects(f.call({ operation: 'complete' }), /cannot complete.*must-run|cannot complete.*missing/)
+  assert.equal(f.state().completed, undefined)
+})
+
+test('same-named skill and rule freeze separately and disclose the rule body', async () => {
+  const f = fixture()
+  f.records.delete(join(f.cwd, '.dsh/task-LIVE-1.json'))
+  f.records.set(join(f.cwd, '.dsh/eng.json'), JSON.stringify({ flow: 'minimal', stage_bindings: {
+    '开发': { skills: [{ skill: { source: 'project', name: 'custom' }, rules: [{ source: 'project', name: 'custom' }], evidence: 'none' }] },
+  } }))
+  f.records.set(join(f.cwd, '.dsh/skills/custom/SKILL.md'), 'SKILL BODY')
+  f.records.set(join(f.cwd, '.dsh/rules/custom.md'), 'RULE BODY')
+  await f.call({ operation: 'create', title: 'collision', branch: 'main', files: ['app.js'] })
+  const resources = f.state().flow.resources.filter(resource => resource.ref.name === 'custom')
+  assert.deepEqual(resources.map(resource => resource.kind).sort(), ['rule', 'skill'])
+  assert.equal(JSON.parse(await f.call({ operation: 'status' })).bindings.rules[0].content, 'RULE BODY')
+  f.records.set(join(f.cwd, '.dsh/skills/custom/SKILL.md'), 'CHANGED SKILL')
+  const status = JSON.parse(await f.call({ operation: 'status' }))
+  assert.equal(status.bindings.skill_contents[0].content, 'CHANGED SKILL')
+  assert.ok(status.changed_source_skills.some(ref => ref.includes('project:custom')))
+  f.records.delete(join(f.cwd, '.dsh/skills/custom/SKILL.md'))
+  const missing = JSON.parse(await f.call({ operation: 'status' }))
+  assert.ok(missing.missing_skills.includes('project:custom'))
+  assert.equal(missing.bindings.skill_contents.length, 0)
+})
+
+test('task creation applies skill_profiles rules even when legacy inline bindings are empty', async () => {
+  const f = fixture()
+  const skill = { source: 'project', name: 'custom' }
+  const rule = { source: 'project', name: 'my-rule' }
+  f.records.delete(join(f.cwd, '.dsh/task-LIVE-1.json'))
+  f.records.set(join(f.cwd, '.dsh/eng.json'), JSON.stringify({ flow: 'minimal',
+    stage_bindings: {
+      '开发': { skills: [{ skill, rules: [], evidence: 'none' }] },
+      '交付': { skills: [{ skill, rules: [], evidence: 'none' }] },
+    },
+    skill_profiles: { 'project:custom': { rules: [rule], evidence: 'none' } },
+  }))
+  f.records.set(join(f.cwd, '.dsh/skills/custom/SKILL.md'), 'SKILL BODY')
+  await assert.rejects(f.call({ operation: 'create', title: 'profile regression', branch: 'main', files: ['app.js'] }), /rule:project:my-rule/)
+  f.records.set(join(f.cwd, '.dsh/rules/my-rule.md'), 'RULE BODY')
+  await f.call({ operation: 'create', title: 'profile regression', branch: 'main', files: ['app.js'] })
+  assert.deepEqual(f.state().flow.config.stage_bindings['开发'].skills[0].rules, [rule])
+  assert.deepEqual(f.state().flow.config.stage_bindings['交付'].skills[0].rules, [rule])
+  assert.equal(f.state().flow.resources.find(resource => resource.kind === 'rule')?.content, 'RULE BODY')
+  assert.equal(JSON.parse(await f.call({ operation: 'status' })).bindings.rules[0].content, 'RULE BODY')
+})
+
+test('task creation rejects an unavailable skill or rule before writing a record', async () => {
+  const f = fixture()
+  f.records.delete(join(f.cwd, '.dsh/task-LIVE-1.json'))
+  f.records.set(join(f.cwd, '.dsh/eng.json'), JSON.stringify({ flow: 'minimal', stage_bindings: {
+    '开发': { skills: [{ skill: { source: 'project', name: 'missing-skill' }, rules: [] }] },
+  } }))
+  await assert.rejects(f.call({ operation: 'create', title: 'missing', branch: 'main' }), /unreadable bound resources/)
+  assert.equal(f.records.has(join(f.cwd, '.dsh/task-LIVE-1.json')), false)
+})
 
 test('审查通过后更新状态并激活下一项，保留已完成项的审计', async () => {
   const f = fixture()
@@ -290,11 +309,9 @@ test('记录字段来自冻结流程，精简流程不硬编码标准字段，
   assert.deepEqual(JSON.parse(await fixture('设计').call({ operation: 'status' })).artifact_requirements[0].fields, ['approach', 'risks', 'impact'])
 })
 
-test('可选内置技能回执不会因范围变更升级成额外流转门禁', async () => {
-  const f = fixture('需求评审', { artifacts: { requirement: { scope: 'device picker', acceptance_criteria: 'contract and selection' } } })
-  f.load('requirement-analysis')
-  await f.call({ operation: 'skill_result', skill_name: 'requirement-analysis', command: 'check', evidence: ['optional check'] })
-  await f.call({ operation: 'scope', files: ['app.js', 'new-vo.java'] })
+test('空绑定流程不会因范围变更产生额外技能门禁', async () => {
+  const f = fixture('需求评审', { artifacts: { requirement: { scope: 'device picker', acceptance_criteria: 'contract and selection' } } })
+  await f.call({ operation: 'scope', files: ['app.js', 'new-vo.java'] })
   await f.call({ operation: 'advance', target_stage: '设计' })
   assert.equal(f.state().stage, '设计')
 })
@@ -394,12 +411,12 @@ test('同名技能与规则在项目和个人目录各自保留管理入口', as
   assert.match(read.content, /Run tests/)
 })
 
-test('安装包的七个内置技能实际注册且可在资源目录发现', async () => {
+test('安装包只注册会话编排技能，阶段目录不展示它', async () => {
   const registered = []
   registerShippedSkills({ get: name => name === 'skills' ? { register: skill => { registered.push(skill); return () => {} } } : undefined })
-  const expected = ['code-commit', 'code-implement', 'code-review', 'code-verify', 'eng-delivery', 'requirement-analysis', 'solution-design']
+  const expected = ['eng-delivery']
   assert.deepEqual(registered.map(skill => skill.name).sort(), expected)
   assert.ok(registered.every(skill => skill.content.trim().length > 0))
   const catalog = await Controller.prototype.listSkills.call({ authorizedPath: async path => path }, '')
-  assert.deepEqual(catalog.skills.filter(skill => skill.source === 'bundled').map(skill => skill.name).sort(), expected)
+  assert.deepEqual(catalog.skills.filter(skill => skill.source === 'bundled').map(skill => skill.name).sort(), [])
 })

package/README.md

@@ -27,7 +27,7 @@
 让 AI 修改代码时，你可以先明确需求，再检查方案、推进实施、验证结果，最后审核提交。DSH Task Engine 把这些步骤组织成可检查、可追踪的任务流程，适合在本机使用 DeepSeek Harness 开发个人项目。
 
 - **知道下一步做什么**：按所选流程推进，当前阶段需要的条件和产物清楚可查。
-- **复用自己的工作方法**：把技能和规则安装到项目或个人目录，将规则配置在技能下，再把技能挂到节点上；同一技能在任何节点都使用同一套约束。
+- **复用自己的工作方法**：把技能和规则安装到项目或个人目录，将规则配置在技能下，再把技能挂到节点上；同一技能在任何节点都使用同一套约束。
 - **找得到过程记录**：任务台账集中查看阶段、实施项、验证与审核状态。
 
 ## 快速开始
@@ -53,22 +53,22 @@ dsh plugin --profile web add @godv61/dsh-task-engine
 | **项目初始化** | 查看或编辑 `AGENTS.md`，让 AI 生成项目说明，预览后保存。 |
 | **流程配置** | 选择流程骨架，给节点挂技能，并在技能上配置它遵循的规则。需要现成起点时可「采用推荐配置」。 |
 | **任务台账** | 查看实施、验证和审核记录，按关键词、阶段或风险筛选。 |
-| **技能** | 安装、编辑技能，并集中维护每个技能唯一的规则列表。 |
+| **技能** | 安装、编辑技能，并集中维护每个技能唯一的规则列表。 |
 | **规则** | 选择 Markdown 文件安装规则，维护项目或个人开发约定。 |
 
-内置技能和规则是只读样本，可用“以此为模板新建”复制正文到项目或个人目录后编辑；新资源的规则和阶段绑定由你单独配置。安装、删除都会明确展示目标位置。
+插件只内置负责会话编排的 `eng-delivery`。阶段技能和规则由使用者创建或安装，可放在项目或个人目录；安装、删除都会明确展示目标位置。
 
-**流程与工作方法是两回事。** 流程只决定工作怎么流转（阶段顺序与门禁），预设不自带任何技能或提交格式。要用什么技能、遵守哪些规则、提交信息写什么，都由你配置——「采用推荐配置」只是把一份现成的起点**写入**你的配置，之后完全归你：删掉的不再补回，升级也不覆盖。规则挂在技能下，所以打开一个技能看到的就是它完整的规则列表，挂到任何节点都一样。
+**流程与工作方法是两回事。** 流程只决定工作怎么流转（阶段顺序与门禁），预设不自带任何技能或提交格式。要用什么技能、遵守哪些规则，都由你配置。「采用推荐配置」只填写可修改的提交文本、产物字段和评审深度，不改变技能与规则绑定。同一条规则可由多个技能共享。用户级技能及其规则配置由所有项目和会话共用。任务的流程与资源引用在创建时确定；Skill/Rule 正文在每次交互读取最新版本，创建时副本仅用于审计。[配置细节](docs/configuration.md)
 
 ## 选择适合这次任务的流程
 
 | 预设 | 阶段顺序 | 适用场景 |
 | :--- | :--- | :--- |
-| **完整研发** `standard` | 需求评审 → 设计 → 开发 → 交付 → 代码审核 → 完成 | 需要需求、方案和交付检查的完整开发任务。 |
-| **日常迭代** `agile` | 需求 → 开发 → 交付 → 审查 | 目标明确的日常开发任务。 |
-| **快速修改** `minimal` | 开发 → 交付 | 已明确做法的小改动。 |
+| **完整研发** `standard` | 需求评审 → 设计 → 开发 → 交付 → 代码审核 → 完成 | 需要需求、方案和交付检查的完整开发任务。 |
+| **日常迭代** `agile` | 需求 → 开发 → 交付 → 审查 | 目标明确的日常开发任务。 |
+| **快速修改** `minimal` | 开发 → 交付 | 已明确做法的小改动。 |
 
-阶段顺序和检查条件由预设固定；技能与规则由用户配置。选择流程不会强制加入内置技能；需要现成起点时可显式采用推荐配置。**可视化自定义流程不在计划内**，详见[功能规划](docs/roadmap.md)。
+阶段顺序和检查条件由预设固定；技能与规则由用户配置。空绑定也能运行流程。需要提交文本和产物字段的起点时可显式采用推荐配置。**可视化自定义流程不在计划内**，详见[功能规划](docs/roadmap.md)。
 
 ## 把自己的技能和规则带进来
 
@@ -78,9 +78,11 @@ dsh plugin --profile web add @godv61/dsh-task-engine
 
 | 安装范围 | 存放位置 | 用途 |
 | :--- | :--- | :--- |
-| 项目 | 工作区 `.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 规则；它的正文仍留在原目录。运行时使用 `dev_task` 的 `load_skill` 操作读取该技能及其规则，下一次读取会取得文件的最新内容。[Codex 项目技能说明](docs/configuration.md#技能与规则)
+
 技能的脚本、模板和附件会一并保留。文件格式、大小限制和故障处理见[技能与规则安装指南](docs/resource-install.md)。
 
 ## 使用文档
@@ -98,7 +100,7 @@ dsh plugin --profile web add @godv61/dsh-task-engine
 
 ## 能力说明
 
-`dev_task` 按配置检查阶段、产物和提交条件。新任务的验证要求真实命令回执；技能可按自身配置要求命令、产物、审核、人工批准或无需额外证据，执行义务可在任务状态中查看。任务保存创建时的流程与资源快照，之后修改项目配置不会直接改变进行中的任务。
+`dev_task` 按配置检查阶段、产物和提交条件。新任务的验证要求真实命令回执；技能可按自身配置要求命令、产物、审核、人工批准或无需额外证据，执行义务可在任务状态中查看。任务保存创建时的流程与资源引用；之后修改流程配置不会改变进行中任务的状态机，编辑所引用资源的正文会从下一次交互生效。
 
 审核结论、实施项完成情况和测试覆盖面仍需要你判断。本地提交钩子提供即时检查，不能替代人工审核或项目自己的 CI。详细说明见[常见问题](docs/faq.md)。
 

package/defaults/eng.json

@@ -1,97 +1 @@
-{
-  "flow": "standard",
-  "stage_bindings": {
-    "需求评审": {
-      "skill_refs": [
-        {
-          "source": "bundled",
-          "name": "requirement-analysis"
-        }
-      ]
-    },
-    "设计": {
-      "skill_refs": [
-        {
-          "source": "bundled",
-          "name": "solution-design"
-        }
-      ]
-    },
-    "开发": {
-      "skill_refs": [
-        {
-          "source": "bundled",
-          "name": "code-implement"
-        }
-      ]
-    },
-    "交付": {
-      "skill_refs": [
-        {
-          "source": "bundled",
-          "name": "code-verify"
-        }
-      ]
-    },
-    "代码审核": {
-      "skill_refs": [
-        {
-          "source": "bundled",
-          "name": "code-review"
-        },
-        {
-          "source": "bundled",
-          "name": "code-commit"
-        }
-      ]
-    }
-  },
-  "skill_profiles": {
-    "bundled:requirement-analysis": {
-      "rules": [
-        {
-          "source": "bundled",
-          "name": "security-redlines"
-        }
-      ]
-    },
-    "bundled:solution-design": {
-      "rules": []
-    },
-    "bundled:code-implement": {
-      "rules": [
-        {
-          "source": "bundled",
-          "name": "coding-conventions"
-        },
-        {
-          "source": "bundled",
-          "name": "security-redlines"
-        }
-      ]
-    },
-    "bundled:code-verify": {
-      "rules": []
-    },
-    "bundled:code-review": {
-      "rules": [
-        {
-          "source": "bundled",
-          "name": "coding-conventions"
-        },
-        {
-          "source": "bundled",
-          "name": "security-redlines"
-        }
-      ]
-    },
-    "bundled:code-commit": {
-      "rules": [
-        {
-          "source": "bundled",
-          "name": "commit-conventions"
-        }
-      ]
-    }
-  }
-}
+{"flow":"standard"}

package/docs/CHANGELOG.md

@@ -2,25 +2,39 @@
 
 [← 文档导航](README.md)
 
-按版本查阅功能变化。当前使用方式以[项目首页](../README.md)和使用指南为准；历史条目中的实现方式、限制与测试数量可能已被后续版本替代。
-
-## 0.26.1
-
-- 将会话预设强制加载的 `eng-delivery` 收敛为纯流程编排：只按任务状态和冻结配置加载技能、遵守规则及检查证据，不再暗示固定阶段技能映射或所有技能都需要命令回执；同步修正预设人设和工具参数说明。
-- 内置业务技能与规则明确作为只读样本；工作台可从样本预填新资源，改名后保存到项目或个人目录，再单独配置完成凭证、规则和阶段绑定。复制与保存不会自动启用样本。
-- 修正内置实现技能对未绑定 `coding-conventions` 的强制引用，以及旧规则迁移提示中的配置位置。
-
-## 0.26.0
-
-- 修复旧内联阶段绑定与新 `skill_profiles` 同时存在时，技能档案规则未展开、同一技能跨节点误报冲突的问题；明确的技能档案现在覆盖旧内联副本，并在任务创建时冻结实际生效的规则。
-- 技能规则改为项目级 `skill_profiles`，节点在 `.dsh/eng.json` 中只保存 `skill_refs`。旧内联绑定继续读取；没有明确技能档案时，同一技能在不同节点的规则或证据冲突会明确报错，保存时转换为单一配置。
-- “技能”页可集中编辑技能规则和完成凭证。流程页只选择技能，并可查看当前节点的有效规则；修改同一技能的配置会同步其所有节点引用。
-- 任务快照以资源类型、来源、名称定位技能和规则，避免同名资源正文串用；任务创建时拒绝缺失的绑定资源，并在运行时披露冻结的技能与规则正文。
-- `complete` 检查终态技能、证据与缺失规则，完成后禁止继续修改任务（可通过 `revise` 返工）。`status` 增加完成状态和完成阻塞原因。
-- `manual` 技能证据通过宿主人工审批记录，不再强制执行 shell；`artifact` 证据要求该阶段有产物定义且必填字段完整。
-- `commit_required: false` 同时取消离开提交检查点的强制提交要求。返工会使受影响阶段的技能结果失效。
-- 增加配置保存读回、同名资源、人工审批、终态阻塞及返工证据回归测试。
-- 工作台改用更宽的自适应布局；流程页用双栏穿梭框绑定技能，技能卡片和已绑定技能都可打开右侧规则配置抽屉，窄屏自动改为纵向布局。
+按版本查阅功能变化。当前使用方式以[项目首页](../README.md)和使用指南为准；历史条目中的实现方式、限制与测试数量可能已被后续版本替代。
+
+## 0.27.1
+
+- 移除六个内置业务 Skill 和三个内置 Rule，仅保留会话编排 Skill `eng-delivery`；阶段技能和规则完全由使用者创建或安装。
+- 三个流程及其推荐配置均不再绑定业务资源。推荐配置只提供可修改的提交文本、产物字段和评审深度，采用时保留现有技能与规则绑定。
+- 移除依赖已删内置规则的全局指纹与技能名称特例；空绑定流程仍按阶段与门禁运行，用户资源继续按原引用实时读取。
+- 兼容 DSH 新旧版本的图标导出名称，修复新版客户端中“工程流程”侧栏入口渲染失败、工作台无法打开的问题。
+
+## 0.27.0
+
+- 采用推荐配置时将所引用的内置技能和规则各复制一份到项目目录，并改写为项目引用；共享规则仍只有一份，重复采用保留用户已编辑的项目文件。旧项目可单独迁移内置引用，打开或普通保存时不自动改写。
+- 用户级技能的规则配置移到用户目录，跨项目和会话共用；不允许用户级技能依赖项目级规则。任务保留创建时流程和资源引用，Skill/Rule 正文从下一次交互读取最新版本；创建时正文仅作为审计基线。缺失的源资源阻止继续流转。
+- 流程切换时清理不属于新流程的阶段绑定，修复残留阶段造成的校验报错。技能规则配置改为挤压主内容的侧栏，不再覆盖蒙版。修复浏览器与宿主间的配置编解码，保存时保留资源引用、规则档案、提交和产物设置。
+- 正文实时读取是有意的行为变更：任务创建前已经记录的验证或人工确认不会因之后修改 Skill/Rule 自动作废。`status` 会报告资源变更；变更约束后请重新核查相关证据。
+
+## 0.26.1
+
+- 将会话预设强制加载的 `eng-delivery` 收敛为纯流程编排：只按任务状态和冻结配置加载技能、遵守规则及检查证据，不再暗示固定阶段技能映射或所有技能都需要命令回执；同步修正预设人设和工具参数说明。
+- 内置业务技能与规则明确作为只读样本；工作台可从样本预填新资源，改名后保存到项目或个人目录，再单独配置完成凭证、规则和阶段绑定。复制与保存不会自动启用样本。
+- 修正内置实现技能对未绑定 `coding-conventions` 的强制引用，以及旧规则迁移提示中的配置位置。
+
+## 0.26.0
+
+- 修复旧内联阶段绑定与新 `skill_profiles` 同时存在时，技能档案规则未展开、同一技能跨节点误报冲突的问题；明确的技能档案现在覆盖旧内联副本，并在任务创建时冻结实际生效的规则。
+- 技能规则改为项目级 `skill_profiles`，节点在 `.dsh/eng.json` 中只保存 `skill_refs`。旧内联绑定继续读取；没有明确技能档案时，同一技能在不同节点的规则或证据冲突会明确报错，保存时转换为单一配置。
+- “技能”页可集中编辑技能规则和完成凭证。流程页只选择技能，并可查看当前节点的有效规则；修改同一技能的配置会同步其所有节点引用。
+- 任务快照以资源类型、来源、名称定位技能和规则，避免同名资源正文串用；任务创建时拒绝缺失的绑定资源，并在运行时披露冻结的技能与规则正文。
+- `complete` 检查终态技能、证据与缺失规则，完成后禁止继续修改任务（可通过 `revise` 返工）。`status` 增加完成状态和完成阻塞原因。
+- `manual` 技能证据通过宿主人工审批记录，不再强制执行 shell；`artifact` 证据要求该阶段有产物定义且必填字段完整。
+- `commit_required: false` 同时取消离开提交检查点的强制提交要求。返工会使受影响阶段的技能结果失效。
+- 增加配置保存读回、同名资源、人工审批、终态阻塞及返工证据回归测试。
+- 工作台改用更宽的自适应布局；流程页用双栏穿梭框绑定技能，技能卡片和已绑定技能都可打开右侧规则配置抽屉，窄屏自动改为纵向布局。
 
 ## 0.25.0
 

package/docs/configuration.md

@@ -24,41 +24,42 @@
 }
 ```
 
-`stage_bindings` 的键是当前流程中的阶段名称，`skill_refs` 只保存技能引用。`skill_profiles` 为每个技能保存唯一的规则列表和证据类型。
+`stage_bindings` 的键是当前流程中的阶段名称，`skill_refs` 只保存技能引用。项目级技能（包括从 `.agents/skills` 发现的 Codex 技能）的 `skill_profiles` 在 `.dsh/eng.json` 中保存唯一的规则列表和证据类型；用户级技能的规则配置保存在 `$DSH_HOME/skills/<技能名>/profile.json`，所有项目和会话共用。用户级技能只能关联用户级规则，避免引用某个项目独有的规则。
 
 ```json
 {
   "flow": "standard",
   "stage_bindings": {
     "开发": {
-      "skill_refs": [{ "source": "bundled", "name": "code-implement" }]
-    }
-  },
-  "skill_profiles": {
-    "bundled:code-implement": {
-      "rules": [{ "source": "bundled", "name": "coding-conventions" },
-                { "source": "project", "name": "api-contract" }],
-      "evidence": "none"
-    }
-  }
-}
+      "skill_refs": [{ "source": "project", "name": "my-implementation" }]
+    }
+  },
+  "skill_profiles": {
+    "project:my-implementation": {
+      "rules": [{ "source": "project", "name": "api-contract" }],
+      "evidence": "none"
+    }
+  }
+}
 ```
 
-**规则挂载在技能下,节点不提供规则追加、禁用或覆盖。** 在工作台“技能”页或流程页的技能规则侧栏配置规则；同一技能挂到任何节点,都是同一套规则。需要不同规则组合时,复制成另一个独立技能。旧版把规则内联在各节点技能绑定的配置仍可读取；保存后会转为上述格式。若旧内联绑定与 `skill_profiles` 同时存在，明确配置的技能档案优先，所有节点使用它的规则和凭证；若没有技能档案而同一旧技能在不同节点的规则不同，系统会要求先复制为独立技能，不会任意选一套覆盖另一套。
-
-规则引用带来源(`bundled:` / `project:` / `user:`),因此同名资源不会被混淆。同一份规则可被多个技能引用,不需要复制正文;编辑共享规则时界面会显示受影响的技能。
+**规则挂载在技能下,节点不提供规则追加、禁用或覆盖。** 在工作台“技能”页或流程页的技能规则侧栏配置规则；同一技能挂到任何节点,都是同一套规则。需要不同规则组合时,复制成另一个独立技能。旧版把规则内联在各节点技能绑定的配置仍可读取；保存后会转为上述格式。若旧内联绑定与 `skill_profiles` 同时存在，明确配置的技能档案优先，所有节点使用它的规则和凭证；若没有技能档案而同一旧技能在不同节点的规则不同，系统会要求先复制为独立技能，不会任意选一套覆盖另一套。
 
-[默认配置示例](../defaults/eng.json)列出了标准流程采用推荐配置后的样子。
+规则引用带来源(`bundled:` / `project:` / `user:`),因此同名资源不会被混淆。同一份规则可被多个技能引用,不需要复制正文;编辑共享规则时界面会显示受影响的技能。
+
+项目技能可来自 `.dsh/skills/<名称>/SKILL.md`（引用来源 `project:`）或 `.agents/skills/<名称>/SKILL.md`（引用来源 `codex-project:`）。工作台会扫描这两个项目目录；新建技能仍默认写入 `.dsh/skills`。Codex 项目技能的正文在工作台中只读，可在原文件编辑；其规则配置仍属于该技能，存于项目 `.dsh/eng.json`，规则正文可引用项目 `.dsh/rules`。例如，节点使用 `codex-project:my-skill`，对应 `skill_profiles["codex-project:my-skill"].rules` 可引用 `project:api-contract`。Codex 自身 `.codex/rules/*.rules` 是命令权限配置，并非这里的 Markdown 规则。
 
-**预设不带任何绑定。** 一个只写了 `flow` 的配置就是字面意思:该流程的节点没有绑定,阶段仍按流程骨架流转。要一份现成的工程起点,在工作台点「采用推荐配置」,它会把技能、提交信息格式与产物字段**写入**你的配置一次;此后这些值就是你的普通配置,删掉不会补回,升级也不覆盖。
+[最小配置示例](../defaults/eng.json)仅选择流程，不绑定技能或规则。
 
-内置业务技能和规则作为只读样本保留。在“技能”或“规则”页选择“以此为模板新建”，可预填一份可编辑的项目或个人资源；复制只带正文，不自动复制该技能的规则档案，也不挂到任何阶段。保存后请单独配置完成凭证、规则与阶段引用。
+**预设不带任何绑定。** 一个只写了 `flow` 的配置就是字面意思：节点没有绑定，阶段仍按流程骨架流转。工作台的「采用推荐配置」只填写可修改的提交文本、产物字段和评审深度，不添加或覆盖技能与规则。项目级技能和规则放在 `.dsh/skills/` 与 `.dsh/rules/`；同一份规则可由多个技能引用。
+
+插件只内置会话编排技能 `eng-delivery`，不提供阶段业务技能或业务规则。它由会话预设使用，不显示在阶段技能列表。工作台可以安装或新建项目级、用户级资源。
 
-进入阶段后,`dev_task` 披露该阶段技能和规则的冻结正文。新任务离开阶段前会检查 Harness 的 skill 工具成功加载记录;技能可声明证据类型(`command` / `artifact` / `review` / `manual` / `none`)。`manual` 通过宿主人工审批记录，不要求执行命令；`artifact` 需要该阶段有产物定义且必填字段完整。未声明时沿用命令回执。`status.skill_obligations` 中的 `command_receipts_required` 列出需要命令回执的技能。
+进入阶段后,`dev_task` 按稳定的资源引用读取并披露该阶段技能和规则的最新正文。DSH 技能仍检查 Harness 的 skill 工具成功加载记录；Codex 项目技能使用 `dev_task operation=load_skill`（`skill_name` 传 `codex-project:<名称>`）加载技能及所挂规则，并检查这次加载记录。技能可声明证据类型(`command` / `artifact` / `review` / `manual` / `none`)。`manual` 通过宿主人工审批记录，不要求执行命令；`artifact` 需要该阶段有产物定义且必填字段完整。未声明时沿用命令回执。`status.skill_obligations` 中的 `command_receipts_required` 列出需要命令回执的技能。
 
 挂在终态(例如"完成")的技能在进入终态前执行。测试技能通常建议挂在"交付";现有"完成"绑定也会在审核阶段执行后才放行。标准流程 v2 在审核通过后提交,并核对真实 Git HEAD。修改文件或声明范围后,旧验证回执失效。
 
-资源管理保留项目和个人目录的同名条目,避免来源误标和误操作。技能最终由 Harness 的技能目录加载。
+资源管理保留不同来源的同名条目,避免来源误标和误操作。DSH 技能通过 Harness 的 skill 工具加载；Codex 项目技能通过 `dev_task load_skill` 按来源和任务读取。
 
 ### 旧配置迁移
 
@@ -74,6 +75,6 @@
 
 新任务记录创建时的完整流程快照，后续按该快照执行。修改项目配置影响之后创建的任务，不会自动迁移进行中的任务。
 
-任务开始时会冻结所引用的技能和规则正文。资源类型、来源和名称共同构成身份，因此同名技能和规则不会混淆。缺失的必需资源会阻止新任务创建；已完成任务若需返工，使用 `revise` 显式重开。
+任务开始时会保存所引用技能和规则正文的**审计副本**，但运行时按原来的来源与名称重新读取：项目级资源可随时编辑，同项目的其他会话及进行中的任务在下一次交互读取最新正文；用户级资源在所有项目和会话中同理。状态机会继续使用任务创建时的流程快照。正文变化会在 `status` 中提示；删除仍被绑定的资源会阻止阶段流转。已记录的验证或人工确认不会因为正文编辑自动失效，修改约束后应重新检查这些结果。资源类型、来源和名称共同构成身份，因此同名技能和规则不会混淆。缺失的必需资源会阻止新任务创建；已完成任务若需返工，使用 `revise` 显式重开。
 
 下一步：[资源安装](resource-install.md) · [常见问题](faq.md)

package/docs/development.md

@@ -25,7 +25,7 @@ CI 在 Windows 的 Node 22/24 上运行。每次功能修改选择相关验证
 | 位置 | 职责 |
 | :--- | :--- |
 | [src/engine.ts](../src/engine.ts) | 状态机、阶段条件和提交规则检查。 |
-| [src/workflows.ts](../src/workflows.ts) | 三套流程骨架及可选的推荐配置。 |
+| [src/workflows.ts](../src/workflows.ts) | 三套流程骨架及可选的推荐配置。 |
 | [src/dev-task.ts](../src/dev-task.ts) | 模型使用的 dev_task 工具与任务文件操作。 |
 | [src/controller.ts](../src/controller.ts) | 工作台读取配置、任务和资源的 Remote 控制器。 |
 | [src/resource-import.ts](../src/resource-import.ts) | 导入校验、安装预览、独占写入与失败清理。 |

package/docs/faq.md

@@ -16,19 +16,19 @@
 
 ## 安装资源后就会自动使用吗？
 
-还需要为技能配置规则，再到“流程配置”选择阶段并挂载技能。任务执行时按阶段披露对应内容；安装行为本身不会执行资源中的脚本。
+还需要为技能配置规则，再到“流程配置”选择阶段并挂载技能。任务执行时按阶段披露对应内容；安装行为本身不会执行资源中的脚本。
 
 ## 改了流程，原来的任务会变化吗？
 
 任务保存创建时的流程快照。修改项目配置不会自动改变进行中的任务；新任务使用保存后的配置。
 
-## 能移除推荐技能、修改内置规则吗？
-
-流程预设没有强制技能绑定。「采用推荐配置」只是一次性写入项目配置，之后可任意增删技能和规则。内置业务技能和规则是只读样本：可用“以此为模板新建”复制正文，改名后保存为自己的资源，再配置完成凭证、规则和阶段绑定。复制不会自动启用它们；不同来源的同名资源也不会混用。会话预设中的 `eng-delivery` 只负责按 `dev_task` 的状态与门禁编排，不决定业务方法。
+## 能移除推荐技能、修改内置规则吗？
+
+流程预设没有强制技能绑定。当前安装包只保留会话编排技能 `eng-delivery`，不再附带业务技能和规则；它只负责按 `dev_task` 的状态与门禁编排，不决定业务方法。用户的业务技能可建在项目 `.dsh/skills`，也可使用同项目 `.agents/skills` 中已有的 Codex 技能；规则仍由用户配置在技能下。不同来源的同名资源分别引用。
 
 ## 工具显示验证或审核通过，能完全相信吗？
 
-新建任务的验证需要真实命令回执，要求退出码为 0 且未超时、中止或被沙箱拒绝；代码修改后需重验。技能按配置记录加载情况及所需的命令、产物、审核或人工批准证据；审核和实施项结论仍需判断。命令覆盖是否充分、审核是否准确仍需判断，不能把一个成功退出码当作全部需求已验证。
+新建任务的验证需要真实命令回执，要求退出码为 0 且未超时、中止或被沙箱拒绝；代码修改后需重验。技能按配置记录加载情况及所需的命令、产物、审核或人工批准证据；审核和实施项结论仍需判断。命令覆盖是否充分、审核是否准确仍需判断，不能把一个成功退出码当作全部需求已验证。
 
 ## 验证命令被沙箱阻止怎么办？