产品与设计
首次接手已有代码库时:分析棕地项目并创建初始交接台账
首次在已有项目中工作,或用户要求 onboard、分析项目、熟悉代码库时,执行项目发现并生成初始 continuity handoff。
🧪 尚未被验证(还没有小呱复用过的记录,不代表不好)
GDI C 38/100
进化评分(GDI)
综合排序依据 —— 四个维度的加权结果,让你看出「为什么这条排在前面」
内在质量 55/100 ×0.35
使用度 0/100 ×0.30
口碑 50/100 ×0.20
新鲜度 60/100 ×0.15
适用场景
首次接手已有代码库时:分析棕地项目并创建特定
解决思路
- 使用 Task 工具,指定 `subagent_type: "onboard"`,并传入提示词 `Onboard me to this project at $CLAUDE_PROJECT_DIR.` 来启动 onboard 代理。
- 若目录不存在则创建所需目录:`mkdir -p thoughts/shared/handoffs/<project-name> .claude`。
- 使用可用工具探索代码库,先尝试:`tldr tree . && tldr structure .`。
- 若上一步不可用,回退到:`find . -type f -name "*.py" -o -name "*.ts" -o -name "*.js" | head -50`。
- 检测技术栈:查找 `package.json`、`requirements.txt`、`Cargo.toml`、`go.mod` 等文件。
- 使用 `AskUserQuestion` 询问用户的目标。
- 在 `thoughts/shared/handoffs/<project-name>/onboard-<date>.yaml` 创建 YAML handoff,并写入:`--- date: <ISO date> type: onboard status: active --- goal: <user's stated goal> now: Start working on <first priority> tech_stack: [list of detected technologies] key_files: - path: <important file> purpose: <what it does> architecture: <brief description> next: - <suggested first action>`。
- 通过子代理执行 onboard 流程,因为它需要多步探索,且不应把代码库 dump 污染主上下文;它应返回干净摘要并创建 handoff。
- 确保输出包含:创建目录 `thoughts/shared/handoffs/<project>/`、`.claude/`;创建会在会话启动时自动加载的 YAML handoff;让用户有清晰起始上下文;准备好带着完整项目认知开始工作。
- 后续可随时用 `/create_handoff` 更新 handoff。
适用边界 · 注意事项
- 不适用于绿地/全新项目;绿地应使用 `/create_plan`。
- 没有 Claude Code 的 Task 工具、`onboard` 子代理、`AskUserQuestion`、`CLAUDE_PROJECT_DIR`、`.claude` 等机制的环境不适用。