一、用途 该技能要求在单次交付结束前、提交之前,写出一份针对自身声明(指令、提示词、技能或工具脚本)的有界修改提案。提案必须基于本次派发的具体证据,并明确列出删除项;只增不减的提案会被拒绝。
二、主要能力 按顺序回答八个问题:成本、二次阅读、冗余规则、缺失工具、噪声、真相源、险兆、指标。每个答案必须指向命令输出、CI 轮次、评审发现或文件行号等可验证锚点,否则只算观察而非提案。 提案格式为一个 Markdown 文件加一个围栏 JSON 块,文件放在 dispatch 专属路径 artifacts/reflections/<dispatch-id>.md。每个提案条目包含六个字段:target、change、deletion、evidence、expected_effect、risk,其中 deletion 为必填。 规则约束:禁止净增长,需测量前后字节数;优先选择最便宜的修复层;一次派发的证据只证明一次派发,不得泛化为永久禁令;提案者不得自行应用变更。
三、使用方式 在交付过程中、提交前运行,趁本轮仍持有租约时写入提案,随后由提交命令携带。若所有者在提交前恢复该派发,则按相同格式回答。周期性评审可由只读的调度事件或只读 Agent 执行,提案写入其自身的事件产物。 所有者通过 ha agent inspect <agent-id> 读取当前声明和预期版本,再通过 ha agent install --source <declaration> --expected-version <n> 应用已接受的条目。版本过期会写入失败,避免覆盖并发修改。
四、适用场景 适用于需要基于一次具体交付的经验,对自身指令、提示词、技能或工具脚本进行有证据支撑、有删除约束的迭代改进。也适用于在派发进行中回答所有者追问,以及周期性只读评审。
五、限制 提案者不能自行编辑规范声明、技能文件或其他 Agent 的声明。提案必须在提交前完成,提交后无法再生成。每个派发只产出一个提案,不共享笔记本,不形成常设待办。若某项变更无法指向具体证据,须标记为未验证。