SuperAPI AI 工具集

integrations

AI Design Blueprint 的官方集成与可安装规范仓库,提供跨 MCP、IDE 规则、提示词文件和智能体运行时的集成资源。仓库包含共享规范文件、公开 MCP 配置与使用说明、按工具分类的设置指南,以及 Cursor、Windsurf、GitHub Copilot、Gemini 等提供商的专用指令文件。用户可通过 MCP 端点访问只读检索工具,浏览和搜索原则、实现示例与应用指南,并可选使用信号上报与反馈工具。

访问官网

工具介绍

用途

本仓库是 AI Design Blueprint 的官方集成与可安装规范(doctrine)集合,目标是把该蓝图的原则、示例和指南接入到各类 AI 工具与智能体运行时中,覆盖 MCP、IDE 规则、提示词文件和智能体运行时。

仓库内容

  • shared/:跨工具共享的规范文件
  • mcp/:公开的 MCP 配置与使用说明
  • docs/setup/:按工具划分的复制优先(copy-first)设置指南
  • cursor/、windsurf/、github-copilot/、gemini/:各提供商专用的指令文件
  • open-weights/:面向开放权重与本地模型工作流的静态提示词包
  • exports/:结构化的规范导出

公开端点

  • 站点:https://aidesignblueprint.com
  • MCP:https://aidesignblueprint.com/mcp
  • 开发者文档:https://aidesignblueprint.com/en/for-agents

使用方式

  1. 在 docs/setup/ 中选择对应的设置指南。
  2. 将相关文件或 MCP 配置添加到自己的仓库或客户端。
  3. 若使用 MCP,针对 https://aidesignblueprint.com/mcp 进行初始化。
  4. 运行第一个验证调用:clusters.list()
  5. 运行第二个验证调用:examples.search(query="orchestration visibility steering", limit=3)

公开 MCP 工具

公开检索工具(允许匿名、只读):

  • principles.list(cluster?)
  • principles.get(slug)
  • clusters.get(slug)
  • examples.get(slug)
  • principles.search(query, limit?)
  • examples.search(query, principle_ids?, difficulty?, library?, limit?)
  • guides.get(slug)
  • guides.search(query, limit?)

公开信号工具(允许匿名、需主动选择写入):

  • signals.report(event_type, surface_used?, brief_context?, perceived_value?, workflow_stage?, would_recommend?, team_size?):记录一次价值时刻;仅在用户明确表达某内容有用后才提供,绝不自动或静默调用。
  • signals.feedback(task_type?, surface?, rating_clarity?, rating_usefulness?, what_helped?, what_missing?, would_use_again?, contact_email?, permission_to_follow_up?):显式定性反馈;仅在用户明确要求留下反馈时调用。

信号工具只写入传入的结构化字段,不存储提示词、代码或文件内容。完整数据处理细节见隐私政策。

受保护工具(需认证,不属于匿名设置路径):

  • me.learning_path()
  • me.coaching_context()
  • architect.validate(implementation_context, ..., private_session?):Pro/Teams;依据 10 条原则对智能体代码评分;设置 private_session=true 可跳过该次调用的存储运行。
  • design.validate(implementation_context, ..., private_session?):Pro/Teams;界面镜像,依据 8 条体验设计法则对渲染后的前端产物评分(独立每周桶)。
  • spec.validate(implementation_context, ..., private_session?):Pro/Teams;构建内容视角,依据 8 条规格质量法则对书面规格评分(独立每周桶)。
  • team.summarize(days_back?, private_session?):Pro/Teams;跨三个验证器视角的使用反思与推荐后续资产。
  • me.add_evidence(course_slug, stage_id, note)

反馈与价值信号规则

  • 仅在用户明确表达某内容有用后才调用 signals.report。绝不自动或静默调用。在明确成功信号后,每个会话最多提供一次。
  • 仅在用户明确要求留下反馈时调用 signals.feedback。绝不主动提示。
  • 绝不在 brief_context 中包含专有代码、文件内容或机密。

治理徽章

用于表明智能体或仓库遵循 Blueprint 规范。

  • 免费徽章:粘贴到 README.md(无需账户)。
  • Pro 徽章:通过 MCP 运行 architect.validate()。响应包含 run_id、badge_url 和 review_url。Pro 徽章显示层级(Governed · X/Y 或 Reviewed · X/Y)并链接到公开就绪审查页面。需要 Pro 或 Beta 账户。

当前有意未提供的内容

  • 无公开 OpenAPI schema
  • 除 MCP 和静态资产外,无公开 HTTP API 契约
  • 无 CLI 安装器
  • 无推测性的合作伙伴专属分发

事实来源

本仓库旨在镜像 aidesignblueprint.com 上已发布的规范公开契约。在此发布变更前,请确认 /agent-assets/[slug] 与本仓库提交的文件保持一致。