Claude Code Workflow

QuietHarness：让你的 AI 编程 Agent 更可靠

中文 · English
给你已经在使用的 AI 编程 Agent 装上一层极小、可回滚的工作边界：先看现状、保留无关改动、按风险验证、对不可逆动作先确认。

只用 Claude Code、Codex 或 Cursor 中的一个就能获得同一组核心可靠性边界。 多端兼容是以后更换工具时可以带走这些边界，不是安装门槛。

QuietHarness 不会给每个请求套一层仪式，也不是要求你复制我的私人系统。它把我长期使用后仍值得保留的行为压缩成 1,604 字节共享 Core，并提供 dry-run、备份、隔离测试和可逆安装。

适合谁

适合正在用任意一种 AI 编程 Agent 维护真实项目，并遇到过这些问题的人：

- Agent 没检查现有改动就覆盖文件；
- 没运行测试，却把任务说成完成；
- 一个小修改被扩成不必要的重构和流程；
- 删除、发布、生产变更或凭证操作没有在正确位置停下来确认；
- 更换 Agent 后，又要从头重写同一套基本边界。

如果你需要完整任务数据库、后台自动化或团队编排平台，QuietHarness 本身并不提供这些能力；后文的 Leo System 只是可选参考。

如果你关心多个长期 Owner / Worker 如何共享 canonical state、做 semantic handoff、拒绝假完成并在换 worker 后继续同一任务，可以看实验性的 OPC Company Layer。它是同一仓库里的治理实验层，不是 QuietHarness 的安装前提。

如果你的 Agent 已经能持续工作，但经常因为错误的 waiting_for_user、常规完成或重复状态打断你，可以看实验性的 Attention Inbox Lab。它只把真正的人工决策和有意义的风险送到注意力入口；任务事实、调度和执行仍留在现有系统里，不另造一套队列或控制面。

如果你同时用几家 AI，想让它们都能翻到之前在别家聊过什么，可以看实验性的 Chat Export Lab。它把 Claude Code、Codex、Cursor、Grok Bot 的本地聊天记录导成同一种 Markdown，只读、增量、导出前去掉常见凭证；聊天记录只当线索，事实仍以文件为准。

如果你的 Claude Code 会话越开越多，标题对不上内容、分不清哪个能关、只有你能拍板的事没人提，可以看实验性的 Session Hooks Lab。三个独立钩子：主线换了提醒改标题、每次收尾写一行归档检查、把「需要我决定」清单的未勾选项带指纹去重地放到模型眼前；只加提示，不替你改标题、归档或关事项。

先在一个隔离项目试用

下面三个选项只选一个。先 dry-run 查看精确目标，再执行 --apply；试用规则只写入 $demo_dir，不会改动你的用户级 Claude/Codex 配置。

Claude Code

写入 $demo_dir/AGENTS.md 与 $demo_dir/CLAUDE.md。

Codex

只写入 $demo_dir/AGENTS.md。

Cursor

只写入 $demo_dir/.cursor/rules/quiet-harness.mdc。

安装器默认只预览；明确 --apply 才写入。它不联网、不登录账号、不修改 scheduler。

观察第一次成功

在 $demo_dir 打开你选择的 Agent，只发送：

成功时，它应当在没有被题目逐条提醒的情况下，发现并保留一条无关用户改动、只修折扣计算、运行现有测试，并在最终回复中给出真实验证证据。

这个练习是 onboarding 行为检查，不是“QuietHarness 必然提升模型”的因果实验。设计目标是十分钟内完成；目前自动化只验证 fixture 可重复，真实非作者计时仍是下一道产品门。

查看完整首次成功步骤与验收标准 →

完成或卡住后，请用 2 分钟提交一份 公开使用回执。它只用来测量安装结果、首次成功耗时、支持摩擦和 7 天复用；7 天未到时，之后直接编辑同一条 issue。不要提交私有代码、仓库名、绝对路径、凭证或账号信息。

通过后再安装到日常环境（可选）

Claude…