@godv61/dsh-task-engine 0.26.0 → 0.27.0

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()

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 文件安装规则，维护项目或个人开发约定。 |
 
-内置技能和规则只读；项目与个人资源可编辑。安装、删除都会明确展示目标位置。
+内置技能和规则是只读样本，可用“以此为模板新建”复制正文到项目或个人目录后编辑；新资源的规则和阶段绑定由你单独配置。安装、删除都会明确展示目标位置。
 
-**流程与工作方法是两回事。** 流程只决定工作怎么流转（阶段顺序与门禁），预设不自带任何技能或提交格式。要用什么技能、遵守哪些规则、提交信息写什么，都由你配置——「采用推荐配置」只是把一份现成的起点**写入**你的配置，之后完全归你：删掉的不再补回，升级也不覆盖。规则挂在技能下，所以打开一个技能看到的就是它完整的规则列表，挂到任何节点都一样。
+**流程与工作方法是两回事。** 流程只决定工作怎么流转（阶段顺序与门禁），预设不自带任何技能或提交格式。要用什么技能、遵守哪些规则、提交信息写什么，都由你配置。「采用推荐配置」并保存时，内置样本各复制一份到项目目录，配置改为引用项目资源；之后可编辑，升级不覆盖。同一条规则仍可由多个技能共享。用户级技能及其规则配置由所有项目和会话共用。任务的流程与资源引用在创建时确定；Skill/Rule 正文在每次交互读取最新版本，创建时副本仅用于审计。[配置细节](docs/configuration.md)
 
 ## 选择适合这次任务的流程
 
 | 预设 | 阶段顺序 | 适用场景 |
 | :--- | :--- | :--- |
-| **完整研发** `standard` | 需求评审 → 设计 → 开发 → 交付 → 代码审核 → 完成 | 需要需求、方案和交付检查的完整开发任务。 |
-| **日常迭代** `agile` | 需求 → 开发 → 交付 → 审查 | 目标明确的日常开发任务。 |
-| **快速修改** `minimal` | 开发 → 交付 | 已明确做法的小改动。 |
+| **完整研发** `standard` | 需求评审 → 设计 → 开发 → 交付 → 代码审核 → 完成 | 需要需求、方案和交付检查的完整开发任务。 |
+| **日常迭代** `agile` | 需求 → 开发 → 交付 → 审查 | 目标明确的日常开发任务。 |
+| **快速修改** `minimal` | 开发 → 交付 | 已明确做法的小改动。 |
 
-阶段顺序和检查条件由预设固定；技能与规则由用户配置。选择流程不会强制加入内置技能；需要现成起点时可显式采用推荐配置。**可视化自定义流程不在计划内**，详见[功能规划](docs/roadmap.md)。
+阶段顺序和检查条件由预设固定；技能与规则由用户配置。选择流程不会强制加入内置技能；需要现成起点时可显式采用推荐配置。**可视化自定义流程不在计划内**，详见[功能规划](docs/roadmap.md)。
 
 ## 把自己的技能和规则带进来
 
@@ -98,7 +98,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,97 @@
-{
-  "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",
+  "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"
+        }
+      ]
+    }
+  }
+}

package/docs/CHANGELOG.md

@@ -2,19 +2,32 @@
 
 [← 文档导航](README.md)
 
-按版本查阅功能变化。当前使用方式以[项目首页](../README.md)和使用指南为准；历史条目中的实现方式、限制与测试数量可能已被后续版本替代。
-
-## 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.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,35 +24,39 @@
 }
 ```
 
-`stage_bindings` 的键是当前流程中的阶段名称，`skill_refs` 只保存技能引用。`skill_profiles` 为每个技能保存唯一的规则列表和证据类型。
+`stage_bindings` 的键是当前流程中的阶段名称，`skill_refs` 只保存技能引用。项目级和内置技能的 `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": "bundled", "name": "code-implement" }]
+    }
+  },
+  "skill_profiles": {
+    "bundled:code-implement": {
+      "rules": [{ "source": "bundled", "name": "coding-conventions" },
+                { "source": "project", "name": "api-contract" }],
+      "evidence": "none"
+    }
+  }
+}
 ```
 
-**规则挂载在技能下,节点不提供规则追加、禁用或覆盖。** 在工作台“技能”页或流程页的技能规则侧栏配置规则；同一技能挂到任何节点,都是同一套规则。需要不同规则组合时,复制成另一个独立技能。旧版把规则内联在各节点技能绑定的配置仍可读取；保存后会转为上述格式。若旧内联绑定与 `skill_profiles` 同时存在，明确配置的技能档案优先，所有节点使用它的规则和凭证；若没有技能档案而同一旧技能在不同节点的规则不同，系统会要求先复制为独立技能，不会任意选一套覆盖另一套。
+**规则挂载在技能下,节点不提供规则追加、禁用或覆盖。** 在工作台“技能”页或流程页的技能规则侧栏配置规则；同一技能挂到任何节点,都是同一套规则。需要不同规则组合时,复制成另一个独立技能。旧版把规则内联在各节点技能绑定的配置仍可读取；保存后会转为上述格式。若旧内联绑定与 `skill_profiles` 同时存在，明确配置的技能档案优先，所有节点使用它的规则和凭证；若没有技能档案而同一旧技能在不同节点的规则不同，系统会要求先复制为独立技能，不会任意选一套覆盖另一套。
 
 规则引用带来源(`bundled:` / `project:` / `user:`),因此同名资源不会被混淆。同一份规则可被多个技能引用,不需要复制正文;编辑共享规则时界面会显示受影响的技能。
 
 [默认配置示例](../defaults/eng.json)列出了标准流程采用推荐配置后的样子。
 
-**预设不带任何绑定。** 一个只写了 `flow` 的配置就是字面意思:该流程的节点没有绑定,阶段仍按流程骨架流转。要一份现成的工程起点,在工作台点「采用推荐配置」,它会把技能、提交信息格式与产物字段**写入**你的配置一次;此后这些值就是你的普通配置,删掉不会补回,升级也不覆盖。
+**预设不带任何绑定。** 一个只写了 `flow` 的配置就是字面意思:该流程的节点没有绑定,阶段仍按流程骨架流转。要一份现成的工程起点,在工作台点「采用推荐配置」并保存。系统会把所引用的内置技能和规则各复制一份到项目 `.dsh/skills/` 与 `.dsh/rules/`，把配置引用改为 `project:`，并写入提交信息格式与产物字段。共享规则只复制一份，多个技能继续引用同一份。之后这些文件与配置均归项目所有，可编辑，升级不覆盖；重复采用也不会覆盖已经修改的项目副本。
+
+以前已采用的项目如仍使用 `bundled:` 引用，打开或保存时不会擅自迁移。它们继续引用内置样本，新任务会读取当前插件版本的正文；若要固定为项目资源，可在流程页点「把当前内置引用迁移到项目」并保存，保留其他现有配置。
+
+内置业务技能和规则作为只读样本保留。在“技能”或“规则”页选择“以此为模板新建”，可预填一份可编辑的项目或个人资源；复制只带正文，不自动复制该技能的规则档案，也不挂到任何阶段。保存后请单独配置完成凭证、规则与阶段引用。
 
-进入阶段后,`dev_task` 披露该阶段技能和规则的冻结正文。新任务离开阶段前会检查 Harness 的 skill 工具成功加载记录;技能可声明证据类型(`command` / `artifact` / `review` / `manual` / `none`)。`manual` 通过宿主人工审批记录，不要求执行命令；`artifact` 需要该阶段有产物定义且必填字段完整。未声明时沿用命令回执。`status.skill_obligations` 中的 `command_receipts_required` 列出需要命令回执的技能。
+进入阶段后,`dev_task` 按稳定的资源引用读取并披露该阶段技能和规则的最新正文。新任务离开阶段前会检查 Harness 的 skill 工具成功加载记录;技能可声明证据类型(`command` / `artifact` / `review` / `manual` / `none`)。`manual` 通过宿主人工审批记录，不要求执行命令；`artifact` 需要该阶段有产物定义且必填字段完整。未声明时沿用命令回执。`status.skill_obligations` 中的 `command_receipts_required` 列出需要命令回执的技能。
 
 挂在终态(例如"完成")的技能在进入终态前执行。测试技能通常建议挂在"交付";现有"完成"绑定也会在审核阶段执行后才放行。标准流程 v2 在审核通过后提交,并核对真实 Git HEAD。修改文件或声明范围后,旧验证回执失效。
 
@@ -72,6 +76,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) | 导入校验、安装预览、独占写入与失败清理。 |