Skip to content

Repository files navigation

QuietHarness:我的 AI 工作系统

License: MIT

中文 · English

Claude Code Workflow 演进而来的当前版本:Claude Code、Codex、Cursor 三端共用一个极小 Core,外接我真实使用的业务线、任务事实源、后台报告和开源工具分支。

这不是 AI 帮我总结出来的一套“理想工作流”。它就是我现在每天在用的系统,只把账号、路径、实时任务和生产控制面拿掉了。

为什么现在重做

最早开源这套 workflow 时,模型远没有现在稳定。为了不失忆、不乱跑、不漏验证,我不断往里面加规则、Hook、Skill、Memory、模型路由、Morning、Today 和 Session End。

那些设计不是凭空来的,当时确实解决了问题。但仓库发布以后,我继续用 Claude Code、Codex、Cursor 和不同模型迭代自己的系统,公开仓库却很久没有同步。

最近重新使用最高推理档的模型后,我的实际感受是:模型本身已经强到足以承担更多路径判断。旧系统里一部分原本有用的保护,开始变成重复规划、误触流程和维护负担。

所以 v3 不是继续加功能,而是把我目前真实使用的结构重新公开:

  • 三端常驻配置从重规则系统收敛为一个小 Core;
  • 项目事实留在项目里,需要时才读;
  • 业务与任务连续性放在明确的事实源和写回协议后面;
  • 日报与监控继续后台运行,但不再成为每次开工的仪式;
  • 已经长成独立工具的业务分支,继续由各自仓库维护。

我把这个版本叫 QuietHarness:Harness 仍然在,但没有相关任务时,它应该安静。

仓库地址和 Git 历史继续保留 claude-code-workflow。QuietHarness 是同一套系统的 v3,不是另起炉灶。

一张图看懂

QuietHarness system map

Leo 的真实工作
    │
    ├── Claude Code / Codex / Cursor
    │       └── QuietHarness Core
    │             直接执行 · 真实证据 · 按风险验证 · 不可逆动作确认
    │
    ├── 长期业务线
    │       Personal Ops · Strategy · Data · Portfolio · Content
    │       Products · Health · Daily Rhythm · Research
    │
    ├── 任务与连续性
    │       per-task SSOT · owner/worker · readout/writeback
    │       freshness · claim · writer lock · artifact/receipt
    │
    └── 已开源的业务分支
            Polymarket · 内容读取 · 视频制作 · 健康 · 系统审计

复杂性没有消失,只是离开了每次请求的热路径。

这套系统现在怎么工作

1. 三端入口:同一个 Core,不复制三套人格

Claude Code、Codex 和 Cursor 共用一份 1,604 字节核心。Codex 直接读取 shared AGENTS.md,Claude Code 和 Cursor 只增加各自的薄适配层。

客户端 常驻模板 字节数
Shared Core templates/shared/AGENTS.md 1,604 B
Claude Code adapter templates/claude/CLAUDE.md 168 B
Cursor project rule templates/cursor/quiet-harness.mdc 520 B

三份模板合计 2,292 字节,但任何一个客户端都不会同时加载三份。这里比较的是文件字节,不冒充精确 token、速度或模型质量数据。

Core 只保留四类东西:

  • 直接推进当前请求;
  • 没看过的文件、网页和历史不装作看过;
  • 文件或代码改动后按风险验证;
  • 资金、账号、公开发布、生产环境和破坏性动作先确认。

2. 九条业务线:对话可以换,业务归属不变

我的长期工作不是一个无限增长的聊天窗口,而是九条稳定业务线:

入口 业务线 负责什么
⌘0 Personal Ops 系统、Agent 与风险边界
⌘1 Strategy Lab 策略、验证与扩张
⌘2 Data Platform 数据管线、索引与画像
⌘3 Portfolio 配置、风险与执行决策
⌘4 Content Studio X、文章与 SEO
⌘5 Products & Growth 构建、变现与分发
⌘6 Health Ops 记录、节律与健康研究
⌘8 Daily Rhythm 输入登记、路由与日常审计
⌘9 Research Desk 调研、机会与知识沉淀

这些名字不是要求别人照抄,而是公开我的真实拓扑。每条线对应一个稳定工作区和 Owner;换模型、换对话甚至换客户端,都不会改变事实应该写回哪里。

启动时只读当前业务线的有限状态。明确点名任务时,才读取那一个任务。完整结构见 系统架构

3. 任务系统:事实比聊天记忆可靠

任务不是一个让所有模型共同改写的大数组,而是每个任务一份权威记录:

  • status 是唯一生命周期事实;
  • owner_thread 表示稳定业务归属;
  • primary_worker / claimed_by 只表示当前执行者;
  • next_actionartifactsupdated_at 必须明确;
  • 新事实与旧叙事冲突时,用 state_revision 明确覆盖;
  • Worker 的一句“完成了”不算持久状态,必须有 artifact、validation 和 Owner writeback。

仓库提供一份从我现行结构脱敏而来的 任务示例完整说明。它不是虚构的通用 schema,但也不会暴露我的实时任务库。

4. 单 Writer:并行调查,串行修改同一事实

Claude、Codex、Cursor 可以并行研究和审查,但同一个仓库或同一个任务事实面默认只有一个 Writer。

一次仓库写入会记录:

repo / worktree / writer / allowed paths / validation / next gate

释放写锁时必须留下:

artifact / validation / writeback / rollback / outcome / next gate

这来自真实的跨模型双写事故,不是为了让流程看起来完整。脱敏示例见 writer-lock.example.json

5. 后台报告:继续生成,不抢前台注意力

日报、同步和监控可以继续独立运行。成功时安静落盘,需要时读取;缺失、过期或失败时再提醒。

交互 Agent 不需要为了回答一个无关问题,先重跑 Morning、扫描全部任务或生成一次 Dashboard。详见 日报可以继续,但不必成为仪式

这张地图上的开源分支

QuietHarness 是主干。我的一些真实业务能力已经长成独立仓库:

系统分支 公开仓库 在整套系统里的位置
预测市场 polymarket-toolkit 地址画像、CLI 与 AI Skills
资产调研 asset-dd-and-opportunity-evaluation 结构化 DD 与机会判断
内容摄入 x-reader 多平台链接读取与统一内容入口
Telegram 摄入 tg-reader-mcp TG 频道、群组与联系人读取
长音视频 long-media-cli 长视频、播客与 X Space 转录
视频制作 claude-video-kit 脚本、审稿、配音与 Remotion 竖屏视频
健康资料 ai-health-vault 私有健康记录与 AI/Obsidian 工作流
系统体检 claude-skill-audit Skill 使用率、冲突与死亡配置审计

它们不是为了凑一个“AI OS”目录,而是先在真实业务里使用,再把有独立价值的分支拆出去。未来新的公开仓库也会继续挂回这张地图。

你可以怎么用

不需要复制我的全部系统。

只要最小 Core

git clone https://github.com/runesleo/claude-code-workflow.git
cd claude-code-workflow

./scripts/inventory.sh
./scripts/install.sh --dry-run --claude --codex
./scripts/install.sh --apply --claude --codex

给 Cursor 项目安装:

./scripts/install.sh --dry-run --cursor-project /path/to/project
./scripts/install.sh --apply --cursor-project /path/to/project

安装器默认只预览;明确 --apply 才写入。覆盖前备份,不联网、不登录账号、不修改 scheduler。

借用我的系统结构

Leo System 示例 开始:

  1. 保留或重命名九条业务线;
  2. 给每条线指定稳定 Owner 和工作区;
  3. 用 per-task 记录保存状态、下一步与证据;
  4. 接入自己的 readout/writeback;
  5. 只有出现真实冲突时,再加入 claim 或 writer lock。

从 v2 迁移

先运行只读盘点,再按 MIGRATION-v3.md 可逆停用旧规则、Skill、Hook 和固定日流程。不要直接删除已有配置。

仓库结构

templates/                      # 当前三端小 Core
docs/                           # 我的系统架构、任务与日报边界
examples/leo-system/            # 脱敏的真实结构示例
scripts/                        # 盘点、安装、验证
tests/                          # 隔离 HOME 冒烟测试
media/launch-v3/                # 系统地图与发布素材
MIGRATION-v3.md                 # v2 → v3 与回滚

已验证

./scripts/verify.sh 会检查:

  • Shell 语法与隔离安装;
  • dry-run、多目标预检、备份与回滚;
  • 文件和目录符号链接盘点;
  • 自定义 CODEX_HOME
  • 中英文入口、系统文档与示例;
  • 私人路径和实时任务模式泄漏;
  • 常驻模板体积上限;
  • SVG/JSON 基础完整性与 git diff --check

当前验证基线:三端模板合计 2,292 字节,安装器不需要 API key,也不执行网络、账号、scheduler 或生产操作。

当前边界

  • 公开的是我的系统结构,不是我的实时任务、账号、仓位、健康记录或客户数据。
  • 仓库不会替你创建任务数据库、九条置顶对话或后台 scheduler。
  • task-readwriteback 和 writer lock 示例需要接到你自己的存储与客户端。
  • Cursor 全局 User Rules 仍需在应用设置中管理;安装器只写项目规则。
  • Windows PowerShell 安装器尚未提供。

接下来

我不会再为了显得完整而给它堆功能。后续更新只来自两类证据:

  1. 我在真实工作里反复验证有效;
  2. 使用者在 fork、issue 或实际接入中证明值得抽出来。

关于作者

Leo(@runes_leo)— AI × Crypto 独立构建者,用 Claude Code、Codex 和 Cursor 经营交易、数据、内容与开源产品。

leolabs.me · GitHub · X

License

MIT — 见 LICENSE

About

QuietHarness:Claude Code、Codex、Cursor 共用的轻量 AI 工作系统

Resources

Code of conduct

Security policy

Stars

Watchers

Forks

Releases

Packages

Contributors

Languages