2026年7月17日

合规 Skill——归档前的最后一道关卡

Datarim 的合规 skill 如何识别任务类型、应用匹配的验证清单,并在归档步骤之前将发现的问题分流到内联修复或待办事项。

任务末尾的质量检查往往会发现同样的问题:一个变得过长的方法、一个没有编写的测试、一个本应作为环境变量却硬编码在配置文件中的值。compliance skill 在 /dr-qa 之后、/dr-archive 之前运行,以系统化而非凭记忆的方式捕获这些问题。它会根据任务实际产出的内容进行调整。

它的作用

第一步是任务类型识别。该 skill 读取任务文件和活动上下文,以确定产出主要是代码、文档、研究、法律文本、内容还是基础设施配置。每种类型都有自己的清单。代码任务运行七个步骤:对照 PRD 需求进行变更集对齐、代码简化、死代码移除、测试覆盖率、运行 linter、执行测试以及 CI/CD 影响分析。内容任务运行四个步骤:事实准确性、AI 模式移除、平台要求和编辑标准。

当发现问题时,该 skill 会应用延迟处理启发式规则。小修复——一个文件、最多 100 行生产代码加测试、无 API 契约变更、可通过单次提交回滚来撤销——可以在当前任务内联交付。较大的修复则作为跟踪项进入待办事项。默认做法是记录并移交;仅当四个条件同时满足时才适用内联路径。

输出是一份保存到 datarim/reports/ 的合规报告。结论为以下三种之一:COMPLIANT、COMPLIANT_WITH_NOTES 或 NON-COMPLIANT。每次重新运行该 skill 都会生成一个新的带版本号的报告文件,而不是覆盖之前的文件。

一个具体示例

某任务实现了一个新的 API 端点。合规检查运行软件清单。第 4 步发现某个验收标准声明了数值覆盖率阈值,但在 QA 期间没有进行测量。该 skill 安装覆盖率工具、运行它、记录实际百分比——例如 91.5%,对照 80% 的阈值——并将该步骤标记为 PASS。对于带阈值的标准,不接受“推定满足”的发现;必须测量出具体数字。

何时加载

该 skill 由 /dr-compliance 调用,它在标准流水线中于 /dr-qa 之后运行。当操作员需要在不运行完整 QA 阶段的情况下进行独立验证时,也可以直接调用它。合规报告会成为归档包的一部分,提供一份关于已验证内容和已延迟内容的永久记录。

阅读什么是 Datarim以了解完整流水线全貌,或查看/dr-compliance 命令参考了解调用契约。