Harness Phase 0现状审计详解：新建、扩展、运维3种分支路由

Harness Phase 0现状审计详解新建、扩展、运维3种分支路由【免费下载链接】harnessA meta-skill that designs domain-specific agent teams, defines specialized agents, and generates the skills they use.项目地址: https://gitcode.com/GitHub_Trending/harness/harnessHarness 是一个为 Claude Code 设计的元技能meta-skill你用一句自然语言描述业务领域它就能自动设计出配套的 AI 智能体团队agent team并为每个智能体生成可复用的技能skill。其中Phase 0 现状审计是整个工作流的第一步——在动手生成任何内容之前先检查项目里已有的 agents、skills 和 CLAUDE.md再据此路由到「新建」「扩展」「运维」三种分支之一。理解这一步就能明白 Harness 如何避免重复构建、控制执行成本。什么是 Phase 0 现状审计构建前先「体检」 当 Harness 技能被触发时它不会立刻开始生成智能体定义和技能文件而是先执行一次「现状审计」读取三个关键位置——项目/.claude/agents/已有智能体定义、项目/.claude/skills/已有技能、项目/CLAUDE.md下针记录与变更历史按现状分派执行模式—— 进入新建 / 扩展 / 运维三个分支之一检测漂移drift—— 将实际文件与 CLAUDE.md 中的记录交叉比对找出「文档说 A、实际是 B」的不一致汇报并确认计划—— 把审计结果总结报告给用户拿到确认后才继续执行完整定义见 SKILL.md该机制在 CHANGELOG.md 的v1.1.0版本中首次引入。分支路由如何工作3 种情况对应 3 套执行计划Phase 0 的核心价值在于用最小代价走到正确的位置。三种分支的判定条件如下分支触发条件后续动作新建agents / skills 目录不存在或为空从 Phase 1 开始完整执行 6 阶段工作流扩展已有 harness且用户要求新增智能体/技能按「Phase 选择矩阵」只跑必要阶段运维已有 harness用户要求检查/修改/同步直接进入 Phase 7-5 运维/维护工作流分支一新建 — 从零跑完全流程项目是「白纸」时走标准路径领域分析 → 团队架构设计 → 智能体定义生成 → 技能生成 → 集成编排 → 验证测试。这是最常见的上手路径可参考 docs/quickstart.md 的五步快速上手。分支二扩展 — 只跑必要的 Phase已有 harness 再「加东西」时最忌推倒重来。Phase 0 的审计结果会直接喂给后续阶段跳过所有可以跳过的步骤。扩展场景的 Phase 选择矩阵变更类型Phase 1Phase 2Phase 3Phase 4Phase 5Phase 6添加智能体跳过复用审计结果只做排布决策必需含 3-0 查重需要专用技能时含 4-0 查重修改编排器必需添加/修改技能跳过跳过跳过必需含 4-0 查重连接变更时必需架构变更跳过必需仅受影响的智能体仅受影响的技能必需必需可以看到规律无论哪种变更Phase 1领域分析都可以跳过——因为 Phase 0 已经摸清了现状而 Phase 6验证永远不能省。分支三运维 — 4 步系统化体检与修复用户说「harness 检查一下」「同步一下智能体和技能」时进入Phase 7-5 运维/维护工作流现状审计—— 文件清单 vs 编排器声明逐项比对产出不一致清单渐进式增改—— 一次只做一个变更改完立即同步更新 CLAUDE.md 变更历史—— 记录日期、变更内容、对象、原因四列变更验证—— 结构校验涉及触发词时做触发验证大规模变更架构改动、±3 个以上智能体追加执行测试漂移检测让文档与真实文件「对得上账」长期演进的项目容易出现「漂移」CLAUDE.md 里登记了 5 个智能体但.claude/agents/里实际有 6 个。Phase 0 的第 3 步就是专门抓这种账实不符把不匹配项列成清单汇报给用户。仓库里的 audit-2026-04-18.md 就是一份真实的审计产物示例它盘点了 README 徽章、plugin.json、marketplace.json、CHANGELOG、git tag 五处版本信息发现「三重不一致」问题并给出以plugin.json为权威源的修复方案。类似的体检报告还有 01_auditor_repo_audit.md。编排器上下文确认初次 / 部分重跑 / 全新执行三态Phase 0 的思想还下钻到了**编排器orchestrator**层面。编排器技能在 Phase 0「上下文确认」阶段通过检查_workspace/目录是否存在自动判断三种执行状态_workspace/状态执行模式行为不存在初次执行正常从 Phase 1 开始存在 用户要求局部修改部分重跑只重新调用受影响的那个智能体存在 用户给了新输入全新执行把旧的_workspace/改名为时间戳备份重新开始这样「继续上次任务」和「开一个新任务」就不需要用户额外说明模板逻辑在 orchestrator-template.md 中有完整定义。上手体验 Phase 0在 Claude Code 中安装后对已有项目直接说「构建 harness」即可观察 Phase 0 的审计与路由过程/plugin marketplace add revfactory/harness /plugin install harnessharness-marketplace也可以把技能目录复制为全局技能参考 README.md 的安装章节。小结为什么 Phase 0 最值得花时间理解省时间扩展场景跳过 Phase 1 乃至 Phase 2/3避免重复生成防重复漂移检测 Phase 3-0/4-0 查重杜绝「同名不同人」的智能体堆积可追溯审计结果先行汇报用户确认后才动手每一步都有据可查能续命部分重跑 / 全新执行三态判断让 harness 成为可持续演化的系统而非一次性产物一句话总结Phase 0 现状审计让 Harness 从「生成器」升级为「管家」——先看清家底再决定装修还是粉刷。更多智能体设计模式可查阅 agent-design-patterns.md团队实例见 team-examples.md。【免费下载链接】harnessA meta-skill that designs domain-specific agent teams, defines specialized agents, and generates the skills they use.项目地址: https://gitcode.com/GitHub_Trending/harness/harness创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考