命令字典
Slash 命令、CLI 子命令、Hook 事件、启动参数的字典与演进史。
Slash 命令、CLI 子命令、Hook 事件、启动参数的字典与演进史。
从使用历史生成团队入门指南
/team-onboarding 是 Claude Code 内置的会话内命令,作用是从本地使用历史自动生成一份队友入门文档(Markdown),而不需要手写 README 或靠 Slack 口口相传。
该命令在 Claude Code v2.1.101 中首次发布。上线初期官方命令参考页(code.claude.com/docs/en/commands)曾遗漏该条目——GitHub Issue #46384(标题「[DOCS] Commands reference missing /team-onboarding command」,标签 enhancement、area:docs)报告了这一文档缺失。该 issue 现已 Closed(于 2026-05-02 关闭)。当前页面是否已收录,仍以访问时的实时内容为准。
**订阅/用量:**buildthisnow.com 称"Interactive usage draws from standard subscription pools",即交互式用量走标准订阅额度池;官方文档未规定使用该命令的最低计划层级(如 Pro/Max/Team/Enterprise),故不应断言具体订阅要求。
在任意 Claude Code 会话中输入:
/team-onboarding
命令执行后会输出 Markdown 指南,并可能弹出追问,供你补充团队特有说明。
claude -p "/team-onboarding" > ONBOARDING.md
适合在 CI 或脚本里自动生成入门文档后提交到仓库。
命令组合两层数据(均来自本地,不跨网络传输):
| 数据层 | 具体内容 |
|---|---|
| 结构数据 | .claude/ 目录、CLAUDE.md、项目结构、MCP server 配置 |
| 行为数据 | 当前工作目录下过去 **默认 30 天(可配置)**的命令执行历史 |
生成的 Markdown 文档包含五个部分(来源:buildthisnow.com 实测):
| 约束 | 原因 |
|---|---|
| 仅扫描当前工作目录的 transcript | 实现上只读取 ~/.claude/projects/<当前目录编码>/ 下的 .jsonl 文件,不跨项目聚合 |
| 冷启动无数据 | 行为统计依赖真实使用历史,刚克隆的仓库产出近乎空白 |
| 回溯窗口默认 30 天(可配置) | 默认只统计近 30 天的历史(buildthisnow.com:"The default lookback window is 30 days, though this is configurable"),该窗口可调整 |
| 数据不离机 | 所有分析在本地完成,只有向 Claude API 的推理调用会出网 |
**重要:**Issue #47358(标题「[BUG] /team-onboarding scans only the current workspace's transcripts, not the user's full Claude Code usage」)记录了一个范围 bug——命令声称汇总"用户全量 Claude Code 使用",但实现只读当前目录的 transcript。从
/tmp这类临时目录运行会返回 0 个 session,从不同项目目录运行会产出截然不同的结果。该 issue 带有bug、has repro、platform:macos、area:skills标签,现状态为 Closed,关闭原因是 stale(标stale、长期无活动而自动关闭,于 2026-05-24 关闭),而非官方明确「不予修复」。无论是否会修复,从主项目目录运行都是规避该限制的可靠做法。
从错误目录运行:若在 $HOME 或 /tmp 下触发命令而非实际项目目录,产出的报告会缺失绝大部分使用数据——这是上文描述的已知范围 bug(Issue #47358,现已以 stale 关闭)。最可靠的做法是从你日常工作的主项目目录运行。
输出含个人路径和 git 用户名:文档中的 generatedBy 字段来自 git config user.name,setup 清单里的路径是绝对路径。分享给团队前需手动脱敏,替换成相对路径或占位符。
行为数据需要预热:新克隆仓库或全新机器上运行,行为层数据接近空白,产出主要是结构层信息(CLAUDE.md、MCP 配置等),参考价值有限。
新增命令用于从本地 Claude Code 使用情况生成队友入门指南