关于 project-discovery
project-discovery 是一项开发技能,要求在修改前先梳理仓库。它依据项目文件确认实际技术栈、结构、约定与风险,再提出适度的后续计划。
主要功能
- 01识别项目类型与入口
- 02根据清单文件和导入确认技术栈
- 03梳理架构与现有约定
- 04发现风险和缺少测试的区域
- 05提出符合现状的最小计划
适用场景
- 01编辑前检查代码库
- 02评估项目约定与风险热点
- 03界定 monorepo 中的工作范围
安装
复制下面的命令,在终端中运行。
$
npx skills add https:/ / github.com/ danieldxd/ myapp-skills --skill project-discovery安装后在 Claude Code 中输入/project-discovery确认已加载。
详细介绍
项目探索
编辑之前,先梳理系统。没有仓库中的证据,不要提出结构性变更。
流程
- 确定项目类型:Web 应用、API、移动应用、monorepo 或库。
- 找出入口点、配置文件,以及构建/测试/lint 脚本。
- 根据清单文件和导入语句提取实际技术栈,不要凭空假设。
- 梳理领域目录、分层和边界(UI、API、数据、身份验证)。
- 列出已有规范:命名、状态管理、错误处理、测试、CI。
- 列出风险:技术债务、关键文件、缺少测试的区域。
- 然后再提出与现有规范一致的最小计划。
检查内容
- 清单文件:
package.json、pnpm-workspace.yaml、Cargo.toml、Podfile、Package.swift、.xcodeproj - 框架:Next.js、Vite、Expo、SwiftUI、Nest、Express、Prisma
- 路由和入口点:
app/、pages/、src/main、App.tsx、ContentView - 数据:Prisma/Drizzle schema、迁移文件、HTTP 客户端
- 身份验证和中间件
- 测试和 CI:
*.test.*、Playwright、GitHub Actions - 环境变量和机密(不要暴露其值)
最简报告
提供一份简短总结:
- 技术栈和大致版本
- 架构要点(3–6 条)
- 需要遵循的规范
- 高风险区域
- 建议的下一步
规则
- 优先依据文件证据,而不是对通用模式的记忆。
- 如果文档与代码冲突,以代码为准。
- 探索期间不要顺手重构。
- 保持本地风格;未经明确要求,不要强加其他架构。如果用户要求梳理结构:
software-architecture。 - 在 monorepo 中,说明当前范围涉及哪个包/应用。
完成标准
- 已确认技术栈和入口点
- 已列出主要规范
- 已识别风险和关键依赖
- 变更计划与请求相称
评论
支持 Markdown