福生无量摸鱼天尊

skills系列(二):如何构建个人的开发skills团队

2026/01/22
2
0

由于codex至今不支持subagent,我实在等不及了,用codex开发确实没那么灵光,先用claude code组建团队,反正逻辑是一致的。这里附上一条codex不询问命令的指令:

# 尽量别问我(读写不问,删除之类的问)
codex -s workspace-write -a never
claude --allowedTools "Read" "Edit"


# 什么都不问
codex --yolo
claude --dangerously-skip-permissions

0. plan agent?subagent?skills?谁才是主角

不要给我整什么skills无敌,全流程skills,先看看怎么实现的。

首先先说大伙最熟悉的CLAUDE.md

  • Claude Code 会把 CLAUDE.md 当作项目级配置/上下文,自动并入每次对话的系统提示,让 Claude “默认就知道你的目录结构、规范、工作流”。

  • CLAUDE.md 是“让主对话更会做决定”的配置,不是subagent的调度器

那Claude Code 如何“发现/识别” subagent?

  • Claude Code 官方文档明确:subagent 是带 YAML frontmatter 的 Markdown 文件

  • subagent 可以放在不同位置,按优先级覆盖。最常用的就是项目级 .claude/agents/

核心是 frontmatter 里的 description,官方写得很直白:

  • Claude 会用每个 subagent 的 description 来决定什么时候委派。

当然,还有别的触发方式,优先级如下:

  • --agents CLI flag(最高优先级,当前会话)

  • .claude/agents/(当前项目)

  • ~/.claude/agents/(个人全局)

  • plugin 的 agents/(最低)

有的朋友可能好奇了,那我shift+tab切换的plan mode是什么呢?

  • 官方 subagent 文档里明确列了内置 subagents,包括 Explore、Plan、General-purpose

并且说明:在 plan mode 下,Claude 需要理解代码库时,会把研究任务委派给 Plan subagent(主要是 read-only research),以免子agent再spawn子agent导致无限嵌套。

那skills 是怎么被识别的?

  • skills 会被 Claude Code 从 .claude/skills/<skill-name>/SKILL.md 发现

  • skill 的 name 就是 /slash-commanddescription 用于 Claude 判断何时自动加载/调用。

  • 可以在 subagent frontmatter 里用 skills: 字段把 skills 内容“预注入”进 subagent 上下文。

综上所述:

  • CLAUDE.md:让主 Claude “默认懂你”并按你的工作流思考

  • subagent:Claude 通过 .claude/agents/*.md 发现;靠 description(+工具限制/显式调用)来决定委派

  • skills:通过 .claude/skills/**/SKILL.md 发现;可自动触发或手动 /...;是否自动触发由 disable-model-invocation 控制

  • 如果你开了官方的plan模式,请尽量点名用哪个subagent,虽然会自动判断,但是不太稳