SuperAPI AI 工具集

Agentic Builder Lab

写作与研究

查看项目

更新于 10-16 06:55

技能介绍

用途

Agentic Builder Lab 用于把一次真实的构建会话(build session)转化为一套可发布的内容产物。它的核心思路是杠杆效应:一次会话,五个发布面,每个产物都指向下一个,没有装饰性内容。

主要能力

该技能从一次构建中产出五种产物:

  1. MDX 构建日志 — 长文记录,位于 content/builds/[slug].mdx,由 frankx.ai 站点的 /agentic-builder-lab/[slug] 渲染。这是规范产物(canonical artifact),其余四个都引用它。
  2. LinkedIn 草稿 — 短帖,回链到构建日志。
  3. 演示简报 — 60-90 秒视频脚本,含镜头清单。
  4. Mermaid 图表 — 架构或智能体流程,可直接嵌入。
  5. 可复用提示词 — 把构建中的一个产物加入提示词包(prompt pack),供下一位构建者复制。

使用方式

技能按以下步骤运行:

步骤 1 — 加载语气覆盖:读取 resources/voice-spec.md,其规则对本技能产出的每个产物具有约束力。若会话中此前已加载 frankx-brand,其 studio 语气对本技能输出被抑制。

步骤 2 — 收集输入:必填字段为 build_name(短标签,成为标题)、status(live、shipping、wip、paused、archived 之一)、stack(工具列表及各自在构建中的作用)、key_learning(构建者会告诉另一位构建者的那一件事)。可选字段包括 demo_url、repo_url、day_number、outcome_metric、slug。若缺少必填字段,需在一条批量消息中向用户询问,不得编造值,也不得在四个必填字段填齐前继续。

步骤 3 — 生成五个产物:从 resources/ 加载各模板并填充。MDX 构建日志使用 resources/mdx-template.md,输出到 content/builds/[slug].mdx;LinkedIn 草稿使用 resources/linkedin-template.md,输出到 drafts/linkedin/[slug].md;演示简报使用 resources/demo-brief-template.md,输出到 drafts/demos/[slug]-brief.md;Mermaid 图表使用 resources/diagram-prompt.md,输出到 drafts/diagrams/[slug].mmd;提示词包条目使用 resources/prompt-pack-conventions.md,输出到 skills/projects/agentic-builder-lab/resources/prompt-pack/[slug].md。

步骤 4 — Lint:所有文件写入后,对每个文件 grep 禁用词。若出现任何禁用词,需在退出前重写该产物。禁用词包括 soul、awaken、transformation、alignment、journey、intentional、sacred、energy、vibration、frequency、studio、elevate、unlock(其中 studio、elevate、unlock 仅在作为隐喻时禁用,字面用法如 "recording studio"、"elevate floor 3"、"unlock the door" 可以)。Lint 必须以干净退出通过。

步骤 5 — 报告:打印五个文件路径及各自的一行摘要。不 push,不 commit,由调用方决定发布什么。

语气覆盖规则

该技能依赖 frankx-brand,但覆盖其默认 studio 语气。覆盖规则简述:技术权威;结果优先,绝不空口宣称;不使用灵性、意识或转化类语言;不使用感叹号,不使用炒作性形容词;以构建了什么、用了什么工具、结果如何开头;诚实展示失败,谦逊符合品牌。鼓励使用的词包括 architect、agent、verification、orchestration、stack、primitive、harness、scaffold、ship、repo、PR、eval。完整规范见 resources/voice-spec.md。

适用场景

适用于公开记录构建过程(logging a public build),把一次构建会话转化为多平台内容。示例调用中,用户提供 build_name、status、stack、key_learning、day_number、outcome_metric、demo_url、repo_url 后,技能产出五个对应文件。

限制与注意事项

  • 若用户在 content/builds/[slug].mdx 已有构建日志,需询问是更新还是用不同 slug 写新条目。
  • 提示词包是累积的,未经询问不得覆盖已有条目。
  • MDX frontmatter 必须通过 mdx-template.md 中的 schema 校验;若字段缺失,回退为 null,而非空字符串。
  • 生成任何产物前先读 voice-spec.md,lint 步骤前再检查一次。

技能文件结构

agentic-builder-lab/ 包含 SKILL.md 和 resources/ 目录,resources/ 下有 voice-spec.md(语气覆盖,最先加载)、mdx-template.md(构建日志 MDX 脚手架)、linkedin-template.md(9 种 LinkedIn 帖子组合)、demo-brief-template.md(60-90 秒视频简报)、diagram-prompt.md(3 个 Mermaid 图表模板)、prompt-pack-conventions.md(如何添加提示词)以及 prompt-pack/example-agents-md.md(起始提示词:AGENTS.md 模板)。