人类可读成果报告
说明用户现在能做什么、哪些需求已验证、哪些仍未解决。可与 Datarim 配合使用,也可作为独立技能使用。
一份可独立理解的报告
Human Outcome Reporting 0.3.3 先说明产品结果,再说明内部活动。进度更新指出有意义的变化;最终报告将原始请求与交付成果及证据关联起来。缺失的检查、过期的结果,以及针对其他版本或环境的检查仍会保持可见。
可读的文字与数字
0.2.3 版在日期、计数、角色编号和版本标签中保留正常空格。建议性文字检查会标记代码、路径和字面标识符之外的明显拼接。它们绝不会改写规范名称,也不能证明每位读者都能理解报告。
它改变了什么
- 区分已执行的工作、已验证的标准、交付和人工验收。
- 在出现不熟悉的项目术语时加以解释。
- 针对功能、缺陷修复、研究、运维、发布或普通回答使用相应的配置档。
- 保持解释完整;不存在会隐藏未满足需求的硬性字数上限。
- 保持确切的安装提示、机器格式、权限和安全控制不变。
安装与使用
Datarim 命令从项目运行时加载共享技能。它也可以独立安装,用于 Claude Code、Codex、Cursor、Google Antigravity 和 MiniMax Code(--agents antigravity,claude,codex,cursor,minimax)。参见报告安装指南。安装该技能并不会安装 Datarim 工作流。
独立的语言偏好
回复语言和生成产物语言都默认为英语,且可以不同。共享辅助程序从 $XDG_CONFIG_HOME/datarim/config.yaml 或 ~/.config/datarim/config.yaml 读取用户偏好,并在选中时读取共享和私有项目默认值。更改无需重新安装。原生规则保留权威;保留引文、代码和机器值。配置语言。
固定的渲染器标签使用语言目录。目录覆盖不可用时,会以英语回退形式披露;提供的文字不会被自动翻译。需要在新会话中观察,才能确定特定客户端中的行为。
首条消息之前
独立安装会为受支持的 Codex 和 Claude Code 客户端注册同步的 SessionStart 回调。它们会在首条进度消息之前解析当前用户和项目偏好;Cursor 保留其原生启动集成。通过 /hooks 查看新的确切 Codex 钩子定义。安装程序不会授予信任或更改权限,并会保留现有的外部钩子和安全钩子。已安装文件、原生激活和观察到的模型行为是彼此独立的检查。
当前项目和提示偏好
最近的 datarim/config.local.yaml 会选择其自身项目,包括位于祖先框架之下的情况。格式错误的设置或损坏的私有标记属于错误,而不是回退到祖先。Claude 在提交提示之前以及工具完成或失败之后,使用自有的同步 UserPromptSubmit、PostToolUse 和 PostToolUseFailure 提醒。它们添加语言上下文,但不改变输出、决策或权限。工具执行后的 JSON 输入上限为 1 MiB;启动和提示输入保留 64 KiB。无效或过大的元数据会披露未解析的偏好。工具失败回调不包括权限拒绝、执行前验证失败和取消。此安装程序中的 Codex 没有每轮回调;当较早的上下文仍然存在时,请开始新对话。生成的回调执行当前辅助程序源码,而不是预先存在的辅助程序字节码缓存,保留外部缓存,且不写入辅助程序字节码。文件检查不会测量运行时、启动、每轮和工具执行后的激活情况。原生信任和实际观察仍然彼此独立;没有任何规则能保证未来每一次模型回答。
回复中的注释
在回复中编写的可复用注释或文档摘录属于产物:其生成的文字和示例使用产物语言。周围的解释、首句、进度以及工具前后的叙述使用回复语言。明确的文档语言请求只改变该产物;回复语言请求只改变回复文字。不要添加未经请求的翻译示例。明确的双语或翻译请求优先;逐字输入、代码和机器标识符保持不变。
再次解释
/dr-explain 会重述现有成果或解释术语,而不更改文件、运行测试、部署或接受结果。
各部分如何衔接
共享技能决定报告的含义。Human Summary 为 QA、合规和归档保留四个熟悉的标题。命令、代理、模板、需求图和报告记录都引用同一契约。阅读带版本的源码。
限制
自动验证器检查报告结构和证据绑定。它们无法保证每位读者都能理解解释,而且发现已安装的技能并不能证明特定客户端会话已加载它。