QuietHarness – 面向 AI 编程代理的轻量级安全层

它是什么 – QuietHarness 是一组小型、可移植的配置文件和辅助脚本，可为 Claude Code、Codex 或 Cursor 等 AI 驱动的编程助手添加“安全防护层”。该防护层不会更改模型、调用任何外部服务或需要 API 密钥。相反，它安装一个共享的核心（约 1.6 KB），用于强制执行一些可靠性规则：

不要覆盖无关文件 – 代理必须首先检查存储库的当前状态。
在宣布成功之前先运行测试。
将高风险操作（例如凭据更改、生产部署）视为确认步骤。
记录更改的具体证据，以便以后验证结果。

同一核心可用于三个受支持的代理；安装程序会为所选工具写入相应的模板文件（例如，Claude Code/Codex 使用 AGENTS.md，Cursor 使用 quiet-harness.mdc）。

哪些人可能受益？

已经依赖 AI 编程助手并遇到过意外覆盖文件、未运行测试或未审查的破坏性操作等问题的开发者。
在 Claude Code、Codex 和 Cursor 之间切换，并希望在不重新创建配置的情况下获得一致安全检查的团队。
正在寻找先试运行工作流的人，该工作流可以回滚（自动创建带时间戳的备份）。

快速开始（隔离演示）

# 克隆并进入仓库
git clone https://github.com/runesleo/claude-code-workflow.git
cd claude-code-workflow

# 运行清单检查（健全性检查脚本）
./scripts/inventory.sh

# 为演示创建临时沙箱
DEMO=$(mktemp -d /tmp/quiet-harness-demo.XXXXXX)
./examples/first-success/setup.sh "$DEMO"

选择三个代理中的一个，并在试运行模式下运行安装程序，然后应用：

# Claude Code 示例
./scripts/install.sh --dry-run --claude-project "$DEMO"
./scripts/install.sh --apply   --claude-project "$DEMO"

安装程序将防护文件写入沙箱（AGENTS.md、CLAUDE.md 或 Cursor 规则文件），并报告它将备份的内容。

工作原理

层	内容	大小
共享核心	`templates/shared/AGENTS.md` – 通用安全规则	1,604B
Claude Code 适配器	`templates/claude/CLAUDE.md` – 指向核心的薄包装器	168B
Cursor 规则	`templates/cursor/quiet-harness.mdc` – 兼容 Markdown 的规则文件	546B

所选代理仅加载其中一个文件；其余文件保持休眠状态。核心定义了四种行为类别：

直接请求执行 – 代理仅在防护层确认请求后才继续。
可见性检查 – 代理必须明确读取任何文件、网页或历史记录，才能声称已检查过。
基于风险的验证 – 文件更改后，防护层要求模型根据风险概况验证修改。
不可逆操作的确认 – 任何可能影响凭据、生产环境或财务的操作都需要明确的用户确认步骤。

可选实验性实验室

该仓库还附带一些 实验室，展示如何扩展防护层：

Attention Inbox – 过滤掉琐碎的 waiting_for_user 消息，仅显示真正的决策点。
Chat Export – 将 Claude Code、Codex、Cursor 和 Grok Bot 的本地聊天日志规范化为单一 Markdown 格式。
Session Hooks – 小挂钩，提醒你重命名线程、添加结束清单行或去重待处理决策。
OPC Company Layer – 用于多所有者/工作者交接的实验性治理层（基本防护层不需要）。

这些实验室是可选的，位于 labs/ 下。

安装与回滚

安装程序在覆盖任何现有文件之前创建一个带时间戳的备份（.bak-ai-workflow-*）。
--dry-run 显示将写入的内容；--apply 执行更改。
可以通过恢复备份并删除新创建的文件来实现 --undo 式回滚（参见 MIGRATION-v3.md#回滚）。
用户级安装影响 ~/AGENTS.md(Claude) 或 $CODEX_HOME/AGENTS.md(Codex)。项目级安装写入你通过 --*project 传递的目标目录。

验证与测试

运行 ./scripts/verify.sh 检查：

Shell 语法和安装过程的隔离。
试运行、多目标预检、备份和回滚的正确处理。
不泄露私人路径或实时任务数据。
模板的大小限制（总计 2,318B）。
系统映射和示例任务文件的基本 SVG/JSON 完整性。

何时使用（以及何时不使用）

使用 QuietHarness 如果你已经拥有 AI 编程助手，并且需要一个轻量级、可复现的安全网，可以与你的项目一起进行版本控制。

不要将其用作完整的任务编排平台 – 它故意不提供任务数据库、调度器或团队级协调功能。这些功能属于单独的系统（README 指向作者的其他仓库以获取此类功能）。

许可证

MIT – 参见 LICENSE 文件。

TL;DR

QuietHarness 是一个 2KB 配置包，你可以将其放入 Claude Code、Codex 或 Cursor 工作区，使助手行为更可预测：备份文件、强制运行测试、要求高风险操作获得明确确认，并记录更改的具体证据。使用单个脚本安装，在隔离的沙箱中试用，并在需要时轻松回滚。

runesleo/claude-code-workflow