SuperAPI AI 工具集

project-profiler

编程与开发

查看项目

更新于 11-05 16:17

技能介绍

用途

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 已存在,先读取再更新,而非覆盖;
  • 编排器上下文(可选):编排器可提供特定关注点或关于项目的问题。

处理流程

  1. 检测技术栈:扫描 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)等指示文件。
  2. 梳理目录结构:识别哪些目录存放 API 路由/处理器、业务逻辑/服务、数据模型、UI 组件、测试、配置、文档。
  3. 识别编码约定:扫描代码中的命名约定(camelCase、snake_case、PascalCase)、导入风格(绝对或相对)、错误处理模式、日志方式、测试组织方式、Linter/Formatter 配置。
  4. 判定认证模式:查找 JWT 中间件、会话管理、OAuth 回调、API Key 校验、认证提供商 SDK(Auth0、Firebase、Azure AD)。
  5. 梳理 CI/CD:检查 .github/workflows/(GitHub Actions)、.gitlab-ci.yml/(GitLab CI)、Jenkinsfile(Jenkins),以及构建、测试、部署命令。
  6. 生成 profile.yaml:遵循 references/profile-schema.yaml 中的 schema,尽可能填写可从代码库确定的每个字段,未知项标记为 null。
  7. 生成 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。