⚡

项目上手分析Skill onboard

此技能用于分析现有软件开发项目代码库，检测技术栈，探索结构，并创建初始连续性账本，以帮助开发者快速上手和理解项目，提高开发效率。关键词：代码库分析、项目上手、连续性账本、软件开发、技术栈检测、架构理解、项目管理、代理工具。

架构设计 0 次安装 0 次浏览 更新于 3/14/2026

name: onboard description: 分析现有代码库并创建初始连续性账本 user-invocable: true

项目上手 - 项目发现与账本创建

分析现有代码库并创建初始连续性账本。

何时使用

  • 首次在现有项目中工作时
  • 用户说“上手”、“分析这个项目”、“熟悉代码库”

如何使用

启动上手代理：

使用任务工具，subagent_type: "onboard"，并输入以下提示：

Onboard me to this project at $CLAUDE_PROJECT_DIR.

1. 如果不存在，创建所需目录：
   mkdir -p thoughts/shared/handoffs/<项目名称> .claude

2. 使用可用工具探索代码库：
   - 尝试：tldr tree . && tldr structure .
   - 备选：find . -type f -name "*.py" -o -name "*.ts" -o -name "*.js" | head -50

3. 检测技术栈（查找 package.json, requirements.txt, Cargo.toml, go.mod 等）

4. 使用 AskUserQuestion 询问用户目标

5. 在 thoughts/shared/handoffs/<项目名称>/onboard-<日期>.yaml 创建 YAML 手账：
   ---
   date: <ISO 日期>
   type: onboard
   status: active
   ---
   goal: <用户声明的目标>
   now: 开始处理 <第一优先级>
   tech_stack: [检测到的技术列表]
   key_files:
     - path: <重要文件>
       purpose: <其作用>
   architecture: <简要描述>
   next:
     - <建议的第一个行动>

为什么使用代理？

上手过程：

  • 需要多个探索步骤
  • 不应用代码库转储污染主上下文
  • 返回清晰的摘要并创建手账

输出

  • 创建的目录：thoughts/shared/handoffs/<项目>/, .claude/
  • 创建的 YAML 手账（在会话开始时自动加载）
  • 用户有清晰的起始上下文
  • 准备开始工作，对项目有全面了解

注意事项

  • 此技能用于现有项目（棕色地带）
  • 对于新项目，使用 /create_plan 代替
  • 手账可以随时使用 /create_handoff 更新