企业官网建设流程全解析

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/harness

Harness 是一个为 Claude Code 设计的元技能（meta-skill）：你用一句自然语言描述业务领域，它就能自动设计出配套的 AI 智能体团队（agent team）并为每个智能体生成可复用的技能（skill）。其中，Phase 0 现状审计是整个工作流的第一步——在动手生成任何内容之前，先检查项目里已有的 agents、skills 和 CLAUDE.md，再据此路由到「新建」「扩展」「运维」三种分支之一。理解这一步，就能明白 Harness 如何避免重复构建、控制执行成本。

什么是 Phase 0 现状审计：构建前先「体检」 🩺

当 Harness 技能被触发时，它不会立刻开始生成智能体定义和技能文件，而是先执行一次「现状审计」：

1. 读取三个关键位置——项目/.claude/agents/（已有智能体定义）、项目/.claude/skills/（已有技能）、项目/CLAUDE.md（下针记录与变更历史）
2. 按现状分派执行模式—— 进入新建 / 扩展 / 运维三个分支之一
3. 检测漂移（drift）—— 将实际文件与 CLAUDE.md 中的记录交叉比对，找出「文档说 A、实际是 B」的不一致
4. 汇报并确认计划—— 把审计结果总结报告给用户，拿到确认后才继续执行

完整定义见 SKILL.md，该机制在 CHANGELOG.md 的v1.1.0版本中首次引入。

分支路由如何工作：3 种情况对应 3 套执行计划

Phase 0 的核心价值在于用最小代价走到正确的位置。三种分支的判定条件如下：

分支一：新建 — 从零跑完全流程

项目是「白纸」时，走标准路径：领域分析 → 团队架构设计 → 智能体定义生成 → 技能生成 → 集成编排 → 验证测试。这是最常见的上手路径，可参考 docs/quickstart.md 的五步快速上手。

分支二：扩展 — 只跑必要的 Phase

已有 harness 再「加东西」时，最忌推倒重来。Phase 0 的审计结果会直接喂给后续阶段，跳过所有可以跳过的步骤。

扩展场景的 Phase 选择矩阵：

可以看到规律：无论哪种变更，Phase 1（领域分析）都可以跳过——因为 Phase 0 已经摸清了现状；而 Phase 6（验证）永远不能省。

分支三：运维 — 4 步系统化体检与修复

用户说「harness 检查一下」「同步一下智能体和技能」时，进入Phase 7-5 运维/维护工作流：

1. 现状审计—— 文件清单 vs 编排器声明逐项比对，产出不一致清单
2. 渐进式增改—— 一次只做一个变更，改完立即同步
3. 更新 CLAUDE.md 变更历史—— 记录日期、变更内容、对象、原因四列
4. 变更验证—— 结构校验；涉及触发词时做触发验证；大规模变更（架构改动、±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/目录是否存在，自动判断三种执行状态：

这样「继续上次任务」和「开一个新任务」就不需要用户额外说明，模板逻辑在 orchestrator-template.md 中有完整定义。

上手体验 Phase 0

在 Claude Code 中安装后，对已有项目直接说「构建 harness」即可观察 Phase 0 的审计与路由过程：

/plugin marketplace add revfactory/harness /plugin install harness@harness-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