插件锻造工坊 Elinpf/dsh-plugin-forge

dsh-plugin-forge

一个智能体技能，用来开发 DeepSeek Harness 插件——从需求到合并 PR。

这个技能带一个插件走完六个阶段，每个阶段都有完成标准：

1. 设计——到底要不要插件、做成单个包还是三职责的能力接缝、放在宿主平面还是预设平面，外加一份设计问题清单（对模型可见吗？可配置吗？有副作用吗？涉及密钥吗？有持久状态吗？有 UI 吗？）。
2. 脚手架——工作区包骨架，以及它的 package.json/tsconfig 不变量。
3. 实现——插件的两种形态、用 schemastery 写 Config、声明合并，还有一套模式库，提炼自 harness 自己的核心包（副作用、事件、工具执行、持久状态、错误）。
4. 接线——cordis.yml 组装：bundle 补丁 vs 智能体预设，以及 verify-cordis-config / --dump-config 检查。
5. 测试——规格矩阵（单元 + HMR 安全 + 导出形态 / loader 组装 / 集成 / 投影），还有可以直接复用的 testkit，不用自己手搓 mock。
6. 发布——规范的 README 章节、生成的目录、Agent Notes、PR 标签。

另外还有症状优先的调试（PENDING fiber、静默加载失败、HMR 泄漏）、一份错误文本速查表，对应那些能编译但加载或首次使用就挂的坑，以及交互接缝（审批、凭据、用户提问）。

安装

把这个目录复制或软链到智能体的技能目录（比如 .agents/skills/dsh-plugin-forge/、.claude/skills/，或你的 Codex 技能路径）。这个技能由模型调用：任务涉及创建、修改、调试、测试、接线或发布 dsh 插件时就会触发。

想要最佳体验，再把智能体指向本地 checkout：

export DEEPSEEK_HARNESS_REPO=/path/to/deepseek-harness

结构

SKILL.md # workflow, cheat card, pitfalls, reference routing
references/
design.md # requirement → plugin plan; splitting rules; plane selection
blueprints.md # package skeleton, plugin bodies, cordis.yml wiring
patterns.md # proven shapes from the core packages, with sources
testing.md # spec matrix, testkits, coverage and snapshot duties
external-bundle.md # installable bundles from a standalone repo; the web client-half format
interaction.md # approval, credentials, user questions
debugging.md # PENDING diagnosis, --dump-config, silent failures
contract-traps.md # error text → cause → fix (schema DSL, export shape, tsconfig, runtime)
shipping.md # README gates, catalogs, Agent Note, PR requirements
agents/openai.yaml # Codex invocation metadata
tests/check-skill.mjs # self-checks (see below)

自检

node tests/check-skill.mjs 校验技能本身：SKILL.md 的 frontmatter（name 与目录一致、description 存在）、代码围栏是否配对、内部链接目标与锚点，以及每个固定指向的上游 GitHub 链接是否可达。加 --offline 跳过 HTTP 探测。GitHub Actions 在每次 push 和 PR 时运行它；任何编辑之后都要跑一遍，重新固定版本之后更是必跑。

链接与版本策略

文档链接固定指向 harness 仓库的 dsh-v0.2.1-rc.3 标签——稳定、可审计，代价是需要联网。把 DEEPSEEK_HARNESS_REPO 设为本地检出目录，就能读到实时源码；本地检出与固定页面不一致时，以本地检出为准，技能需要重新固定版本。重新固定版本的做法：替换所有链接里的标签，再核对引用的章节是否仍与技能中的说法一致。