PROJECT BRIEF / 2026
01 / 11

AGENT-NATIVE WEB SCAFFOLDING

把 brief 变成
可复现的网页交付

blueprint 把语义工作留给 Agent，把脚手架、编译、校验、预览和发布收进一个确定性工具链。

Version0.1.0
InterfaceCLI + Agent Skill
OutputPortable web artifact
01 / THE GAP
02 / 11

Instructions can describe a system.
They cannot enforce one.

只给 Agent 一套说明，页面仍会在每次生成时重新发明工程细节。

Copied runtime

行为漂移

导航、移动端和交互代码被反复复制，生成物很快分叉。

Unverified output

看似能开

一个合理的 HTML 文件，仍可能在真实预览环境里失败。

Delivery gap

停在本地

设计完成之后，预览、分享和部署仍需要临时拼装。

02 / PRODUCT LOOP
03 / 11

用户只需要表达结果，不需要管理工具链。

“Agent 做完后启动 preview 给我看；没问题，再帮我发布。”

01

Brief

说明主题与受众

02

Create

选择 preset

03

Check

验证输出契约

04

Preview

本地真实查看

05

Deploy

明确授权后发布

同一份内容源贯穿创建、预览与部署，Agent 不再为每个页面重新搭工程。
03 / OWNERSHIP
04 / 11

机械行为归 CLI，语义判断归 Skill。

工作blueprint CLIAgent Skill用户
Preset 与运行时唯一实现按需加载无需管理
研究、叙事、内容不理解主题主责给目标与反馈
校验与预览确定性执行选择目标检查结果
远端发布发布并验证 URL推导名称与账户明确授权
04 / PRESETS
05 / 11

六个交付形态，一条工作流。

pitch

单页叙事

产品介绍、路演与公开故事。

briefing

全屏说明

对齐、边界、流程和培训。

archive

文档语料库

搜索、路由、ZIP 与 Mermaid。

prototype-lite

单文件原型

少量状态、快速验证、短期使用。

prototype-full

持续原型

多视图与可增长的 React 工程。

dossier

长期报告

研究、比较、尽调和白皮书。

05 / PROJECT IDENTITY
06 / 11

每个项目都有稳定血缘，而不是一份散落的 HTML。

.blueprint.json
  • 稳定 project ID
  • 名称、preset 与 entry point
  • 创建它的 blueprint 版本
  • 最近一次验证成功的部署
Discovery
blueprint list
blueprint list --root <path>
blueprint list --json
06 / DEPLOYMENT
07 / 11

分享不是网页按钮，而是 Agent 可调用的发布动作。

Target

Workers Static Assets

统一走 Wrangler 和 Cloudflare Workers，不再混用 Pages。

Worker name

repo-task

仓库内自动拼接 repo 与 task；仓库外只保留 task。

Verified record

发布后才写回

CLI 验证远端 URL，再把账户、Worker 与地址写入项目标记。

blueprint deploy <target> --name <worker-name>
07 / DISTRIBUTION
08 / 11

CLI 交付能力，Skill 交付操作方法。

Runtime

Node.js + gofs

Node.js 24+ 运行 CLI；gofs 提供只读本地预览。

Deploy

Wrangler

Cloudflare 登录、账户解析和 Workers 发布保持外部工具边界。

Skill install

@kitup/sdk

检测 Agent host、管理作用域并保护非托管目录。

Distribution

samzong/homebrew-tap

后续以 Homebrew 提供 CLI、Node.js 与 gofs 的安装入口。

blueprint skill install --scope user --agent codex --yes --force
08 / DOGFOOD
09 / 11

这套边界来自真实项目，不是模板演示。

ai-gateway

tokener demo day

旧单页被 blueprint 重新生成、纳管并发布到 Workers。

ai-gateway-tokener-demo-day.samzong.workers.dev

mosoo

product inquiry

Markdown 文集需求推动了 archive preset 和 win98-web 浏览器主题。

archive + search + zip + hash routing

项目血缘、部署记录和 preset 约束都跟随产物，而不是留在一次 Agent 对话里。
09 / DELIBERATE CUTS
10 / 11

减法也是产品设计。

10 / CURRENT STATE
11 / 11

ONE CONTENT SOURCE / ONE PORTABLE OUTPUT

blueprint 已经形成完整闭环。

6presets
6CLI workflows
21/21tests passing
1standard Agent Skill
下一阶段只剩分发与持续 dogfood：Homebrew 发布、更多真实项目验证、保持 CLI 与 Skill 契约同步。