Forgeprint

Forgeprint

别人会说“这里有 200 个技能，自己找吧。”Forgeprint 会说“告诉我你是谁、 正在构建什么——这是为你准备好的套件。”

Forgeprint 是一个由社区共同建设的蓝图目录和 MCP 服务，可让编码 Agent 一次性为新项目搭建好所需上下文：AGENTS.md、技能、MCP 和插件配置，以及一份 Agent 可以执行的确定性设置方案。

状态：预发布。 蓝图、专家、团队和集成目录，实用工具，以及包含全部十个工具的 MCP 服务均已发布并可立即连接。使用 Claude Code：

claude mcp add forgeprint -- npx -y forgeprint-mcp

在 Windows PowerShell 中，请将分隔符括起来： claude mcp add forgeprint "--" npx -y forgeprint-mcp。

任何 MCP 客户端都可以连接；网站提供九个已注册 Agent 各自的命令或配置，以及包含当前数量的目录。路线图列出了其余内容。

---

问题

每个新项目都要从零开始。你得查找需求、手动编写规则文件、配置 MCP 服务、挑选插件，还得把设置步骤弄错两次才能成功。每个项目、每个人都要反复花上几个小时，没完没了。

这些知识并不难写下来，只是从来没有以其他 Agent 能用的形式记录下来。

---

有何不同

1. 解析器，而不是供人浏览的目录

你不用搜索 Forgeprint。只要描述你自己和目标，它就会返回唯一一个蓝图。

You:   I know C#. I want to build a multi-tenant SaaS API.
Agent: [resolve] → Forgeprint returns questions: which database, which auth,
       self-hosted or cloud?
You:   Postgres, JWT, cloud.
Agent: [resolve] → one blueprint, why it was chosen, what is missing on this
       machine, and the setup plan.

当个人资料不完整时，解析器不会猜测：它会返回 Agent 应该向你提出的问题。当两个候选项确实难分高下时，它会将二者作为一个问题返回，让你选择——绝不会列成清单让你自行筛选。如果没有合适的选项，它会如实说明，指出最接近的蓝图、解释为何不匹配，并提供提交请求的选项。它绝不会凭空编造匹配结果。

评分采用加权方式：你已经掌握的语言比其他任何因素都重要。

2. 设置方案，而不是描述

setup.md 是脚本，不是散文。每个步骤都有编号，且仅包含一条命令或一个文件操作，并以验证命令结束。版本均已固定。选项分支也有明确说明。Agent 会执行该方案；Forgeprint 本身不会在你的机器上安装或运行任何内容。

3. 质量门槛，而不是杂物抽屉

每个拉取请求都必须通过架构验证、在干净容器中实际运行方案的设置测试，以及与最接近的现有蓝图进行的重复项报告。两个蓝图不得声明相同的技术栈、项目类型和需求——更好的蓝图会取代旧蓝图，而不是与其并存。

没有继承，也没有变体。差异通过 options 表达，最多三个字段，每个字段最多三个值，以确保整个组合矩阵都可测试。请参阅 ADR 0001。

4. 兼容标准，而不是另创格式

Forgeprint 遵循现有规范——AGENTS.md、SKILL.md、marketplace.json——因此其输出可直接用于你现有的工具，技能也仍可通过常用渠道安装：

npx skills add forgeprint/forgeprint            # skills.sh CLI
gh skill install forgeprint/forgeprint blueprint-author

每次发布前都会使用真实工具对两者进行验证，并且如果某项技能无法安装，forgeprint validate 就会失败——请参阅 ADR 0006。

---

对比

Forgeprint 并非要取代其中大多数项目，而是填补它们之间的空白。

项目	功能	Forgeprint 的差异
microsoft/skills	170+ 个 Azure/Foundry 技能、AGENTS.md 模板、现成的 MCP 配置	可供浏览的目录；没有匹配功能，且围绕 Azure 构建
github/awesome-copilot	面向 Copilot 的社区指令、提示词和技能	规则集合；没有设置方案，也没有解析器
github/spec-kit	规范驱动开发：规范 → 计划 → 任务	流程工具。Forgeprint 提供上下文包和方案——两者相辅相成，并非竞争关系
agent-rules-mcp	一个可从任意 GitHub 仓库获取规则文件的 MCP	获取文件；没有选择功能、架构、设置或质量门槛
codeops-mcp	通用编码规则，根据现有项目生成 project.md	方向恰好相反：它分析已有项目。Forgeprint 则为尚不存在的项目搭建基础
awesome-cursorrules	Cursor .mdc 规则集合	只有一种工具和一种文件类型；没有设置功能，也没有 MCP
skills.sh、gh skills install	技能分发标准和 CLI	分发基础设施，Forgeprint 构建在其之上，而非与其竞争

---

工作原理

将你的 Agent 指向 MCP 服务，然后像平常一样交谈。 docs/mcp.md 介绍了连接详情和一次完整的交互示例。

工具	你会得到什么
resolve	要向你提出的问题，或一份蓝图及其依据、缺少的工具和设置计划
search_blueprints	符合条件的蓝图及评分，供你自行查找时使用
get_blueprint	清单和所有文件，选项分支已解析
compare_blueprints	2–4 个候选项的优缺点表格，根据它们的 overview.md 文件生成
validate_blueprint	架构错误和相似度报告，供贡献者使用
request_blueprint	没有匹配项时生成 GitHub issue 负载
recommend_experts	针对一项任务，最多推荐一个团队或最多三位专家，每项都附有理由——绝不会给出供浏览的列表
get_expert	一位专家：其 SKILL.md、检查清单和带来源的参考资料
get_crew	一个团队：完整列出其成员，以及其提及的每项集成对应的安装命令
get_integration	一份固定版本的第三方软件安装指南，包含所需密钥及其访问范围

无需 MCP 客户端，也能完成以下操作：

npx -y forgeprint get ts-http-service --agent cursor --options framework=hono

这会写入 Agent 读取的文件，以及已根据你的选项解析的安装指南——结果与工具提供的答案相同，因为底层使用的是同一套代码 （ADR 0013）。它会读取已发布的 目录，或者你在仓库检出目录中时读取本地检出版本。目录也以 JSON 形式发布在 forgeprint.github.io/forgeprint/index.json 以及 llms.txt 中。

Forgeprint 使用英语回复。你的 Agent 会用你的语言呈现内容：工具会接收 locale 提示并将其传回，因此目录中的内容无需翻译。详见 ADR 0004。

---

当前可用功能

npx forgeprint validate          # in a checkout of any Forgeprint catalog
npx -y forgeprint-mcp            # the MCP server, over stdio

要处理目录本身：

git clone https://github.com/forgeprint/forgeprint.git
cd forgeprint
pnpm install
pnpm run build
pnpm forgeprint validate

命令	功能
pnpm forgeprint validate	检查架构、分类法、必需文件和整个目录的规则
pnpm forgeprint build-index	重新生成 docs/index.json
pnpm forgeprint build-schema	重新生成 schema/manifest.schema.json
pnpm forgeprint build-codeowners	根据清单重新生成 .github/CODEOWNERS
pnpm forgeprint lint-setup <slug>	检查安装指南：编号、验证、固定版本和安全性
pnpm forgeprint similarity <slug>	与其他所有蓝图进行重复项报告

**每个流水线步骤都是可以在本地运行的命令。**托管 CI 只是为了方便，绝非依赖：工作流调用的就是这些命令，生成的索引会提交到仓库，而 GitHub Pages 会直接从分支提供索引。Actions 不可用时，也不会造成阻碍。 详见 ADR 0002。

---

目录结构

blueprints/<slug>/     one folder per blueprint — the unit of contribution
skills/                blueprint-author and blueprint-review
schema/                manifest schema and the controlled taxonomy
packages/cli/          forgeprint validate / build-* / similarity / lint-setup
packages/mcp-server/   the MCP server (npx forgeprint-mcp)
packages/site/         the static GitHub Pages site, generated into docs/
docs/                  index.json, the ADRs, and the published site

---

路线图

• 阶段 0 — 骨架。 工作区、架构、分类体系、验证与生成器、许可、贡献和治理规则。

• 阶段 1 — 首批内容。 三个 official 蓝图、blueprint-author 和 blueprint-review 技能、相似度报告及设置检查。

• 阶段 2 — MCP。 六个工具、选项解析器，以及通过标准输入／输出通信的服务，并以 forgeprint-mcp 发布。

• 阶段 3 — 发布。 网站从目录生成，并托管于 https://forgeprint.github.io/forgeprint；工作流也已运行：每次推送和拉取请求都会执行 validate，并对配方执行 setup-test。forgeprint validate 会检查分发工具读取的技能格式，因此 npx skills add 和 gh skills install 的检查结果一致（ADR 0006）。

• 阶段 4 — 社区。 贡献者可见性功能已上线：每个蓝图页面都会注明并链接其维护者，未完成的蓝图请求也会实时列出。剩下的事项取决于是否有人参与，而非是否有待完成的工作——孤立项目、过时项目和共同维护者规则已写入 GOVERNANCE.md，待有第二位维护者可供自动化时再实现自动化；社区翻译则会在有人想要翻译时开放。

  我们**不**计划添加“解决次数”计数器。这意味着服务需要了解使用者的一些信息，而 [PRIVACY.md](PRIVACY.md) 声明它不会收集任何信息。如果将来重新考虑此事，计数器也会采用匿名、自愿加入的方式；该文件也会说明这一点。
  

---

贡献

请先阅读 CONTRIBUTING.md——尤其是关于检查你想编写的蓝图是否已经存在的部分。通常，针对现有蓝图提交拉取请求是最快的合并方式。

这两个技能为你或你的 Agent 提供了相应流程： blueprint-author 可将实际项目转化为通过检查的蓝图；blueprint-review 则是评审所依据的标准。将任一技能安装到你的 Agent 中：

gh skill install forgeprint/forgeprint blueprint-author
npx skills add forgeprint/forgeprint --skill blueprint-author

或者添加 marketplace，并将它们作为 Claude Code 插件使用：

/plugin marketplace add forgeprint/forgeprint

想要一个你无法亲自编写的蓝图？请提交蓝图请求。目录会根据需求不断扩充。

谁做决定、由谁评审，以及无人回应时会发生什么： GOVERNANCE.md。

---

许可

Forgeprint 可获取源代码，但不是符合 OSI 标准的开源软件。 声称它是开源软件会更简单，却不够诚实。

内容	许可
packages/** — MCP 服务、CLI、网站	PolyForm Shield 1.0.0 — 可自由使用、修改和贡献；不得发布竞品
blueprints/**、schema/**、skills/**	CC BY 4.0 — 可将其复制到自己的项目中，无论项目是否商业用途
名称和徽标	TRADEMARK.md — 发布分支版本时必须更名
贡献	DCO 签署确认（git commit -s），无需 CLA

蓝图内容特意采用限制最少的许可：无法放进自己项目中的蓝图毫无价值。相关理由见 ADR 0003。