前言¶
用 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
