工程配置档 bigunmd/gold

GOLD 工程预设

可安装的 Cordis 包 @local/dsh-gold-preset：一套共享的工程内核、可选专长、自适应协作。1.4.0 版新增六个 Ponytail 技能和 27 个 Matt Pocock 技能，并带上 GOLD/DSH 防护措施，同时保留 1.3.0 引入的可靠执行契约与实证评估工具。现有五个预设身份全部保持兼容。

文档

先看用户指南、快速开始，或六份任务配方。另见验证与限制、更新日志和发布检查清单。

这些链接指向按版本固定的文档。在源码检出中，同样的指南位于 docs/ 下。指南托管在仓库里，不打包进运行时包。

1.3.0 版：可靠执行

- 按需的分配/结果契约，带父级集成检查、有界执行预算和明确的里程碑策略。
- 恢复与收尾会先核对未完成的子项/任务和不确定的影响，再重启工作或声称完成。
- 验证把验收标准绑定到内容标识，包括反复出现的未提交修改；维护者指纹工具显式排除被忽略的输入。
- 真实模型行为评估用例会捕获工具事件、工作区差异、耗时和服务商上报的 token 用量。初始适配器使用 Codex CLI，不挂载 DSH 会话；启发式判断和沙箱影响需要人工复核记录。
- Git 夹具隔离、打包 Markdown 链接校验，以及可选的精确包/运行时 Loader 门禁。不新增运行时插件、权限或自动智能体。

参见可靠执行、行为评估和运行时门禁。

1.2.0 版：Git 纪律与领域专长

本次源码修订新增了精确的 Conventional Commit／分支规范、禁止模型署名的规则，以及八项按需加载的专长：Git 与发布、安全、API 与契约、数据库与迁移、性能、文档、无障碍、事故调查。它们不新增预设、权限或自动智能体。仓库的专长指南与 Git 规范指南见 docs/ 目录。候选 Git 元数据检查可用 npm run check:git -- --base BASE_SHA --head HEAD_SHA 运行；分支命名在 CI 中只是建议，未知身份与同意无法机械证明。

部分专长材料改编自固定版本的 VoltAgent 修订。运行时包内附有第三方声明。必需的法律署名与明确批准的人类共同作者，和禁止的模型署名是两回事。这些新增内容包含在 v1.2.0 中，不在更早的 v1.1.0 标签里。

Ponytail 集成

五个 GOLD 预设都打包了 ponytail、ponytail-review、ponytail-audit、ponytail-debt、ponytail-gain 和 ponytail-help，改编自上游修订 9cc65d03aa2da1db7121b912d03596409ee340b8。编码任务在 full 模式下按需加载核心技能；评审与审计加载各自的技能。GOLD 的范围、协作、授权、验证与 C4 要求仍然具有最高效力。

使用 Harness 技能选择器，或直接按名称调用。说「ponytail lite/full/ultra/off」可切换会话内的指导。不会安装上游的生命周期钩子、全局模式设置或自动更新。除非批准持久化，债务报告保持只读；本地账本默认放在 .gold/。收益数字是上游的基准声明，不是实测的 GOLD/DSH 节省量。已有会话保留其预设修订；更新后请新建 GOLD 会话。

Matt Pocock 技能集成

五个预设还打包了 mattpocock/skills 中 27 项活跃的工程／生产力技能，固定于 b0618bc436ad893b3c5e84e55fba86586d34a404。实验性、已弃用和冻结的杂项技能已排除。完整的配套参考与模板保留；外部智能体元数据已排除。

可复用的方法论按需加载：tdd、diagnosing-bugs、codebase-design、domain-modeling、research、code-review、pr、prototype、wizard、grilling、writing-for-agents。16 个仅限用户的入口保留各自的调用标志：ask-matt、grill-with-docs、triage、improve-codebase-architecture、setup-matt-pocock-skills、to-spec、to-tickets、implement、implement-spec、wayfinder、retro、grill-me、handoff、teach、to-questionnaire、wait-what。请通过 Harness 技能选择器调用它们；它们有意不出现在模型发现／加载中。
GOLD/DSH 契约优先于上游指令：只读任务不自动改动 Git/远程、不做初始化、不关工单、不修复、不写备注。本地产物默认放进被忽略的 .gold/；经批准的共享术语表/ADR 保持纳入版本管理。工作区审查覆盖已暂存/未暂存/未跟踪的范围。向导持久化与远程写入辅助功能默认禁用，直到有人明确划定范围、写出安全的辅助脚本为止；脚本交给人工执行，不通过 DSH 交互式运行。这些是由指令驱动的防护措施，不是沙箱强制限制。

对于已配置的 tracker 工作流，每个目标项目都要显式调用一次 setup-matt-pocock-skills，用来确认 tracker、标签和领域文档的选择。安装这个包不会配置项目，也不会给工具做认证。现有的 GOLD/Ponytail 路由保持不变。不新增上游插件钩子、自动更新或替换运行时工具。

选择起点

| 预设 | ID | 适用场景 |
| GOLD Auto（推荐） | gold-auto | 按你要求的结果来路由，并提议有用的阶段 |
| GOLD Development | gold | 开发、修复和重构；保留现有身份 |
| GOLD Architect | gold-architect | 需求、架构、权衡和规划 |
| GOLD Reviewer / QA | gold-reviewer | 有证据支撑的审查、测试策略和验证 |
| GOLD DevOps | gold-devops | CI/CD、基础设施、发布和运维 |

专长只是初始焦点，不是硬性角色墙。你可以在批准范围后，让 Architect 转入实现。在会话内切换焦点不会重新挂载预设，也不会改变工具/权限。这个包不会改变你的 Harness 默认预设。

选择协作方式

| 风格 | GOLD 的工作方式 |
| Guided | 解释可选方案，在关键决策处询问；阶段划分小而明确 |
| Balanced（默认） | 推荐一种做法，处理已批准的常规细节，遇到实质性变更时询问 |
| Delegated | 在已批准的边界内自行解决常规细节；汇报里程碑，异常情况上报 |

示例：
- “用 GOLD Architect 设计这个服务，guided。不做实现。”
- “用 Balanced 风格实现这个；只动本地代码和测试。”
- “对已批准的计划切换到 Delegated；不部署。”
- “只审查。报告发现的问题，不要修任何东西。”

对于工作量较大的任务，如果你还没选风格，GOLD 会结合范围问题一并提议一种风格。它只在有意义的决策点询问，不按定时器、也不是每隔几条消息就问一次。已由完整且获批的任务简述覆盖的阶段，不会反复触发审批。纯提问保持轻量。Delegated 不要求使用子代理，不取消验收关卡，也不授权生产环境操作。
任务偏好优先于会话/项目风格偏好，但安全约束仍是约束。任务偏好会过期；偏好永远不能证明行动已获批准。本版本使用对话上下文和已授权的本地记录，不读取全局设置；不承诺跨会话保留偏好。

场景与工程准则

打包的 gold-standard-development 技能负责路由 Plan/Design、Develop、Debug/Investigate、Resolve issue、Review/Audit、Test/Validate 和 Release/Operate。架构/规划、软件开发、测试/QA、DevOps/可靠性、安全/隐私这几类参考文档只在相关时才加载。

规划、诊断、审查和测试执行报告不代表获得修复权限，也不代表交付已被接受。测试会改变状态：GOLD 运行前会先检查测试的副作用和目标。发布准备、发布、部署和恢复是彼此独立的范围。

可选流程技能补充自包含的质量核心，但不能强制触发自动 Git 操作，也不能强制提交规划产物。项目技能可以遮蔽打包资源；关键人格约束仍然有效，真实冲突必须暴露出来。

产物与边界

本地简报、进度、调查、证据和有界记忆存放在仓库根目录 .gold/，通过 /.gold/ 忽略。共享的 ADR、C4 和 runbook 保持纳入版本跟踪。每次收尾都评估 C4；只更新实际变更和已证实的不准确之处，不为走形式改图或改 ADR。

本地记录是缓存，不是批准证明。它们不会通过 Git/worktree 传递。忽略规则保护不了已被跟踪的文件或密钥。只读请求不授权写笔记文件，也不授权改 .gitignore；非 Git 工作区没有忽略保护。交接要带上范围/来源、修订/脏状态、决策/证据、风险，以及下一个已授权的动作。

靠指令驱动，而非强制隔离： Architect 和 Reviewer 保留 shell 等工具，不是只读沙箱。运行时权限策略和明确的行动范围仍是权威。任何预设或风格都不授予发布、部署、破坏性恢复或远程关闭 issue 的权限。

安装与更新

使用 Harness 的 plugin_manager 工具：action: install_bundle，target 设为已审查 bundle 所在的绝对目录。不要手动编辑配置档清单，也不要在配置档里安装依赖。激活后在新会话里选择想要的 GOLD 预设；已有会话保留其预设修订版本。替换包之后按需重启 DSH。

走 GitHub 分发时，从 https://github.com/bigunmd/gold 安装 github:bigunmd/gold#v1.4.0。较旧的 github:bigunmd/gold#v1.0.0 不含这次自适应更新。没有自动 Git 同步；private: true 防的是误发 npm，不是防 Git 安装。
本地安装可以直接链接到源码目录。保留该目录不动，在隔离的工作区里改代码，避免误改已安装的源码。集成与激活是两个独立的授权动作。技能路径按已安装包的身份解析，而不是按作者工作站的路径解析。

开发与验证

维护者编辑 preset-src/core-persona.txt、preset-src/roles.mjs 和 preset-src/shared-tools.yml；用下面的命令生成声明式产物：

npm run build:presets
npm test
npm run check:presets
npm run check:docs
npm run check:package
npm pack --dry-run --json

cordis.patch.yml 是生成出来的，并会检查是否过期。运行时使用方只需要生成的产物和打包好的技能；生成器的输入、脚本、测试以及 .gold/ 都不随包发布。没有安装脚本、没有新增依赖、没有自定义宿主插件，也不假设原生支持预设继承。共享的 Standard 工具组合，以及规划、压缩、委派三者的隔离都保留；升级 Harness 时请与当前的 Standard 对比。

测试覆盖生成行为、过期检查、包契约、资源上限和相对链接。tests/scenarios.md 定义了指令评估用例。要区分结构测试、静态使用方模拟和全新会话的运行时证据：任何一项单独都不能证明模型遵守了指令或强制生效。

1.3.0 证据记录把结构解析与运行时解析检查，和 28 次重复的 Codex 适配器模型/工具运行分开记录。严格重评中，基线和初始候选都通过了 11/14 次运行；语义评审仍保留命令范围和因果 RED 两处缺口，而不是声称完全合规。挂载 DSH 后的全新会话行为仍未验证。历史证据与当前局限是两回事。

授权激活后的全新会话冒烟清单

1. 确认有五个可选的 GOLD 条目，且全局默认值未变。
2. 为每个条目开一个新会话，加载 gold-standard-development，确认能发现打包资源。
3. 让 Auto 规划一项较大的工作，但不选风格；预期得到 Balanced 方案，并附带范围澄清。
4. 在已批准的仅本地范围内先选 Guided，再选 Delegated；预期有实质性的检查点，但不会自动获得团队或生产权限。
5. 让 Architect 只做设计、Reviewer 只给发现；预期不产生编辑。就带副作用的共享数据库测试询问 QA，就发布准备询问 DevOps；预期得到目标与范围的边界说明。
6. 确认已覆盖的阶段转换复用审批，完成报告只陈述当前证据，不声称已获验收。

社区与许可

GOLD 采用 MIT 许可证。请参阅贡献指南、行为准则、安全政策和无障碍声明。公开报告请使用 GitHub 的 bug/功能表单；漏洞和行为问题请通过政策中的私密联系方式上报。

回滚

先按精确标识符列出 bundle，然后在获得授权的前提下，用 plugin_manager 的 set_bundle 禁用 @local/dsh-gold-preset，或用 remove_bundle 移除它。要恢复之前的版本，请重新安装明确选定的旧 bundle/版本。已有会话可能仍保留已加载的修订版本。切勿把删除旧文件、链接的源码目录或本地工作成果当作自动回滚步骤。