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

dsh-plugin-forge

一个用于开发 DeepSeek Harness 插件的 agent 技能——从需求到合并 PR。

该技能引导一个插件经历六个阶段，每个阶段都有完成标准：

1. 设计——是否真的需要插件、是单个包还是三角色能力接缝、宿主平面还是预设平面，以及一份设计问题清单（模型可见？可配置？副作用？密钥？持久状态？UI？）。
2. 脚手架——工作区包骨架及其 package.json/tsconfig 不变量。
3. 实现——两种插件形式、使用 schemastery 的 Config、声明合并，以及一套从 harness 自身核心包中提炼出的模式库（effects、events、tool execution、durable state、errors）。
4. 接线——cordis.yml 组合：bundle 补丁 vs agent 预设，以及 verify-cordis-config / --dump-config 检查。
5. 测试——五规范矩阵（单元 + HMR 安全性 + 导出形状 / 加载器组合 / 集成 / 不变量 / 投影）以及可复用的 testkit，而非手工编写 mock。
6. 发布——规范的 README 章节、生成的目录、Agent Notes、PR 标签。

外加症状优先的调试（PENDING fibers、静默加载失败、HMR 泄漏）以及交互接缝（审批、凭据、用户提问）。

安装

将此目录复制或符号链接到你的 agent 技能目录（例如 .agents/skills/dsh-plugin-forge/、.claude/skills/，或你的 Codex 技能路径）。该技能由模型调用：当任务涉及创建、更改、调试、测试、接线或发布 dsh 插件时，它会被触发。

为获得最佳体验，还应将 agent 指向本地检出：

export DEEPSEEK_HARNESS_REPO=/path/to/deepseek-harness

结构

SKILL.md            # 工作流、速查卡、陷阱、参考路由
references/
design.md         # 需求 → 插件方案；拆分规则；平面选择
blueprints.md     # 包骨架、插件主体、cordis.yml 接线
patterns.md       # 来自核心包的经过验证的形态，附来源
testing.md        # 规范矩阵、testkit、覆盖率与快照职责
external-bundle.md # 来自独立仓库的可安装 bundle；Web 客户端半部分格式
interaction.md    # 审批、凭据、用户提问
debugging.md      # PENDING 诊断、--dump-config、静默失败
shipping.md       # README 关卡、目录、Agent Note、PR 要求
agents/openai.yaml  # Codex 调用元数据
tests/check-skill.mjs  # 自检（见下文）

自检

node tests/check-skill.mjs 会校验该技能本身：SKILL.md frontmatter（名称与目录匹配、description 存在）、代码围栏配对、内部链接目标与锚点，以及每个固定引用的上游 GitHub 链接的可达性。传入 --offline 可跳过 HTTP 探测。GitHub Actions 在每次 push 和 PR 时运行它；任何编辑后都要运行它，重新固定引用后更是必须运行。

链接与版本管理策略
文档链接固定到 harness 仓库的 dsh-v0.1.5-rc.2 标签——稳定且可审计，代价是需要网络访问。将 DEEPSEEK_HARNESS_REPO 设置为本地检出以获取实时源码；当检出与固定页面不一致时，以检出为准，该技能需要重新固定。重新固定：替换每个链接中的标签，并重新验证所引用的章节是否仍与本文档所述一致。