Oct 24, 2026

用 headcount 给 agent 装一个部门,而不是一条提示词

headcount 把 172 个 agent skill 组织成一家 16 个部门的公司,一次安装一个部门插件——security 和 legal-risk 两个评审类部门的否决意见,被评审部门无权推翻。

#tutorial#ai-agents#architecture

一条提示词装不下一家公司体量的领域知识。headcount——Chris Brock 的 2k 星 MIT 仓库——把它组织成一家公司:首席执行官之下是 16 个部门、共 172 个 skill,每个部门都是可独立安装的插件,项目只加载自己需要的职能,而不是一次全部加载。

为什么这个 Skill 重要

部门覆盖整张组织架构图,数量是 README 自己的部门名册给出的:

部门skill 数
Office of the CEO(CEO 办公室)7
Technology19
Security(评审类)8
IT Operations12
Product11
Marketing19
Demand Generation12
Revenue10
Finance13
Operations12
Program Management Office9
Customer Experience7
Data & Analytics7
Corporate Strategy6
People12
Legal & Risk(评审类)8

有两个结构性的想法把它和平铺的 skill 清单区分开。第一,skill 用 department:skill 寻址——security:threat-modeling、finance:unit-economics——名字永远不会撞车。第二,security 和 legal-risk 是评审类部门:它们评审其他部门的产出,其阻断性结论,被评审的部门无权推翻。这也是 CISO 和 CLO 向首席执行官汇报、而不是向自己监督的职能汇报的原因。

skill 还有权威出处兜底。凡是回答「外部权威说了算」的问题的 skill,都在 skill 内的 references/sources.md 里携带权威来源——覆盖税务会计、法律与雇佣、安全与控制框架、教育标准的 184 个被引用来源,遍布 150 个 skill。README 的规矩是「引用,不拷贝」:184 个里 125 个可以引用原文,其余只读并注明出处,每一条都在链接旁边用祈使句写明允许哪种用法。

安装

在 Claude Code 里添加 marketplace,然后安装一个部门:

/plugin marketplace add cbrock84/headcount
/plugin install security@headcount

项目需要几个部门就装几个。ChatGPT 和 Codex 读同一个仓库——把它添加为 plugin marketplace,或者把想要的部门放进你项目的 .agents/skills/。两边的 skill 完全相同,只有 manifest 不同,而且两套 manifest 都由同一棵目录树生成,一处修复两边同时生效。

实战:动手之前先做威胁建模

  1. 用上面的两条命令安装 security 部门。
  2. 在该部门的辖区里提问——比如 "review this design before we build it"。skill 自动加载:README 的对照表示例正是把这条请求路由给 security:threat-modeling。
  3. threat-modeling 在任何东西被构建或变更之前找出可能出错的地方:值得攻击的资产、入口点、信任边界,以及对应的控制措施。
  4. 当修复跨越部门时——README 自己的跨部门例子是潜在企业客户要求 SOC 2——完整的端到端案例在 docs/USE-CASES.md,包括评审类部门在哪里会叫停工作而不是只附带一条意见。
  5. 把整个部门委托成 subagent:每个部门在 .claude/agents/ 里带一份 agent 章程,拥有自己独占的写入面。

不想等自动加载、想直接指定视角,就按名字调用:/finance:financial-modeling。

技巧

  • skill 按匹配加载,所以只装项目需要的——README 的规矩是项目需要几个部门就装几个;先装哪些部门、调用 skill 的三种方式、评审类部门有什么不同,docs/GETTING-STARTED.md 都有讲。
  • 按写入面切分,不按话题切分——README 阐明的原则是 agent 按「独占写入面」划分,因为话题切分没有可检查的边界,两个做 "SEO" 和 "UI" 的 agent 最后会改到同一个文件。方法本身写在 executive:agent-hierarchy 里。
  • 决定装哪些部门之前,先用 cbrock84.github.io/headcount/org-chart.html 的交互式组织图搜索每个 skill、跳到它的源文件。
  • 一切都可以在本地检查:./scripts/check-all.sh 运行 CI 运行的全部检查——frontmatter 合法性、department:skill 引用解析、Claude 与 ChatGPT/Codex manifest 的一致性都在其中——本地和 CI 不会漂移。

何时不用这个 Skill

仓库自己的设计规矩就反对全装:部门的存在就是为了让项目只加载自己需要的职能,而不是一次全部加载。当 skill 只能停在建议、而工作需要一个系统时,README 列出了同一作者的其他产品——面向 SOC 2、ISO 27001、NIST CSF 和 HIPAA 项目的 GRC 平台、AI 答案扫描器、应用生成器——同时明确说明仓库里的任何东西都不依赖它们。


查看 排行榜 了解更多 skill。