Claude Code Harness Night Watch 组件解析AI 开发夜间巡检的实现思路【免费下载链接】claude-code-harnessClaude Code Dedicated Development Harness - Achieving High-Quality Development Through an Autonomous Plan→Work→Review Cycle项目地址: https://gitcode.com/GitHub_Trending/cl/claude-code-harnessClaude Code Harness是围绕 Claude Code 构建的自主开发框架通过 Plan → Work → Review 循环提升交付质量。它的Night Watch夜间巡检组件则扮演守夜人角色在你下线后自动巡视项目找出滞留任务、未决决策和悬空的事件循环第二天上班时给你一份结构化的巡检报告。本文带你看懂它的实现思路与接入方式。为什么 AI 开发流程需要夜间巡检Harness 的开发循环虽然强调每一步都有证据但长任务、决策项、跨会话事件都可能悬在半空Plans.md里的任务三天没人碰状态还是 WIP⚖️ 决策文档里一条Status: open挂了一个星期 Bridge 事件邮箱里发出去的advisor-request始终没有对应的advisor-response。这些问题靠人肉记忆很容易漏掉。Night Watch 的思路是让巡检这件事定时化、规则化、可验证化——每天凌晨跑一次输出一份符合 JSON Schema 的报告把忘了什么变成看见了什么。巡检三件事Night Watch 的核心逻辑Night Watch 的巡检逻辑集中在 go/internal/nightwatch/ 目录三个核心函数对应三类检查项见 stale.go巡检项检查对象默认阈值说明 悬空循环Bridge 事件邮箱SQLite1 小时有请求事件但没有配对的响应事件说明某个 Agent 协作链路断了⏳ 滞留任务项目根目录的Plans.md72 小时文件超过阈值没更新且其中仍存在 WIP / TODO / Blocked 任务❓ 未决决策.claude/memory/decisions.md168 小时标记为 open / pending / 未决 等状态的决策项支持中日文状态词几个值得学习的设计细节事件配对用 key 而不是 IDloopKey用task_id trigger_hash作为循环标识请求*-request、worker-report与响应*-response、*-result、review-result按 key 配对配对不上的才计入悬空循环stale.go。健康检查先行每次巡检先跑Check()health.go输出三态结果——not-configured未启用、daemon-unreachableBridge socket 连不上、corrupted配置/邮箱损坏让报告本身也能自证数据可信。阈值可配置stale_task_hours与open_decision_hours读取自 templates/night-watch-config.yaml文件不存在时回落到代码默认值配置出错不会导致巡检崩溃。报告格式Schema 校验保证输出可信巡检结果被组装成night-watch-report.v1结构schema.go包含schema_version、generated_at、health、unresolved_loops、stale_tasks、open_decisions六个字段。关键在于报告生成后会先通过 JSON Schema 自校验再输出Schema 定义在 templates/schemas/night-watch-report.v1.json。对下游消费告警、汇总、归档来说格式永远稳定——这是让 AI 产出可信的典型做法。如何接入默认关闭显式开启Night Watch 遵循 Harness 一贯的opt-in显式开启原则默认关闭接入分三步开启开关设置环境变量NIGHT_WATCH_ENABLEDtrue。官方还提供了安装脚本 scripts/night-watch-install.sh它会安全地写入 settings 文件并拒绝误改真实的~/.claude/settings.json。手动试跑CLI 入口在 go/cmd/harness/night_watch.go支持harness night-watch report --dry-run干跑模式只输出报告、不产生任何副作用——适合第一次接入时验证。挂上 cron按 templates/night-watch-cron.template 中的模板在确认开启后再取消注释例如每天凌晨 2 点执行巡检脚本并追加日志。对应的自动化测试见 tests/test-night-watch-install.sh 与 tests/test-night-watch-report.sh可参考它们理解各状态的断言方式。小结Night Watch 展示了 AI 开发框架中守夜人模式的完整思路把记忆负担从人转移到规则——用三态健康检查判断数据源是否可信用阈值 关键词规则识别滞留任务与未决决策用事件 key 配对发现断掉的协作循环用JSON Schema 自校验保证报告格式稳定。如果你也在为 Claude Code 搭建长时运行能力这套轻量巡检 结构化报告的方案是很好的起点。更多组件设计可参考 docs/ARCHITECTURE.md。【免费下载链接】claude-code-harnessClaude Code Dedicated Development Harness - Achieving High-Quality Development Through an Autonomous Plan→Work→Review Cycle项目地址: https://gitcode.com/GitHub_Trending/cl/claude-code-harness创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考