前言¶
DSH 的 AGENTS.md 文件受 65536 字节预算限制。当预算不足时,最宽泛的文件优先被丢弃,这会导致工作流规则静默失效。原来的做法是将工作流直接写入 AGENTS.md,存在失效风险。dsh-godot-workflow 通过宿主的 ctx.systemPrompt.section() 将 Godot 工程开发工作流常驻注入,不再占用 AGENTS.md 的字节预算。
这是什么¶
这是一个由 AtlacherCoder 维护的本地 DSH 插件。它将原本放在 AGENTS.md 中的 Godot 工作流拆分为两部分:常驻精简核心和按需加载的完整技能,确保工作流在预算紧张时依然可用。
核心功能¶
- 将
AGENTS.md中的 Godot 工作流转为本地插件。 - 常驻注入精简核心,不占用
AGENTS.md字节预算。 - 按需加载
godot-workflow技能。 - 包含五条铁律、流程骨架及崩溃级硬约束。
- 包含完整流程细则、硬约束全表及四类模板。
安装与启用¶
使用 link: 协议安装,源码修改即时生效,但插件内容在激活时读取,修改 .md 后需重启 dsh web 才能重新注入。
dsh plugin --profile web add link:/home/atlaslinux/PluginManager/dsh-godot-workflow
dsh --profile web --dump-config | grep -A2 godot-workflow
排序与用法¶
常驻核心的排序锚点为 510,位于 PLAN_POLICY(500) 之后、TEAM_POLICY(600) 之前;取不到锚点时回落 550。
两个通道分别用于不同场景:
- 常驻段落
godot:workflow:对应.dsh/prompt/core.md(约 3 KB),包含五条铁律、流程骨架及崩溃级硬约束。每个会话自动加载。 - 技能
godot-workflow:对应.dsh/skills/godot-workflow/SKILL.md(约 9.7 KB),包含完整流程细则、硬约束全表及四类模板。Agent 通过skill工具按需加载。
已知限制¶
- 异常处理:DSH 启动全有全无,插件异常不抛错,只记
error日志并降级。 - 功能边界:不处理决策日志同步、回退件及门禁,由各工程
tools/脚本承担。 - 文件更新:使用
link:协议修改源码后,必须重启dsh web才能重新注入.md文件。 - 体积:常驻核心实际体量为 3038 B,大于设计目标 ~2 KB。
自检¶
插件包含自检脚本,可在安装或开发阶段把关完整性:
node scripts/verify.mjs
node scripts/verify.mjs --against ~/.dsh/AGENTS.md
结尾¶
该插件通过分离常驻核心与完整技能,确保了 Godot 工作流在 AGENTS.md 预算不足时依然可用。更多详情可参考项目主页。