project-blueprintlisted
Install: claude install-skill shuguang1994/project-blueprint
# Project Blueprint — AI 编程规范体系搭建 Skill
> 跨项目可复用的 7 步规范体系搭建流程。新项目一句话触发,15+ 文件自动生成。
## 触发条件
当用户说以下关键词时自动加载(中英双语):
- 初始化新项目 / 建立开发规范 / 搭建项目体系 / 项目脚手架
- init project / setup conventions / bootstrap / new project / AGENTS.md template
## 执行原则
- **探测优先**:先读取项目文件(package.json / go.mod / requirements.txt),不凭空猜测
- **最小侵入**:只补充缺失的文件,不覆盖已有配置
- **不确定就问**:技术栈/远程仓库类型不确定时,主动向用户确认
- **一步一验证**:每步完成后报告生成了哪些文件
---
## Step 1:自主发现引擎
> 不预设"有哪些文件要检查"。扫描项目实际有什么,从中自主推断技术栈。
### 1.0 读取已有项目文档(增量模式)
**首先检查**项目是否已有文档,从中提取信息而非从零猜测:
| 已有文件 | 提取内容 | 用途 |
|---------|---------|------|
| `README.md` | 项目描述、技术栈关键词 | 填充 AGENTS.md 项目身份 |
| `CONTRIBUTING.md` / `B-01-开发规范.md` | 已有编码规范 | 合并到 AGENTS.md 规范章节 |
| 已有 `AGENTS.md` / `CLAUDE.md` | 全部已有规则 | **保留→补充缺失**(不覆盖) |
| `docs/` 已有文件 | 已完成文档列表 | 跳过已有,只补充缺失 |
| `git log --oneline -20` | commit 风格(conventional / 自由格式) | 推断提交格式 |
> 原则:已有项目接入时做**增量补充**,不推翻重来。
>
> **质量判断标准**:AGENTS.md 包含以下 4 个核心章节视为"质量良好"→ 仅做缺失检查,不覆盖:
> - 项目身份(技术栈/部署信息)
> - 常用命令
> - 强制规范(模块封装/安全/性能/日志)
> - Git 规范
>
> **质量良好时**:输出 `AGENTS.md 已完善,跳过生成。检查到以下可补充项:{缺失列表}`,让用户决定是否补充。
> **仅 1-3 个章节缺��时**:补充缺失部分,保留已有内容。
> **完全没有或质量差时**:完整生成。
### 1.1 自主文件发现(扫描 → 分类 → 推断)
> **不预设文件列表**。扫描项目根目录和一级子目录,发现所��构建/配置/清单文件后按类别推断技术栈。
**发现策略**:
```
Step A: 扫描项目根目录 + 一级子目录的所有文���(跳过 node_modules/dist/.git)
Step B: 按文件名模式分类
Step C: 对分类结果逐项提取信息
```
**文件名模式 → 类别映射**(用于分类,不用于限制扫描范围):
| 文件名模式 | 类别 | 提取什么 |
|-----------|------|---------|
| `package.json` | JS/TS 项目清单 | dependencies, devDependencies, scripts → 转入 1