closedtab

# 关闭标签：人类-智能体团队共享记录 您与AI智能体合作进展迅速，交付成果很多，但是决策背后的原因几乎立刻就会消失。您清楚自己想要什么以及如何实现；智能体却选择了不同的路径；一周后，在调试过程中，您试图重建实际发生的情况。closedtab记录了这些信息：您要求什么，智能体做了什么，智能体理解指令的内容是什么。 它可以帮助您在智能体之间传递任务，保持多智能体运行的可读性，跟踪决策过程和出现的错误及修复方法，并在此过程中不断改进交接流程。它的作用与智能体合作的顺畅程度一样重要，也与记录来源有关。 当您保持积极参与时，它的效果最佳：您作为产品负责人，智能体作为工程师或项目经理。按功能逐一运行，在您负责的工作中，记录会累积成项目实际构建的历史。 ``` npm install -g closedtab ``` ## 智能体行动记录 ``` closedtab new ``` 它会创建一个带有日期的**智能体行动记录**，供您填写：一个六部分的记录，涵盖一次智能体运行。 | 部分 | 记录内容 | |---|---| | **意图** | 指令，成功定义，智能体权限，超出范围的内容 | | **行动** | 智能体做了什么（从日志），产生了什么结果，哪里出现偏差，是否在权限范围内 | | **判断** | 智能体独立做出的决定，人类本应看到的内容，智能体本应升级的内容，谁负责 | | **偏差** | 差距及其根本原因，良好的偏差，信心不足的偏差 | | **后果** | 结果，损害或成本或风险，受影响的人，预期失败次数 | | **变更** | 下次运行前的更改内容，保持不变的内容，属于人类处理的内容，信号是否有效 | 此存储库中的`record-template.md`是相同的表单，您可以手动填写：按顺序完成六个部分，不需要AI协助，并保存记录。 ## 评估记录 ``` closedtab check ./docs/aar-fall-portal.md ``` 评估记录是否捕获了值得保留的信息：意图、推理、决策者、执行情况、偏差和风险。 ## 与跟踪记录对比 ``` closedtab reconcile --testimony ./aar.md --trace ./trace.jsonl --out ./diff.json ``` 将记录与智能体实际操作的机器跟踪记录进行对比。意图和行动作为输入；偏差作为输出：记录与跟踪记录一致的地方，记录声称的内容超过跟踪记录显示的内容，跟踪记录显示的内容记录中省略的内容，以及直接矛盾的内容。 ## 任务文档 `closedtab new --type bugfix`（也支持`feature`、`adr`、`handoff`）为相同的人类-智能体团队编写更轻量的任务文档，每个文档都有自己的前缀（`aar-*`、`adr-*`、`handoff-*`）。智能体行动记录是默认且重点关注的文档。 ## 让智能体审查自己的运行（MCP） ```json { "mcpServers": { "closedtab": { "command": "closedtab-mcp" } } } ``` 这为智能体提供了四个工具：`list_templates`、`new_doc`、`check`和`reconcile`。智能体完成一个段后，写入记录，检查并保存记录与变更。 ## 库 ```javascript import { renderAar, TEMPLATES, checkDoc, reconcileText } from "closedtab"; ``` ## 发布和开发 ``` npm publish # 运行 prepublishOnly: clean, build, test, ships dist/ npm test # vitest npm run build # tsc 到 dist/ ``` 本地且确定性：它只需要Node。记录格式来自智能体行动后评估技能（github.com/quarterback/AAR），在此使用MIT许可证。更多思考内容见`WHY.md`。