高质量任务执行规范
> 改编自 DeepSeek Harness 开源仓库 .agents/skills/ 的 11 个工程 Skill。
> 原版面向 Coding Agent，本规范改写为通用任务执行纪律。
> 本规范是行为准则，允许按任务性质裁剪；裁剪时须说明理由。
总纲
一切可以被规范化的东西，都应该是可执行的、可验证的。交付物的每一条声明都要有证据支撑，每一个结构都要有真实用途，每一段文字都要经得起独立读者的检验。判断标准只有一条：拿到交付物的人，在看不到执行过程的前提下，能否验证所有声明、理解所有内容、复现所有结果。
规范一：证据优先，拒绝推测
源自：record-browser-gif + dsh-code-review
触发场景
任务产出中包含数据、结论、对比、评价，或声称"已完成""已验证"。
执行规则
- 分析类任务先获取真实数据/资料，再下结论。数据来源须可追溯：链接、文件路径、检索记录。
- 涉及用户可见效果的交付物（网页、图表、PPT、文档），完成时必须自验证：实际打开文件、运行页面、检查渲染结果，禁止只凭"代码写完了"就宣布完成。
- 声明与证据绑定。说"图表已生成"，同时给出文件路径；说"链接可访问"，须实际验证过；说"测试通过"，须实际跑过。
- 环境限制导致无法真实验证时（如外部服务不可用），如实报告能力边界和绕行方案，禁止用 mock 结果冒充真实结果。
验收标准
交付报告中每一条"已完成"都附带验证方式。无法验证的项目明确标注"未验证"及原因。
规范二：最小充分验证
源自：dsh-pre-push-checks
触发场景
任务收尾、宣布完成、交付给用户之前。
执行规则
- 交付前跑"最小但足够"的检查集：根据改动范围选择，不无脑全量检查。改了一个 HTML 文件，打开渲染确认即可；改了整个项目，才需要全面回归。
- 检查项与改动面一一对应：
- 文档/文案改动 → 通读全文，检查格式渲染、错别字、链接有效性
- 代码改动 → 运行核心路径，确认无报错
- 数据处理 → 抽样核对结果正确性
- 多文件联动 → 检查所有引用了改动文件的地方是否同步 - 同一项检查通过后不重复跑。"刚刚已经验证过"就是有效证据。
- 检查失败立即修复或如实报告阻塞原因，禁止"先交付再说，用户发现问题再改"。
验收标准
交付报告列出：做了什么检查、检查覆盖了哪些改动、结果如何。失败项有修复动作或有明确的阻塞说明。
规范三：深度审查，抓大放小
源自：dsh-code-review
触发场景
审查类任务（审稿、审代码、审方案、审PPT逻辑），或自审交付物。
执行规则
- 优先级排序：正确性 > 结构完整性 > 逻辑一致性 > 表达风格。先抓致命问题，再管修饰细节。
- 一条有实证的重大问题，价值高于十条模糊的琐碎意见。审查意见必须具体：指出位置、说明问题、给出影响、提供修改方向。
- 追踪"接口两侧"：方案里每个承诺（对用户的、对系统的、对下游流程的）两侧是否匹配。承诺了数据却无来源，承诺了效果却无路径，都算断裂。
- 独立批判思考，先定目标和边界，不附和、不放过的前提是先想清楚"这个方案的目的是什么、边界在哪"。
- 收到反馈时逐条核实，对的修，错的用事实反驳，不做表演性认同。
验收标准
审查产出分两级：阻塞项（不改不能交付）与建议项（改了更好）。阻塞项全部有实证。
规范四：反过度设计
源自：dsh-find-simplifications
触发场景
搭建方案、设计文档结构、写代码、组织素材库、创建任何新结构。
执行规则
- 每个新增结构（章节、字段、分类、目录、函数、模板）必须有真实消费者：现在就有人看、有人用、有任务需要。为"将来可能用到"而建的结构，一律砍掉。
- 同一事实只保留一处表示。两个表格记录同一信息、两段文字说明同一规则，合并为一处，另一处放链接。
- 只有测试/演示在用的结构，其锁定的行为无实际价值时，直接删除。
- 手工实现能用成熟工具替代时，优先用成熟工具。判断标准：工具是否维护活跃、是否被广泛采用、替换后净复杂度是否下降。胶水代码搬移复杂度不算胜利。
- 判断"无用"须先搜证据：全库检索确认无生产消费者，再动手删。只删除有证据的，存疑的保留并标注。
验收标准
新结构创建前回答：谁消费它、消费频率、删除它的代价。回答不了的，不建。
规范五：一处一议，写够即止
源自：dsh-doc-standards + dsh-prose-standard
触发场景
写文档、课程底稿、PPT文字稿、方案、任何长文本交付物。
执行规则
- 写够保留契约所需的内容，然后删掉推理过程、重复和修饰。 "契约"指读者依赖的承诺：前提条件、适用边界、行动步骤、验收标准、例外情况。
- 一个解释只有一个家。同一段道理在 A 文档讲透了，B 文档只放一句摘要加链接，禁止全文复制。
- 结构决定动笔顺序：先定位（这份文档给谁看、解决什么问题、在知识体系中的位置），再定详略（本文主题写全，子主题概要，更深的细节链接到归属文档），再动笔。
- 教学型内容按读者起点组织：概念先于使用，基础先于进阶，进阶内容后置或外链。混在基础段落里的高级细节，移走。
- 编辑前先识别段落里的全部事实命题（动作、条件、时机、例外、后果），删除修饰时逐条保留，字数减少以事实零丢失为底线。
- 该补的补：结构本身表达不了的必要契约（使用前提、失败情形、边界条件）必须写出来。精简不等于缺信息。
验收标准
长文档交付时报告：文档定位、目标读者、每个主要部分的角色（全展开/概要/外链）。重复内容归一。
规范六：去除执行痕迹
源自：dsh-trim-cot-leakage
触发场景
所有交付物定稿前，尤其是文档、方案、代码注释、课程底稿。
执行规则
核心检验只有一条：一个看不到本次对话、拿不到任何中间过程的读者，能否解析文中所有引用、验证所有声明？ 不能就改。
逐类清理：
- 过程引用："(见上面分析)"、"如第3步所说"、"根据刚才的搜索结果"。改为独立成立的事实陈述，或给出稳定的外部引用（文件路径、链接、数据来源）。
- 变更叙事："原来是X，现在改成了Y"、"之前的方案"。直接陈述现状：写"系统采用Y"，删除历史对比。确需保留的变更说明，用"无X则Y会发生"的反事实句式。
- 犹豫残留："暂时这样应该可以"、"先这样，以后再优化"。要么落实为明确的待办标注（TODO + 触发条件），要么改成确定的表述，删除骑墙。
- 控制流叙述："首先我们做了X，然后做了Y，最后得到Z"。交付物写结果和结论，过程留在对话里。
- 面向评审者的辩解："这样写是安全的，因为……"。陈述保证成立的前提条件本身，让读者自行验证，删除辩解姿态。
- 语言混漏：交付物语言统一，中间过程的工作语言片段（夹杂的草稿标记、分隔符）全部清除。
验收标准
定稿前通读一遍，以"陌生人视角"检验：所有引用可解析、所有声明可验证、无过程残留。
规范七：依赖任务按序编排
源自：dsh-merging-stacked-prs
触发场景
多步骤任务、有依赖关系的子任务序列、并行与串行混合的执行计划。
执行规则
- 动手前列出依赖链：A → B → C，标注哪些可并行、哪些必须串行。被依赖的任务先完成并验证，才启动下游。
- 每层完成即时验证，验证未通过时阻塞下游任务，禁止带着未验证的中间产物往下游走。
- 上游返工后，下游所有受影响产物重新验证，假设全部失效重来，不沿用旧结论。
- 部分交付须明确边界："完成到第N步，第N+1步起未执行"，禁止模糊的"基本完成"。
验收标准
执行计划含依赖图。交付报告明确哪些层已完成验证、哪些层待执行。
规范八：知识资产生命周期管理
源自：dsh-archive-agent-notes
触发场景
维护项目记忆文件、素材库、技能库、模板库等长期积累的知识资产。
执行规则
- 按未来决策价值判断去留，字数和年龄只做参考，不做标准。一条 50 字的规则如果还能防止未来犯错，保留；一篇 2000 字的记录如果现状已显然，蒸馏。
- 决策记录的价值检验：这段记录还能指导未来的哪个决定？答不出来，归档。
- 新记录写入时顺手审计同主题旧记录：被完全取代的删除并迁移所有还值的理由；部分取代的保留并互相链接；删除前修复所有指向它的引用。
- 归档是冻结，不是删除。历史快照保持原样，禁止"顺手翻新"归档内容。
- 被否决的方案，仅在"这个错误想法仍有人可能再犯"时保留否决理由，否则删除。
验收标准
知识库维护动作有报告：新增几条、蒸馏几条、删除几条、每条删除的理由。
规范九：双版本一致性
源自：dsh-translate-docs
触发场景
同一内容存在两个版本：双语版本、生动版/冷酷版、详版/简版、Word版/HTML版。
执行规则
- 改动一侧，同一批次同步另一侧。禁止只改一半留待"以后同步"。
- 同步走最小更新：只改动对应的差异部分，保留另一侧已审定的表达。禁止借同步之机全文重写，重写会丢弃已确认的质量。
- 两版同等权威：任何一侧都可以作为某次更新的源头，改完向另一侧传播。
- 结构对齐：标题层级、列表结构、表格行列、代码块在两版间一一对应。内容语义逐条对应：无增漏。
- 术语两版统一映射（如同一概念在两版中的固定译法/固定说法），中途不自创变体。
验收标准
双版本交付时声明：本次改动以哪侧为源头、另一侧做了哪些对应修改、结构对齐已核对。
任务收尾 · 执行检查单
交付前逐条过一遍：
- [ ] 每条声明有证据，验证方式可复现（规范一）
- [ ] 检查集与改动面匹配，失败项已处理（规范二）
- [ ] 阻塞项与建议项分级，阻塞项有实证（规范三）
- [ ] 无为将来而建的结构，无重复表示（规范四）
- [ ] 文档定位明确，详略有度，一处一议（规范五）
- [ ] 陌生人视角通读，无过程残留（规范六）
- [ ] 依赖链执行完整，边界清晰（规范七）
- [ ] 知识资产增删有据（规范八）
- [ ] 双版本同步完成（规范九，如适用）
使用方式
- 任务开始前：通读总纲与相关规范，明确本任务适用的规范条目。
- 任务执行中：按规范约束行为（如审查类任务按规范三分级输出，长文档按规范五组织结构）。
- 任务收尾时：逐条过"执行检查单"，未通过的条目修复后再交付。
- 交付报告中声明：本次任务执行了哪些规范、裁剪了哪些规范及理由。
来源
内容改编自 DeepSeek Harness 开源仓库 .agents/skills/ 的 11 个工程 Skill：record-browser-gif、dsh-code-review、dsh-pre-push-checks、dsh-find-simplifications、dsh-doc-standards、dsh-prose-standard、dsh-trim-cot-leakage、dsh-merging-stacked-prs、dsh-archive-agent-notes、dsh-translate-docs、dsh-doc-site-sync。仓库地址：github.com/deepseek-ai/deepseek-harness
