用途
Project Profiler 用于分析一个代码库并生成项目画像,供智能体消费。它输出两份文件:
- CLAUDE.md:人可读,不超过 200 行;
- .claude/profile.yaml:机器可读。
该技能由用户主动调用,用于上手新项目或描述项目,并非由编排器派生。其产出会被下游技能消费:编排器读取 CLAUDE.md 获取项目上下文,deployment-checklist 读取其中与环境相关的命令和 URL,dependency-coordinator 读取 .claude/profile.yaml 获取技术栈画像。
角色与边界
作为项目画像生成器,它读取整个代码库——源码文件、配置、包清单、CI/CD 流水线——并产出结构化画像。
独占所有权:CLAUDE.md、.claude/profile.yaml(按模式归属)。
共享读取:所有项目文件(只读,用于分析)。
禁止触碰:src/ 及实现代码(只分析,不修改)。
冲突处理(v1.1):CLAUDE.md 此前同时被编排器与 Project Profiler 声明,现以 Project Profiler 为确定所有者,负责生成与维护;编排器仅读取它获取项目上下文。
输入
- 代码库访问权限:对项目仓库的完整读取权限;
- 现有画像(可选):若 CLAUDE.md 或 .claude/profile.yaml 已存在,先读取再更新,而非覆盖;
- 编排器上下文(可选):编排器可提供特定关注点或关于项目的问题。
处理流程
- 检测技术栈:扫描 package.json(Node.js,并检查 React、Vue、Svelte、Next.js、Express)、requirements.txt 或 pyproject.toml(Python,并检查 FastAPI、Django、Flask)、go.mod(Go)、Cargo.toml(Rust)、*.csproj(.NET)、docker-compose.yml(容器化)、prisma/(Prisma ORM)、alembic/(SQLAlchemy + Alembic)等指示文件。
- 梳理目录结构:识别哪些目录存放 API 路由/处理器、业务逻辑/服务、数据模型、UI 组件、测试、配置、文档。
- 识别编码约定:扫描代码中的命名约定(camelCase、snake_case、PascalCase)、导入风格(绝对或相对)、错误处理模式、日志方式、测试组织方式、Linter/Formatter 配置。
- 判定认证模式:查找 JWT 中间件、会话管理、OAuth 回调、API Key 校验、认证提供商 SDK(Auth0、Firebase、Azure AD)。
- 梳理 CI/CD:检查 .github/workflows/(GitHub Actions)、.gitlab-ci.yml/(GitLab CI)、Jenkinsfile(Jenkins),以及构建、测试、部署命令。
- 生成 profile.yaml:遵循 references/profile-schema.yaml 中的 schema,尽可能填写可从代码库确定的每个字段,未知项标记为 null。
- 生成 CLAUDE.md:按以下结构组织(不超过 200 行):这是什么(1–2 句)、技术栈(项目符号列表)、如何运行(安装、开发、测试、Lint 命令)、目录地图(含负责智能体分配的表)、认证模式(1 段)、编码约定(5–10 条项目符号)、不要做(禁止的模式)、CI/CD(3–5 行)、智能体备注(特殊之处、进行中的迁移、速率限制)。
质量检查清单
- profile.yaml 符合 references/profile-schema.yaml 中的结构;
- CLAUDE.md 不超过 200 行;
- 所有“如何运行”命令均验证可用;
- 目录地图与实际结构一致;
- 技术栈版本准确(取自锁文件/清单);
- 两份文件中均不含敏感数据(令牌、密码)。
适用场景
适用于新项目上手、为智能体生成项目共享上下文、描述项目等需要项目画像的场合。
限制
资料未提供关于收费、平台支持或效果保证的信息;具体 schema 内容需参考技能内的 references/profile-schema.yaml。