@godv61/dsh-task-engine 0.1.0

package/README.md

@@ -0,0 +1,65 @@
+# dsh-task-engine
+
+一个**可安装、项目无关、硬约束**的工程化交付引擎，把「需求评审 → 设计 → 开发 → 交付 → 代码审核」这套流程做成 DeepSeek Harness 的一个 bundle。同事 `dsh plugin add` 装一下，再选一个预设，就能在自己项目里用——**不需要**在每个项目手写 `.agents` / `.claude` / `.harness`。
+
+核心是一个 `dev_task` 工具 + 内置技能。工具的硬约束在代码里执行，不是"提醒模型"：
+
+- **阶段流转**：只能沿 `.dsh/eng.json` 配的阶段图走；非法流转直接报错拒绝。
+- **确认/验证门**：需求/方案未确认 → 进不了设计/开发；实施项没完 → 不能交付；高风险没验证证据 → 不能过评审。
+- **提交门禁**：到检查点才能提交，消息必须匹配 `message_pattern`，`manual` 策略永不自动提交。
+
+## 目录
+
+```
+cordis.patch.yml        bundle 声明 + host 组合 patch（一行，注册本插件）
+defaults/eng.json       内置默认工作流（可被项目 .dsh/eng.json 覆盖）
+src/engine.ts           纯函数状态机（无 harness 依赖，可单测）
+src/index.ts            插件：注册 dev_task 工具 + 内置技能
+skills/eng-delivery/    内置交付技能
+preset/preset.yml       预设元数据
+preset/persona.md       预设 persona 文案（复制粘贴用）
+```
+
+## 构建
+
+> 依赖走**公共 npm**：`@deepseek-ai/*` 已发到 `0.1.2-rc.1`（tag `next`）/ `0.1.2-alpha.5`，`cordis` 是 `4.0.2`。本包依赖对齐到 `^0.1.2-rc.1` + `^4.0.2`，已实测 `npm install`（公网）+ `tsc` 构建/typecheck + 运行时冒烟全部通过。
+
+```powershell
+npm install           # 从公共 npm 解析 @deepseek-ai/* 依赖
+npm run typecheck     # 严格模式零错误
+npm run build         # tsc 产出 lib/index.js + lib/index.d.ts
+```
+
+## 安装（别人集成）
+
+```powershell
+# 从公共 npm（发布后）
+dsh plugin --profile <name> add @godv61/dsh-task-engine
+# 从你的 git 仓库
+dsh plugin --profile <name> add github:<你的org>/dsh-task-engine
+# 或本地 checkout
+dsh plugin --profile <name> add .
+```
+
+## 启用（opt-in）
+
+1. 用 roster `copy('standard', 'eng', '工程化开发引擎')` 复制一个预设（或手动建目录）。
+2. 把该预设的 persona 替换成 `preset/persona.md` 内容。
+3. 新会话选该预设即可。`dev_task` 工具与 `eng-delivery` 技能由 bundle 提供。
+
+## 项目配置（让流程贴合你的项目）
+
+在项目根放 `.dsh/eng.json`（复制 `defaults/eng.json` 改字段即可）：
+
+- `stages` / `start_stage` / `transitions`：阶段与流转图；每条边的 `requires` 用引擎原生 guard。
+- `commit.policy`（`task|item|manual`）、`commit.message_pattern`/`message_hint`、`commit.checkpoints`。
+- `high_risk_requires_verification`。
+
+原生 guard：`requirement_confirmation`、`solution_confirmation`、`todos_done`、`verified`、`review_passed`。
+
+## 已知待办（Phase 0 边界）
+
+- 已用 monorepo TypeScript 工具链对真实 harness API 跑过 strict 编译（`exactOptionalPropertyTypes` + `noUncheckedIndexedAccess`）零错误，3 个此前标记的 API 校验点全部确认；并临时挂进 workspace 做了真实 `tsc` 构建 + 运行时冒烟——`dev_task` 工具与 `eng-delivery` 技能注册成功，非法流转/未过 guard/非法提交在运行时被硬拒绝。
+- 已实测：`npm install`（公网 `0.1.2-rc.1`）+ `npm run typecheck`/`build` 全过，构建产物在运行时注册 `dev_task`/`eng-delivery` 并硬拒绝非法流转/未过 guard/非法提交。剩下没亲自跑的是 `dsh plugin add` 装进 profile + 真实模型会话（要 `DEEPSEEK_API_KEY`）。
+- 提交仍是"工具校验 + 模型执行 git"；要彻底防止绕过 `git commit`，需项目加 pre-commit hook（机械门禁，下一步）。
+- 阶段产物（设计文档/评审字段）的硬 schema 校验属于你未选的"更重"档，Phase 0 不包含。

package/cordis.patch.yml

@@ -0,0 +1,10 @@
+# dsh-task-engine bundle: one host-plane row that registers the `dev_task` tool
+# and the shipped engineering skills. The agent-plane opt-in (persona + routing)
+# lives in `preset/` and is copied into a preset by whoever enables the engine.
+#
+# Host row + global tools/skills registries means: install the bundle once and the
+# capability is dormant-available to every agent; the preset decides whether an
+# agent actually routes its work through it.
+- insert:
+    - id: task-engine
+      name: '@godv61/dsh-task-engine'

package/defaults/eng.json

@@ -0,0 +1,18 @@
+{
+  "stages": ["requirement_review", "design", "implement", "deliver", "review", "done"],
+  "start_stage": "requirement_review",
+  "transitions": [
+    { "from": "requirement_review", "to": "design", "requires": ["requirement_confirmation"] },
+    { "from": "design", "to": "implement", "requires": ["solution_confirmation"] },
+    { "from": "implement", "to": "deliver", "requires": ["todos_done"] },
+    { "from": "deliver", "to": "review", "requires": ["verified"] },
+    { "from": "review", "to": "done", "requires": ["review_passed"] }
+  ],
+  "commit": {
+    "policy": "task",
+    "message_pattern": "^【(\\S+)】【(?:TASK|T\\d+)】.+",
+    "message_hint": "【<module>】【TASK/T1】说明 —— 写结果，不写空泛动作",
+    "checkpoints": ["deliver"]
+  },
+  "high_risk_requires_verification": true
+}

package/lib/engine.d.ts

@@ -0,0 +1,108 @@
+/**
+ * Config-driven engineering workflow engine — pure and harness-free.
+ *
+ * `loadWorkflow`, `legalTargets`, `assertAdvance`, `validateCommitMessage`, and
+ * `commitCheckpoint` are pure functions over a `WorkflowConfig` and a `TaskState`.
+ * They hold every hard gate the `dev_task` tool exposes, so the state machine is
+ * unit-testable without a harness and the same code enforces the process whatever
+ * config (stage graph, guards, commit policy) a project supplies.
+ *
+ * @module dsh-task-engine/engine
+ */
+export type WorkSize = 'tiny' | 'standard' | 'complex';
+export type RiskLevel = 'standard' | 'high_risk';
+export type ItemStatus = 'todo' | 'doing' | 'done';
+/** Guard names the engine resolves natively. Opaque names are config errors. */
+export type GuardName = 'requirement_confirmation' | 'solution_confirmation' | 'todos_done' | 'verified' | 'review_passed';
+/** One allowed stage transition and the guards that must already hold. */
+export interface Transition {
+    from: string;
+    to: string;
+    requires?: GuardName[];
+}
+/** Commit policy and message shape. Empty `message_pattern` disables format checking. */
+export interface CommitRule {
+    policy: 'task' | 'item' | 'manual';
+    message_pattern: string;
+    message_hint: string;
+    /** Stages at which a commit checkpoint sits (a commit is due before leaving these). */
+    checkpoints: string[];
+}
+export interface WorkflowConfig {
+    stages: string[];
+    start_stage: string;
+    transitions: Transition[];
+    commit: CommitRule;
+    /** A high_risk task cannot cross an edge guarded by `verified` without passing evidence. */
+    high_risk_requires_verification: boolean;
+}
+export interface TaskItem {
+    id: string;
+    title: string;
+    status: ItemStatus;
+}
+export interface TaskState {
+    schema: 1;
+    id: string;
+    title: string;
+    branch: string;
+    work_size: WorkSize;
+    risk_level: RiskLevel;
+    stage: string;
+    requirement_confirmed: boolean;
+    solution_confirmed: boolean;
+    items: TaskItem[];
+    verification: {
+        passed: boolean;
+        evidence: string[];
+    };
+    review: {
+        outcome: 'pending' | 'pass' | 'blocked';
+    };
+    commits: {
+        label: string;
+        hash?: string;
+    }[];
+}
+export interface Result {
+    ok: boolean;
+    errors?: string[];
+}
+/** Stage-merge an override over a default; absent fields keep the default. */
+export declare function loadWorkflow(defaults: WorkflowConfig, override?: Partial<WorkflowConfig>): WorkflowConfig;
+/** Target stages reachable from `stage` via a configured transition. */
+export declare function legalTargets(stage: string, config: WorkflowConfig): string[];
+/** The edge from `from` to `to`, or undefined when not configured. */
+export declare function findTransition(from: string, to: string, config: WorkflowConfig): Transition | undefined;
+/**
+ * Validate an advance from `state.stage` to `targetStage`.
+ *
+ * Returns `{ ok: false, errors }` when the target is unknown, the edge is not
+ * configured, or any declared guard is unmet. This is the hard transition gate:
+ * the tool rejects rather than degrades.
+ */
+export declare function assertAdvance(state: TaskState, targetStage: string, config: WorkflowConfig): Result;
+/** Validate a commit summary against the configured message pattern. */
+export declare function validateCommitMessage(message: string, config: WorkflowConfig): Result;
+export interface CommitCheckpoint {
+    allowed: boolean;
+    label?: string;
+    reason?: string;
+}
+/**
+ * Decide whether the current task state permits a commit and with what label.
+ *
+ * `manual` never auto-commits. `task` allows a single `TASK` at a checkpoint
+ * stage. `item` allows `T<n>` commits mid-flow and a closing `TASK` at a
+ * checkpoint. A stage only permits a commit once its outgoing guards already
+ * hold, so the engine cannot be asked to commit before its own state is valid.
+ */
+export declare function commitCheckpoint(state: TaskState, config: WorkflowConfig): CommitCheckpoint;
+/** A fresh task pinned to the config's start stage. */
+export declare function newTask(input: {
+    id: string;
+    title: string;
+    branch: string;
+    work_size: WorkSize;
+    risk_level: RiskLevel;
+}, config: WorkflowConfig): TaskState;

package/lib/engine.js

@@ -0,0 +1,143 @@
+/**
+ * Config-driven engineering workflow engine — pure and harness-free.
+ *
+ * `loadWorkflow`, `legalTargets`, `assertAdvance`, `validateCommitMessage`, and
+ * `commitCheckpoint` are pure functions over a `WorkflowConfig` and a `TaskState`.
+ * They hold every hard gate the `dev_task` tool exposes, so the state machine is
+ * unit-testable without a harness and the same code enforces the process whatever
+ * config (stage graph, guards, commit policy) a project supplies.
+ *
+ * @module dsh-task-engine/engine
+ */
+function requireKnownStage(stage, config) {
+    if (!config.stages.includes(stage)) {
+        return { ok: false, errors: [`unknown stage "${stage}"`] };
+    }
+    return { ok: true };
+}
+/** Stage-merge an override over a default; absent fields keep the default. */
+export function loadWorkflow(defaults, override) {
+    if (!override)
+        return defaults;
+    return {
+        stages: override.stages ?? defaults.stages,
+        start_stage: override.start_stage ?? defaults.start_stage,
+        transitions: override.transitions ?? defaults.transitions,
+        commit: { ...defaults.commit, ...(override.commit ?? {}) },
+        high_risk_requires_verification: override.high_risk_requires_verification ?? defaults.high_risk_requires_verification,
+    };
+}
+/** Target stages reachable from `stage` via a configured transition. */
+export function legalTargets(stage, config) {
+    return config.transitions
+        .filter(transition => transition.from === stage)
+        .map(transition => transition.to);
+}
+/** The edge from `from` to `to`, or undefined when not configured. */
+export function findTransition(from, to, config) {
+    return config.transitions.find(transition => transition.from === from && transition.to === to);
+}
+function guardSatisfied(guard, state, config) {
+    switch (guard) {
+        case 'requirement_confirmation':
+            return state.requirement_confirmed;
+        case 'solution_confirmation':
+            return state.solution_confirmed;
+        case 'todos_done':
+            return state.items.length > 0 && state.items.every(item => item.status === 'done');
+        case 'verified':
+            if (!state.verification.passed)
+                return false;
+            return config.high_risk_requires_verification && state.risk_level === 'high_risk'
+                ? state.verification.evidence.length > 0
+                : true;
+        case 'review_passed':
+            return state.review.outcome === 'pass';
+    }
+}
+/**
+ * Validate an advance from `state.stage` to `targetStage`.
+ *
+ * Returns `{ ok: false, errors }` when the target is unknown, the edge is not
+ * configured, or any declared guard is unmet. This is the hard transition gate:
+ * the tool rejects rather than degrades.
+ */
+export function assertAdvance(state, targetStage, config) {
+    const known = requireKnownStage(targetStage, config);
+    if (!known.ok)
+        return known;
+    const transition = findTransition(state.stage, targetStage, config);
+    if (!transition) {
+        return {
+            ok: false,
+            errors: [`no transition from "${state.stage}" to "${targetStage}"` +
+                    ` (legal: ${legalTargets(state.stage, config).join(', ') || 'none'})`],
+        };
+    }
+    const unmet = (transition.requires ?? []).filter(guard => !guardSatisfied(guard, state, config));
+    if (unmet.length > 0) {
+        return { ok: false, errors: [`guards unmet: ${unmet.join(', ')}`] };
+    }
+    return { ok: true };
+}
+/** Validate a commit summary against the configured message pattern. */
+export function validateCommitMessage(message, config) {
+    if (config.commit.message_pattern === '')
+        return { ok: true };
+    const re = new RegExp(config.commit.message_pattern);
+    if (re.test(message))
+        return { ok: true };
+    return {
+        ok: false,
+        errors: [`commit summary "${message}" does not match ${config.commit.message_hint}`],
+    };
+}
+/**
+ * Decide whether the current task state permits a commit and with what label.
+ *
+ * `manual` never auto-commits. `task` allows a single `TASK` at a checkpoint
+ * stage. `item` allows `T<n>` commits mid-flow and a closing `TASK` at a
+ * checkpoint. A stage only permits a commit once its outgoing guards already
+ * hold, so the engine cannot be asked to commit before its own state is valid.
+ */
+export function commitCheckpoint(state, config) {
+    const { policy, checkpoints } = config.commit;
+    if (policy === 'manual') {
+        return { allowed: false, reason: 'commit policy is manual — await an explicit user instruction' };
+    }
+    if (checkpoints.includes(state.stage)) {
+        const ready = config.transitions
+            .filter(transition => transition.from === state.stage)
+            .every(transition => (transition.requires ?? []).every(g => guardSatisfied(g, state, config)));
+        if (!ready) {
+            return { allowed: false, reason: 'checkpoint stage reached but its outgoing guards are unmet' };
+        }
+        return { allowed: true, label: 'TASK' };
+    }
+    if (policy === 'item') {
+        const done = state.items.filter(item => item.status === 'done').length;
+        if (done > 0) {
+            return { allowed: true, label: `T${done}` };
+        }
+    }
+    return { allowed: false, reason: 'no commit is due at this stage under the current policy' };
+}
+/** A fresh task pinned to the config's start stage. */
+export function newTask(input, config) {
+    return {
+        schema: 1,
+        id: input.id,
+        title: input.title,
+        branch: input.branch,
+        work_size: input.work_size,
+        risk_level: input.risk_level,
+        stage: config.start_stage,
+        requirement_confirmed: false,
+        solution_confirmed: false,
+        items: [],
+        verification: { passed: false, evidence: [] },
+        review: { outcome: 'pending' },
+        commits: [],
+    };
+}
+//# sourceMappingURL=engine.js.map

package/lib/engine.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"engine.js","sourceRoot":"","sources":["../src/engine.ts"],"names":[],"mappings":"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"}

package/lib/index.d.ts

@@ -0,0 +1,10 @@
+/**
+ * dsh-task-engine plugin: registers the model-facing `dev_task` tool (the hard
+ * gate) and ships the bundled engineering skills.
+ *
+ * @module dsh-task-engine
+ */
+import type { Context } from '@deepseek-ai/cordis';
+export declare const name = "task-engine";
+export declare const inject: string[];
+export declare function apply(ctx: Context): void;

package/lib/index.js

@@ -0,0 +1,204 @@
+/**
+ * dsh-task-engine plugin: registers the model-facing `dev_task` tool (the hard
+ * gate) and ships the bundled engineering skills.
+ *
+ * @module dsh-task-engine
+ */
+import { readFileSync, readdirSync } from 'node:fs';
+import { fileURLToPath } from 'node:url';
+import { defineTool } from '@deepseek-ai/dsh-tools';
+import { assertAdvance, commitCheckpoint, legalTargets, loadWorkflow, newTask, validateCommitMessage, } from "./engine.js";
+export const name = 'task-engine';
+export const inject = ['tools', 'fs'];
+const DEFAULTS = JSON.parse(readFileSync(fileURLToPath(new URL('../defaults/eng.json', import.meta.url)), 'utf8'));
+async function readText(fs, relPath) {
+    try {
+        return await fs.readText(fs.resolve(relPath));
+    }
+    catch {
+        return undefined;
+    }
+}
+async function writeText(fs, relPath, content) {
+    await fs.writeText(fs.resolve(relPath), content);
+}
+function sanitize(id) {
+    return id.replace(/[^0-9a-zA-Z_-]/g, '-');
+}
+const taskPath = (id) => `.dsh/task-${sanitize(id)}.json`;
+/** Resolve the effective workflow: bundled default overlaid by `.dsh/eng.json`. */
+async function resolveWorkflow(fs) {
+    const raw = await readText(fs, '.dsh/eng.json');
+    if (raw === undefined)
+        return DEFAULTS;
+    try {
+        return loadWorkflow(DEFAULTS, JSON.parse(raw));
+    }
+    catch {
+        return DEFAULTS;
+    }
+}
+async function loadTask(fs, id) {
+    const raw = await readText(fs, taskPath(id));
+    if (raw === undefined)
+        throw new Error(`no task "${id}" under ${taskPath(id)}`);
+    return JSON.parse(raw);
+}
+async function writeTask(fs, state) {
+    await writeText(fs, taskPath(state.id), JSON.stringify(state, null, 2));
+}
+const OPERATIONS = ['status', 'create', 'confirm', 'advance', 'verify', 'review', 'commit'];
+const TOOL_DESCRIPTION = 'Own the engineering delivery workflow as hard state. Read or create the task record, record a ' +
+    'confirmation, advance one stage (rejected unless every configured guard already holds), record ' +
+    'verification or review, and gate a commit on stage/scope/message. The tool refuses illegal moves ' +
+    'instead of degrading — treat a rejection as a fact to fix, not a prompt to retry another way.';
+export function apply(ctx) {
+    ctx.tools.register(defineTool({
+        name: 'dev_task',
+        description: TOOL_DESCRIPTION,
+        parameters: {
+            operation: { type: 'string', enum: [...OPERATIONS], required: true, description: 'Which task-record action to perform.' },
+            task_id: { type: 'string', description: 'Task id; required except for create.' },
+            branch: { type: 'string', description: 'Current git branch (recorded on create).' },
+            title: { type: 'string', description: 'Task title (create).' },
+            work_size: { type: 'string', enum: ['tiny', 'standard', 'complex'], description: 'Workload tier (create).' },
+            risk_level: { type: 'string', enum: ['standard', 'high_risk'], description: 'Risk tier (create).' },
+            items: {
+                type: 'array',
+                description: 'Implementation items (create/update).',
+                items: {
+                    type: 'object',
+                    additionalProperties: false,
+                    properties: {
+                        id: { type: 'string' },
+                        title: { type: 'string' },
+                        status: { type: 'string', enum: ['todo', 'doing', 'done'] },
+                    },
+                },
+            },
+            field: { type: 'string', enum: ['requirement', 'solution'], description: 'Which confirmation (confirm).' },
+            target_stage: { type: 'string', description: 'Stage to advance to (advance).' },
+            passed: { type: 'boolean', description: 'Verification passed (verify).' },
+            evidence: { type: 'array', items: { type: 'string' }, description: 'Verification evidence (verify).' },
+            outcome: { type: 'string', enum: ['pass', 'blocked'], description: 'Review outcome (review).' },
+            message: { type: 'string', description: 'Commit summary to validate (commit).' },
+            hash: { type: 'string', description: 'Commit hash to record after the git commit (commit).' },
+        },
+        output: {
+            schema: { type: 'string' },
+            render(_args, value) {
+                return [{ type: 'text', text: value }];
+            },
+        },
+        async execute(args) {
+            const a = args;
+            const workflow = await resolveWorkflow(ctx.fs);
+            if (a.operation === 'create') {
+                if (!a.task_id || !a.title || !a.branch) {
+                    throw new Error('create requires task_id, title, and branch');
+                }
+                const state = newTask({
+                    id: a.task_id,
+                    title: a.title,
+                    branch: a.branch,
+                    work_size: a.work_size ?? 'standard',
+                    risk_level: a.risk_level ?? 'standard',
+                }, workflow);
+                state.items = a.items ?? [];
+                await writeTask(ctx.fs, state);
+                return `created ${state.id} at stage ${state.stage}; legal next: ${legalTargets(state.stage, workflow).join(', ') || 'none'}`;
+            }
+            if (!a.task_id)
+                throw new Error('task_id is required for this operation');
+            const state = await loadTask(ctx.fs, a.task_id);
+            if (a.operation === 'status') {
+                return JSON.stringify({
+                    id: state.id,
+                    stage: state.stage,
+                    risk_level: state.risk_level,
+                    work_size: state.work_size,
+                    requirement_confirmed: state.requirement_confirmed,
+                    solution_confirmed: state.solution_confirmed,
+                    items_done: `${state.items.filter(i => i.status === 'done').length}/${state.items.length}`,
+                    verification: state.verification,
+                    review: state.review,
+                    legal_next: legalTargets(state.stage, workflow),
+                    commit: commitCheckpoint(state, workflow),
+                }, null, 2);
+            }
+            if (a.operation === 'commit') {
+                const checkpoint = commitCheckpoint(state, workflow);
+                if (!checkpoint.allowed)
+                    throw new Error(checkpoint.reason ?? 'no commit is due');
+                const message = validateCommitMessage(a.message ?? '', workflow);
+                if (!message.ok)
+                    throw new Error(message.errors.join('; '));
+                if (a.hash)
+                    state.commits.push({ label: checkpoint.label, hash: a.hash });
+                await writeTask(ctx.fs, state);
+                return `commit approved (${checkpoint.label ?? ''}) — git add <task files>; git commit -m "${a.message ?? ''}"`;
+            }
+            switch (a.operation) {
+                case 'confirm':
+                    if (a.field === 'requirement')
+                        state.requirement_confirmed = true;
+                    else if (a.field === 'solution')
+                        state.solution_confirmed = true;
+                    else
+                        throw new Error('confirm requires field: requirement|solution');
+                    break;
+                case 'advance': {
+                    const result = assertAdvance(state, a.target_stage ?? '', workflow);
+                    if (!result.ok)
+                        throw new Error(result.errors.join('; '));
+                    state.stage = a.target_stage;
+                    break;
+                }
+                case 'verify':
+                    state.verification = { passed: a.passed === true, evidence: a.evidence ?? [] };
+                    break;
+                case 'review':
+                    if (a.outcome !== 'pass' && a.outcome !== 'blocked')
+                        throw new Error('review requires outcome: pass|blocked');
+                    state.review.outcome = a.outcome;
+                    break;
+                default:
+                    throw new Error(`unknown operation ${a.operation}`);
+            }
+            await writeTask(ctx.fs, state);
+            return `ok (stage ${state.stage})`;
+        },
+    }));
+    // Ship the bundled engineering skills into this bundle's layer of the host
+    // skill registry (optional surface: skip when the registry is absent).
+    const skills = ctx.get('skills');
+    if (skills !== undefined) {
+        const skillsRoot = fileURLToPath(new URL('../skills/', import.meta.url));
+        for (const entry of readdirSync(skillsRoot, { withFileTypes: true })) {
+            if (!entry.isDirectory())
+                continue;
+            const raw = readFileSync(fileURLToPath(new URL(`../skills/${entry.name}/SKILL.md`, import.meta.url)), 'utf8');
+            const m = raw.match(/^---\n([\s\S]*?)\n---\n([\s\S]*)$/);
+            if (!m)
+                continue;
+            const head = m[1];
+            const body = m[2];
+            const meta = {};
+            for (const line of head.split('\n')) {
+                const i = line.indexOf(':');
+                if (i > 0)
+                    meta[line.slice(0, i).trim()] = line.slice(i + 1).trim();
+            }
+            if (!meta.name || !meta.description)
+                continue;
+            skills.register({
+                name: meta.name,
+                description: meta.description,
+                ...(meta.whenToUse !== undefined ? { whenToUse: meta.whenToUse } : {}),
+                content: body,
+                source: 'custom',
+            });
+        }
+    }
+}
+//# sourceMappingURL=index.js.map

package/lib/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -0,0 +1,50 @@
+{
+  "name": "@godv61/dsh-task-engine",
+  "version": "0.1.0",
+  "description": "Config-driven engineering delivery engine for DeepSeek Harness: a `dev_task` tool that hard-gates workflow stage transitions and commit scope/message, plus bundled skills and an opt-in preset.",
+  "type": "module",
+  "main": "lib/index.js",
+  "types": "lib/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./lib/index.d.ts",
+      "default": "./lib/index.js"
+    },
+    "./cordis.patch.yml": "./cordis.patch.yml",
+    "./defaults/eng.json": "./defaults/eng.json",
+    "./package.json": "./package.json"
+  },
+  "files": [
+    "lib/**",
+    "cordis.patch.yml",
+    "defaults/eng.json",
+    "skills/**",
+    "preset/**",
+    "README.md"
+  ],
+  "license": "MIT",
+  "publishConfig": {
+    "access": "public"
+  },
+  "dsh": {
+    "bundle": {
+      "patch": "./cordis.patch.yml"
+    }
+  },
+  "scripts": {
+    "build": "tsc -p tsconfig.json",
+    "typecheck": "tsc -p tsconfig.json --noEmit",
+    "prepare": "tsc -p tsconfig.json"
+  },
+  "peerDependencies": {
+    "@deepseek-ai/cordis": "^4.0.2",
+    "@deepseek-ai/dsh-tools": "^0.1.2-rc.1"
+  },
+  "devDependencies": {
+    "@deepseek-ai/cordis": "^4.0.2",
+    "@deepseek-ai/dsh-tools": "^0.1.2-rc.1",
+    "@deepseek-ai/dsh-fs": "^0.1.2-rc.1",
+    "@types/node": "^22.0.0",
+    "typescript": "^5.7.2"
+  }
+}

package/preset/persona.md

@@ -0,0 +1,5 @@
+You are an engineering-delivery coding agent, powered by the {{model}} model, running on DeepSeek Harness. Your working directory is {{cwd}}.
+
+本仓库采用工程化交付流程，由 `dev_task` 工具硬性持有任务状态机：需求评审 → 设计 → 开发 → 交付 → 代码审核。阶段、流转门槛、提交格式都来自项目根 `.dsh/eng.json`（没有该文件则用内置默认）。任何开发类请求开始前，先加载 `eng-delivery` 技能。
+
+铁律：一切阶段流转、确认、验证、评审和提交都必须通过 `dev_task`——它拒绝时是硬事实，必须修正前置条件，禁止绕过。只做任务范围内的本地提交；绝不 push、合并、创建 PR、执行数据库、操作 Jenkins、部署或发布。

package/preset/preset.yml

@@ -0,0 +1,2 @@
+name: 工程化开发引擎
+description: 通过 dev_task 工具硬性持有需求评审→设计→开发→交付→代码审核的状态机，按项目 .dsh/eng.json 配置流转与提交门禁。

package/skills/eng-delivery/SKILL.md

@@ -0,0 +1,20 @@
+---
+name: eng-delivery
+description: 使用 dev_task 工具编排工程化交付流程；按当前分支任务、配置的状态机与提交门禁推进需求评审、设计、开发、交付、代码审核。
+---
+
+# 工程化交付
+
+`dev_task` 工具是流程的唯一事实来源与硬约束。阶段、流转门槛、提交格式来自项目根 `.dsh/eng.json`（没有该文件则用 bundle 内置默认，见 `defaults/eng.json`）。
+
+## 入口
+
+1. 先 `dev_task`（operation=status）读当前分支任务；没有任务则（operation=create）建立任务并停在起始阶段。
+2. 每阶段：完成本阶段产物后，用 `dev_task`（operation=advance）流转到目标阶段；被拒绝说明 guard 未满足（确认没过 / 实施项没完 / 高风险没验证 / 评审没过），先补齐再重试，不得绕过。
+3. 提交前用 `dev_task`（operation=commit）校验阶段、提交范围与消息格式；拿到 approved 消息后再执行 `git add <任务内文件>; git commit -m "<approved>"`，并把 commit hash 通过 `dev_task`（operation=commit, hash=...）回写。
+
+## 硬规则
+
+- 需求、Bug、继续开发、验证、评审、提交请求一律经 `dev_task` 状态机推进，不自行绕过。
+- 只做任务范围内的本地提交；绝不 push、合并、创建 PR、执行数据库、操作 Jenkins、部署或发布。
+- `dev_task` 的拒绝是硬事实：修正前置条件，而不是换一种方式绕过。