Scaffold Cli Mvp

Archived: 2026-06-03 · roadmap-id: cli-mvp-scaffolder

Why

AgentDock 已完成平台基础设施与 web-nextjs 模板的一阶段建设，但目前缺乏任何面向用户的入口——开发者无法通过命令行快速创建基于模板的真实项目。更深层的问题是：传统 CLI 仅对人类可用，无法对 AI Agent 提供结构化、可自省、无交互阻塞的工具接口。我们需要在模板进入真实项目验证之前，先建立一个兼顾 人类 DX（Developer Experience） 与 Agent AX（Agent Experience） 的双轨制 CLI 运行时——这既是验证模板质量的工具，也是平台分发层的战略基础。

Capabilities

New Capabilities

• cli-runtime：CLI 双轨制运行时架构——TTY 交互层（Clack）与无头 JSON 输出层（--silent --json）的解耦设计，包括 TTY 检测、模式路由、错误码规范（CLI_VERSION_OUTDATED 等）。
• cli-init-command：agentdock init 命令的完整行为规范，涵盖人类交互流程（项目名、模板选择、包管理器）、Agent 静默流程（--silent --json）、从内置模板资产复制文件并写入已解析依赖版本。MVP 阶段模板资产内置于 CLI 包，不依赖远程拉取（Giget 远程模板为 Next 阶段）。
• cli-mcp-server：agentdock mcp 命令规范，定义 MCP Stdio 服务的工具列表（list_templates、scaffold_project、get_template_schema）、协议版本锁定与生命周期管理。
• cli-template-registry：编译期注册表规范，定义 registry.json 的 schema（id、name、description、minCliVersion、source）、generate-registry Turbo 任务的触发条件与幂等性保证。

Modified Capabilities

• platform-monorepo：新增 packages/cli 成员，turbo.json 任务图中引入 generate-registry 任务节点；monorepo 目录契约需记录 CLI 包的归属位置与 Turbo 任务依赖关系。
• platform-self-governance：packages/eslint-config 与 packages/tsconfig 从 private: true 改为公开发布，需更新包发布约束规范（Changesets 工作流覆盖范围扩展）。

Non-goals

• bun build --compile 单文件跨平台二进制：MVP 阶段不实现，推迟至 Next 阶段与 GitHub Releases 渠道一起完成。
• GitHub Releases / Homebrew tap 分发渠道：Next 阶段目标，MVP 仅支持 npm 包。
• giget 远程模板拉取：MVP 模板资产内置于 CLI 包，giget 作为预留依赖引入；远程拉取能力为 Next 阶段。
• --mirror cn 实质性加速：MVP 仅预留标志，不实现 npmmirror 等实际镜像路由逻辑。
• 模板以外的脚手架能力：如数据库初始化、CI 配置生成、Supabase 项目创建等，均不在本变更范围内。
• 多模板并行支持：MVP 仅内置 web-nextjs 一个模板；多模板注册表扩展为后续迭代。