前言¶
用 DeepSeek Harness（DSH）或其他 AI 编程助手接手项目时，常见问题是：模型不了解项目的技术栈、目录约定和测试策略，写出来的代码风格不一，CI 也容易挂。手动编写 AGENTS.md、文档骨架和流水线，每个新项目都要重复半天到一天。
Project Blueprint 是社区维护者 shuguang1994 发布的工作流类 DSH 插件（当前版本 v1.7.1，MIT 许可证，GitHub 13 stars）。它不做静态模板填充，而是扫描项目文件、识别依赖与技术栈，再动态组装规范文档和工程基础设施。下面介绍它的定位、能力与用法。
这是什么¶
Project Blueprint 是一个可复用的 AI agent skill，打包为 DSH 插件。一句话指令即可让新项目（或在增量模式下补全已有项目）具备 AI 开发所需的规范体系。
与手写 AGENTS.md 或套用固定脚手架不同，它采用自主发现引擎：扫描 30+ 种文件模式，经三层依赖分类（知识库精确匹配 → 29 条启发式规则 → Web 搜索兜底），从 70+ 组件知识库中动态组装输出，使生成内容反映项目实际技术栈。
维护者：shuguang1994
分类：工作流
目录页：https://www.skillhub.cn/plugins/shuguang1994/project-blueprint
源码：https://github.com/shuguang1994/project-blueprint
核心功能¶
自主发现与分类¶
插件不依赖预设文件清单，而是扫描项目后自动判断：
- 项目结构：monorepo、前后端分离、单体项目
- 业务类型：13 种启发式推断
- 依赖分类：知识库命中、名称模式匹配、未知依赖实时 Web 搜索
技术栈覆盖（来自 README）：
| 层级 | 覆盖范围 |
|---|---|
| 语言（7） | TypeScript/JavaScript、Go、Python、Java、Rust、Ruby、PHP |
| 框架（15） | NestJS、Next.js、Vue 3、React、Express、FastAPI、Flask、Django、Gin、Spring Boot、SvelteKit、Nuxt 3、Laravel、Hono、uni-app |
| 其他维度 | ORM、CSS、UI 库、测试、Lint、部署、数据库、状态管理、包管理等，合计 70+ 组件 |
生成物¶
一次初始化可产出以下文件（已有文件在增量模式下不会被覆盖）：
| 输出 | 说明 |
|---|---|
AGENTS.md |
项目约定，含架构原则、模块表、技术栈、AI 常见错误防护（7 类 27 项） |
docs/ |
A/B/C/D/E 五级文档骨架，含 B-01 开发规范（8 章实内容） |
.github/workflows/ci.yml |
按语言与平台自适应的 CI 流水线 |
.gitignore |
按语言整理的忽略规则 |
CHANGELOG.md |
版本日志（含 [Unreleased] 占位） |
.husky/pre-commit |
JS/TS 项目的 pre-commit lint 钩子 |
CLAUDE.md、.cursor/rules/project.mdc 等 |
多 IDE 适配的 vendor breadcrumb |
docs/B/B-03-测试指南.md |
分层测试策略 |
docs/B/B-05-MCP工具清单.md |
按技术栈推荐的 MCP 工具及安装命令（按需生成） |
其他能力¶
- 增量模式：已有项目只补缺口，不覆盖现有文件
- 多 IDE 支持：除 DSH 外，兼容 Claude Code、Cursor、GitHub Copilot、Codex、Windsurf 等 28+ 种 agent 环境
- 自演进规则：生成的
AGENTS.md包含自动维护约定，随项目增长更新模块表与技术栈 - MCP 工具推荐：根据检测到的技术栈生成工具清单与组合建议
安装与启用¶
DSH 插件通过 SkillHub 社区目录分发。SkillHub 是独立社区站点，与 DeepSeek / 幻方无官方从属关系。
安装前建议阅读源码与 MIT 许可证，确认可接受插件以当前 DSH 进程权限读写项目文件。
在 DSH 中安装（README 官方命令）：
dsh plugin --profile web add 'github:shuguang1994/project-blueprint'
若通过 skills.sh 生态安装（支持 DSH 及其他 agent）：
# 全球（GitHub）
npx skills add shuguang1994/project-blueprint
# 国内（Gitee 镜像，无需代理）
npx skills add https://gitee.com/shuguang1994/project-blueprint.git
# 后续更新
npx skills update project-blueprint
典型用法¶
安装并启用插件后，在 DSH 会话中对目标项目说一句初始化指令即可。README 给出的示例：
Initialize this project's development standards
中文环境下可表达相同意图，例如「初始化这个项目的开发规范」。Agent 会依次执行文件扫描、依赖分类、文档与流水线生成。对已有部分规范的项目，增量模式只填充缺失项。
若项目含 README 未收录的第三方库，插件会通过 Web 搜索获取约定；生成的 AGENTS.md 也要求编码前对照官方文档核实 API 与版本。
适用场景与注意¶
适合：
- 新建项目，需要快速建立
AGENTS.md、文档骨架、CI 和测试策略 - 已有项目规范不完整，希望以增量方式补全
- 技术栈在插件知识库覆盖范围内（7 种语言、15 种框架及 70+ 组件），或可通过 Web 搜索兜底
注意：
- 插件以 DSH 进程权限运行，可读写工作区文件；安装前应检查源码
- 生成的规范是起点，复杂业务逻辑和架构决策仍需人工审阅
.husky/pre-commit仅针对 JS/TS 项目；其他语言按需调整- README 引用的行业数据（如 AGENTS.md 在开源仓库中的采用规模、Anthropic 基准中错误重写降幅）来自插件文档，非本文独立核实
小结¶
Project Blueprint 把「扫描项目 → 识别技术栈 → 生成规范与工程设施」收敛为一条指令，适合在 DSH 工作流中为新项目或存量项目补齐 AI 开发基础设施。详情与更新见目录页与 GitHub 仓库：
- 目录页：https://www.skillhub.cn/plugins/shuguang1994/project-blueprint
- GitHub：https://github.com/shuguang1994/project-blueprint
