← ClaudeAtlas

project-blueprintlisted

为新项目快速建立完整 AI 编程规范体系(AGENTS.md、文档目录、CI/CD、Git规范、测试制度)。自主发现引擎:扫描项目→分类文件→推断技术栈,覆盖 7 语言 15 框架 70+ 组件,未知栈三层递进联网回退。Establish AI coding conventions for new projects — autonomous discovery engine with heuristic dep classification, 7 languages 15 frameworks 70+ components, web search fallback for unknowns.
shuguang1994/project-blueprint · ★ 23 · AI & Automation · score 79
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