用途:当文档会被当作事实阅读时(决策记录、README、验收报告、运行手册、面向用户的变更日志、审计发现、已核实声明),使用本技能;草稿、自言自语、聊天回答、提交信息、代码注释不适用。
主要能力:提供十条认识论准则作为标准与导航。核心要点包括:声明须携带可核查地址(file:line、带输出的命令、测试名),像 sha、行号、路径、标志、测试名的 token 在解析前不算证据;数字须计算而非转述,打印匹配项并分类,避免管道命令退出状态干扰;每个事实只有一个归属地,其他处只链接不复述;引用基于文档被阅读的位置解析;无人观察由绿变红不算证据;模型须先复现缺陷再修复,过小的模型需列出省略项及数字;检查只证明其范围;沉默不等于通过;估计不得当作测量宣布,未检查的须与已检查的并列打印;测得的零与未测量的量不得打印相同;文档随使其成真的变更一同发布,更正只追加不覆盖。
使用方式:操作层内容见 learned.md,明确触发条件下的动作、检查与退出标准。可依次参考 documentation.md(准则全文、文档清单)、Registers and ids 与 templates/decisions.md(决策记录)、The Doc Loop 与传播矩阵(变更关联文档)、Single source of truth(事实归属)、gates.md(构建可信检查、假成功)、hooks.md(接入代理工具)、setup.md(审计既有文档,七遍由廉到贵,产出修复计划)、retrospective.md(经验带至下次运行,先盖章后裁剪至十条上限,每条经验注明提交)、templates/docgate.sh(向宿主项目植入门禁,无输入时休眠为绿)、tdd.md(测试对象为代理时,地址是 trace id 与所运行的断言)。完整变更流程需另装 task-pipeline 技能。
限制:本技能是标准而非变更进入仓库的流程。证据服务于操作者意图;操作者可断言尚未成真之事(如落地页、路线图、宣传),但不得让测量说出它没说的事,不得在被告知一次后仍知情发布无依据声明,不得将估计呈现为测量。拒绝短语为“без доков”。参考文件与模板为生成副本,应编辑源文件而非副本,详见 GENERATED.md。具体收费、平台支持等信息暂未提供。