企业官网建设流程全解析

Harness的CLAUDE.md指针注册详解：为什么只需写2样东西

【免费下载链接】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 的"团队架构工厂"元技能——一句话指令即可生成领域专属的 agent 团队（.claude/agents/）和他们使用的技能（.claude/skills/）。而在它整个 6 阶段工作流中，最精妙的一步是CLAUDE.md 指针注册：项目根目录的 CLAUDE.md 里只需要写 2 样东西——触发规则和变更历史，其余全部交给编排器技能处理。

先搞懂 Harness：一句话生成 Agent 团队

Harness 位于 Claude Code 生态的 L3"元工厂"层——它自己不干活，而是"生产"干活的团队。安装后只需说"build a harness for this project"，它就会自动完成：

1. 领域分析— 搞清楚项目要做什么类型的工作
2. 团队架构设计— 从 6 种预定义架构模式（管道、扇出/扇入、专家池、生成-验证、监督者、层级委托）中选型
3. Agent 定义生成— 每位成员一个.claude/agents/下的.md文件
4. 技能生成— 每个 Agent 的"怎么做"手册放入.claude/skills/
5. 集成与编排— 用编排器技能定义"谁和谁、按什么顺序协作"
6. 验证与测试— 触发词验证 + 干跑测试

📖 5 分钟从安装到跑通示例任务的教程见 docs/quickstart.md。

为什么要在 CLAUDE.md 注册指针

关键在于理解一个机制：CLAUDE.md 会在 Claude Code 每个新会话启动时自动加载。它是 AI 每次会话第一眼就能看到的全局记忆。

所以只要在 CLAUDE.md 里放一块"指路牌"，无论以后开多少个新会话，Claude 都知道："这个项目有 harness，遇到这类任务要调用编排器技能。"官方原文（skills/harness/SKILL.md）：

CLAUDE.md是 새 세션마다 로딩되므로，하네스 존재와 트리거 규칙만 기록하면 오케스트레이터 스킬이 나머지를 처리한다。 （CLAUDE.md 每个新会话都会加载，因此只需记录 harness 的存在和触发规则，剩下的由编排器技能处理。）

一句话：CLAUDE.md 是路标，细节在技能里。

要写的 2 样东西：触发规则 + 变更历史

按照 SKILL.md 模板，整个 CLAUDE.md 指针块极简，核心就是这 2 样：

① 触发规则（最重要）

一句话告诉 AI"什么时候该调用编排器技能"，形如：

当收到 {领域} 相关任务请求时，使用{orchestrator-skill-name}技能；简单问题可直接回答。

"简单问题可直接回答"这句同样重要——它防止技能在闲聊时过度触发。

② 变更历史表

变更历史是 harness 的"进化日志"：每次增删改 Agent 或技能，都追加一行（机制见 SKILL.md Phase 7-3），既方便追溯演进方向，也防止能力退化。

千万别写的 4 样东西

官方模板明确列出了CLAUDE.md 中不该放的内容：

背后的理由是单一事实来源：CLAUDE.md 里若也维护一份列表，下次加 Agent 就得改两处，两份内容迟早漂移。v1.2.0 版本正是为此把"上下文注册"改成了"指针注册"，删除了 Agent/技能列表与目录结构——演进详情见 CHANGELOG.md。

为什么"少写就是多写"

• 💡 上下文窗口是公共资源：CLAUDE.md 每次会话都整份加载，多写一行就浪费所有会话的预算。几十词的指针足够，写满几百行规则反而挤占真正干活的空间。
• 维护成本趋近于零：变更历史每次变更只加一行，无需重写大段描述；同步动作在 Phase 5-4 一次性完成（核心原则 3）。
• 职责边界清晰：CLAUDE.md 只负责"让你找到它"，"怎么做"全部委托给编排器技能。新会话启动 → 读到触发规则 → 编排器技能接管 → 按需读取 agents/skills，全貌自然展开。

一张表总结职责分工

所以下次再有人问"CLAUDE.md 应该写多详细"，记住 Harness 的答案：项目级记忆只负责指路，细节留给技能。想深入团队架构，可以继续阅读 agent-design-patterns.md 的 6 种架构模式和 team-examples.md 的 5 个真实团队配置示例。

【免费下载链接】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