前言¶
DeepSeek Harness（DSH）强调“一切皆插件”。在构建编码 Agent 时，行为的一致性与可追溯性往往依赖于人工维护的规范文档。agent-discipline 是一个 DeepSeek Harness bundle，它将《Harness Engineering Methodology》（HARNESS-METHODOLOGY-SPEC v1.0）转化为可执行的工程约束。该插件通过注入方法论提示段、提供脚手架工具以及执行合规审计，旨在为 AI Agent 的仓库开发建立一套自动化的纪律约束体系。
核心功能¶
提示段注入
插件安装后会自动向 Harness 的 system-prompt 注入 agent-discipline 章节（order -90）。模型将依据该章节中的 §1.3 会话生命周期与核心不变式开展工作，确保 Agent 遵循预定义的开发范式。
工具集
插件提供三个核心工具，用于状态管理、初始化和审计：
- agent_discipline_init：在目标仓库生成 §8 工件模板（包含入口指令、特性清单、进度追踪、验证门、命名注册等）。
- agent_discipline_audit：对照 §10 审计规范，对仓库进行只读的启发式检查（涵盖 CRITICAL 6 项及推荐抽样、五子系统评分等）。
- get_feature / update_feature / verify_feature：用于状态机的服务化操作，替代手动修改 JSON 文件。
状态机服务化（形态 C）
当前版本（形态 C）已落地。状态机被服务化为 Harness 的能力缝，通过 ctx.features 进行管理。
- 严格状态折叠：实现了形态 C 的严格折叠机制，非法状态跳转或缺失证据（如 WIP=1 无证据）会被判定为 corrupt。
- 事件日志真源：会话日志是状态真源，feature_list.json 仅为导出投影。手动修改投影文件会被真源覆盖。
- 自证：插件自身采用 Dogfooding 方式开发，可通过 node scripts/acceptance.mjs self 进行自审计。
安装与启用¶
在 DeepSeek Harness 环境中，通过官方 CLI 安装该插件：
dsh plugin --profile web add agent-discipline
安装后无需额外配置，提示段注入与工具注册自动生效。
典型用法¶
初始化仓库工件
在目标仓库目录下执行初始化工具，生成所需的 §8 工件模板。若文件已存在，工具会自动跳过。
agent_discipline_init
执行合规审计
使用审计工具对照 §10 规范检查当前仓库状态。该工具为只读操作，主要进行文本和结构启发式检查，不会执行目标仓库的具体验证命令。
agent_discipline_audit
自证插件状态
为了确保插件本身符合其定义的纪律，可运行自证脚本：
node scripts/acceptance.mjs self
适用场景与注意¶
适用场景
适用于需要严格遵循工程方法论进行代码生成的 Agent 场景，特别是对仓库状态机、特性清单管理和审计合规有较高要求的团队。
注意事项
- 审计范围：agent_discipline_audit 为启发式检查，不执行目标仓库的验证命令本身，仅作文本和结构分析。
- 状态真源：feature_list.json 是导出投影，禁止手动编辑，应通过 get_feature / update_feature 等工具进行修改，否则会被真源覆盖。
- 依赖版本：依赖版本声明为 >=0.1.0-0，这是预发布期的宽松声明，正式环境可能需要收紧。
- 可选伴生：invariant 伴生模块为可选装配，需单独引入 @deepseek-ai/dsh-invariants 才能启用内部拦截。
结语¶
agent-discipline 通过将方法论从文档转化为代码约束，为 DSH 插件开发提供了纪律保障。它结合了形态 C 的严格状态折叠与事件溯源机制，使得 AI Agent 的开发过程具备更强的可控性与可审计性。
