前言¶
在 DeepSeek Harness (DSH) 的开发场景中，让模型遵循严谨的工程方法论（如测试先行、故障隔离、代码审查）通常需要复杂的提示词拼接。dsh-praxis 旨在解决这个问题，它将资深工程师的工作流硬化为标准技能库，通过插件形式集成到 DSH 中，使模型能够自动进入结构化的工程流程。
插件定位¶
dsh-praxis 是一个工程方法论技能库插件，作者为 JohnXu22786。它解决了模型缺乏结构化工程流程的问题，将设计对话、编写计划、测试先行、系统调试等行为硬化为一套可自动触发的技能。
核心能力¶
插件内置 14 种技能，覆盖软件开发的各个阶段。这些技能遵循 Agent Skills 标准，兼容 DSH 的本地技能发现器。
- method-compass：任务启动时，理解技能库并选择首个技能。
- design-conversation：需求模糊或设计未定时，先进行对话确认。
- implementation-blueprint：设计确定后，编写可执行的步骤计划。
- blueprint-execution：按计划执行，设置检查点验证，汇报偏差。
- test-first-cycle：编写代码时，按红-绿-重构流程进行测试。
- fault-isolation：遇到异常时，基于证据排查根因，而非猜测。
- completion-proof：在声称完成前，提供可观测的证据。
- task-splitting：并行任务拆分，按契约、派发、集成组织。
- delegated-build：将计划交给子代理，设置两轮审查把关。
- review-preflight：请求代码审查前，进行自检和自测。
- feedback-assimilation：收到反馈后，消化、修复并逐项回应。
- lane-isolation：并行开发时，确保分支拥有独立工作区。
- branch-conclusion：分支合并到主干前的完整收尾流程。
- skill-authoring：编写、修改或验证新技能。
安装与启用¶
安装后无需手动配置，模型遇到触发场景时自动加载技能。插件也支持零代码集成。
标准插件安装¶
dsh plugin --profile demo add github:JohnXu22786/skill-framework
零代码集成¶
插件仓库中的 skills/ 目录本身就是一套标准的 Agent Skills 集合，可直接复制到 DSH 的本地技能根目录：
cp -r skills/* ~/.dsh/skills/
此路径由 DSH 内置的 dsh-skill-filesystem 发现器加载，无需安装此插件。
配置与使用¶
配置项¶
插件支持通过配置文件设置技能目录。在 cordis.patch.yml 中可配置：
- providerName：技能提供者名称，默认为 praxis-bundled。
- skillsDir：技能根目录，默认为包根目录下的 skills，支持数组格式。
使用示例¶
对话中可以直接指定技能组合。例如：
先给实施计划，再执行。
在调试时优先使用故障隔离流程，完成前提供证据。
技能之间通过依赖声明相互触发，例如 fault-isolation 会依赖 method-compass 和 blueprint-execution。
环境要求¶
- DeepSeek Harness
dsh版本需 ≥ 0.1.0-rc.6（标准配置已挂载dsh-skill和dsh-tool-skill）。 - Node.js 版本需 ≥ 22。
- 需要安装
dsh-skill和dsh-tool-skill。
结语¶
dsh-praxis 通过标准化的技能库，将资深工程师的工作流自动化。它适用于需要严谨工程规范的 DSH 场景，能够显著提升模型在代码生成、调试和协作环节的规范性。更多详情可查看插件目录或 GitHub 仓库。
