Log-decisions：为 AI 智能体设计的只追加决策日志

开源开发者工具 Log-decisions 近日在 Hacker News 发布，它以一个纯 Markdown 文件（DECISIONS.md）充当「只追加」决策日志，专门用于记录 AI 智能体在执行任务时所做的关键判断。与常见的项目文档不同，这一日志面向的不是人类协作记录，而是 AI agent 在缺乏明确规范时所做的「自作主张」——记录其选择了什么、由谁选择、为何选择，以便事后追溯。

核心设计：何时记、怎么记

工具的核心是一份 SKILL.md 规范，定义了三个关键概念：

• 判断标准：如果规范（spec）已经明确授权的操作，不值得记录；只有当 agent 需要自行「创造授权」时才记。
• 2×2 分类法：按「可确定性 × 可逆性」对每个决策分类，进而决定处理方式：decide（基于已有 artifact 落地）、assume（采用安全默认值，留待异步复核）、escalate（停止并询问）。其中存在一条「灾难性底线」——涉及数据丢失、破坏性迁移、不可逆开销、公开接口变更等场景，必须 escalate。
• 条目结构：每条记录为只追加的代码块，包含 Question、Options considered、Chosen、Decided-by、Justification、Outcome 等字段，并支持 Supersedes 字段用于修订。日志永远不被编辑、不被重排。

兼容性与安装

Log-decisions 以 Agent Skill 形式分发，纯 Markdown，无脚本依赖，因此可运行于任何兼容 Skills 协议的 agent 框架，包括 Claude Code、Codex、Gemini CLI、Cursor 等。安装方式包括通用方案（通过 npx skills add swe-workflow/log-decisions）和 Claude Code 插件市场安装两条路径。该插件已提交 Anthropic 官方插件目录，等待审核。

适用场景与来源

该工具并非局限于编程场景，研究、写作、运维、数据处理等任何 agent 辅助工作都可能产生「事后会被追问」的判断，因此均可使用同一套记录机制。它从上游项目 swe-workflow（≤ v2.0.2）中提取并独立发布，后者是一套覆盖 idea → PRD → issues → ship 的工作流套件，会在各阶段调用 Log-decisions 来串联决策。

项目以 MIT 协议开源，完整的讨论可在 Hacker News 原帖中查看。