跳到主要内容
AI教程

使用 Headcount 构建 Claude Code 智能体组织

为 Claude Code 安装 Headcount 部门,自动调用专业技能并协调跨职能工作。

使用 Headcount 构建 Claude Code 智能体组织

什么是 Headcount?

Headcount 是一个为 Claude Code 构建的智能体组织。它像公司一样组织 AI 能力,由一名首席执行官统领 16 个专业部门,共计 143 项技能。

你无需在每个项目中加载一整套庞大的指令,只需安装项目所需的部门。每个部门都是一个独立的 Claude Code 插件,涵盖技术、安全、产品、营销、财务、运营、营收或客户体验等业务或技术职能。

Searchable Headcount org chart with 16 departments and 143 skills

该项目还提供一个交互式组织结构图,可用于搜索技能、打开部门并跳转到相应的源定义。

主要功能

  • 模块化部门:仅安装与项目相关的职能,而不必加载全部 143 项技能。
  • 自动选择技能:当请求与某项技能的职责范围匹配时,该技能会自动加载。
  • 直接调用:需要特定分析视角时,可调用相应的专业智能体。
  • 命名空间技能:每项技能都采用 department:skill 格式,避免名称冲突。
  • 智能体章程:各部门在 .claude/agents/ 中包含章程,可将工作委派给拥有专属写入区域的子智能体。
  • 跨部门工作流:文档中的用例展示了多个部门如何共同处理安全事件、转化漏斗停滞和 SOC 2 请求等情况。
  • 审查类权限:安全等审查类部门可以叫停会造成不可接受风险的工作,而不只是提供另一种意见。

安装 Headcount

前提条件

Headcount 专为 Claude Code 设计,因此请先确保 Claude Code 环境正常运行。安装过程使用 Claude Code 的插件命令。

第 1 步:添加 Marketplace

将 Headcount 仓库添加为插件 Marketplace:

/plugin marketplace add cbrock84/headcount

第 2 步:安装部门

安装项目所需的部门。例如,使用以下命令添加安全部门:

/plugin install security@headcount

你可以用相同方式安装其他部门。这种模块化方法可以让当前工具集保持专注,避免在每个项目中加载整个组织。

第 3 步:确定所需技能

技能通过部门命名空间进行寻址:

department:skill

示例包括:

  • security:threat-modeling
  • finance:unit-economics
  • technology:systematic-debugging
  • demand-generation:landing-page-cro-expert

使用交互式组织结构图查找任务对应的部门和准确技能名称。

基本用法

让 Headcount 选择专业智能体

正常使用时,只需用自然语言描述问题。当请求属于某个已安装部门的职责范围时,匹配的专业智能体会自动加载。

例如,可以询问:

为什么这个落地页没有带来转化?

此请求与 demand-generation:landing-page-cro-expert 匹配,该技能专注于诊断并改善落地页转化。

该项目提供的其他示例包括:

  • 请求: 请在我们开发之前审查这个设计。
    技能: security:threat-modeling
  • 请求: 我们负担得起这次招聘吗?
    技能: finance:unit-economics
  • 请求: 我们的增长停滞了。
    技能: executive:business-growth-consultant

直接调用技能

如果你希望 Headcount 选择相关专业智能体,自动路由会很有用。如果已经知道需要哪种分析视角,则可按名称直接调用技能:

/finance:financial-modeling

直接调用可明确指定所需职能。例如,使用财务建模进行预测和情景分析,而 finance:unit-economics 则专注于贡献毛利、获客成本、回收期、客户终身价值和群组行为。

为项目选择部门

应从项目的实际职责出发,而不是安装所有可用部门。软件交付项目可以使用技术部门处理架构、测试、调试、代码审查和部署,再由安全部门提供威胁建模和架构审查。

市场进入项目可以结合营销、需求生成、营收和财务部门。相关技能包括定位与信息传达、落地页转化优化、定价与套餐设计、营销分析以及单位经济模型。

Headcount 的核心设计原则是添加所需部门,而不是用一个臃肿的提示词解决所有问题。

高级技巧

结合自动路由与直接调用

如果希望系统确定合适的专业智能体,可以先使用自然语言提出请求。当你需要已知的专业领域、可重复的工作流或定义明确的审查步骤时,再切换到直接调用。

例如,你可以使用 technology:solution-exploration 探索实现方案,使用 technology:implementation-planning 制订计划,再使用 technology:completion-verification 验证结果。

使用独立审查部门

不要将每个部门都视为仅提供可选意见的来源。安全部门被定义为审查类部门,可以叫停不安全的工作。对于敏感设计,应在实施前进行威胁建模或安全架构审查,而不是等到部署时才处理。

审查流程可以表示为:

  1. 探索拟议解决方案及其权衡。
  2. 制订实施计划。
  3. 运行 security:threat-modelingsecurity:security-architecture-review
  4. 处理阻碍性风险后再继续。
  5. 实施并验证已完成的工作。

通过智能体章程委派工作

每个部门都会在 .claude/agents/ 中附带智能体章程。这些章程允许部门作为子智能体运行,并拥有自己的专属写入区域。

专属写入区域对并行工作特别有用,因为它们可以减少智能体之间的工作重叠。技术部门还提供智能体层级设计和并行智能体交付技能,涵盖编排智能体与子智能体结构以及相互独立的工作区域。

一致使用命名空间

在文档、可重复流程和直接调用中,始终保留完整的 department:skill 名称。命名空间既能明确技能所属部门,也能确保名称相似的能力不会发生冲突。

研究跨部门场景

仓库中的用例文档介绍了七种跨部门场景,包括企业潜在客户提出 SOC 2 请求、安全事件以及转化漏斗停滞。这些示例还展示了审查类权限可以在哪些环节叫停工作。

保持精简安装

随着项目需求的出现逐步安装部门。精简安装可以减少不必要的职能,同时保留对当前工作相关专业智能体的访问能力。当项目确实新增职责时,再添加其他部门,例如财务分析、运营规划或营销效果衡量。

工作流示例

假设一个团队正在准备全新的产品体验,结构化的 Headcount 工作流可以如下进行:

  1. 使用产品部门的技能审查或完善界面和设计系统。
  2. 让技术部门探索解决方案架构并制订实施计划。
  3. 在开发之前,让安全部门对设计进行威胁建模。
  4. 在交付过程中使用技术部门的测试驱动开发、代码审查和完成情况验证技能。
  5. 引入需求生成部门优化落地页转化,并由营销部门负责定位或营销活动规划。
  6. 根据需要使用财务部门检验单位经济模型或构建财务情景。

具体顺序取决于已安装的部门和项目需求。关键区别在于,每个专业智能体都有明确的职责范围,而不是共享一个不加区分的提示词。

总结

Headcount 将 Claude Code 转变为一个模块化智能体组织,包含 16 个部门和 143 项采用命名空间的技能。添加其 Marketplace,仅安装项目所需的部门;用自然语言描述任务以实现自动路由,并在需要精准分析视角时调用特定技能。对于复杂工作,可以结合部门章程、独立审查和文档化的跨职能工作流。