技术栈与架构

已落地技术栈

以下组件已在 packages/cli 中实际使用，均可在源码中验证。

组件	版本	在本项目中的角色	出处
Bun	latest	构建层：`bun build` 打包为单文件 Node.js 可执行文件	github.com/oven-sh/bun
Citty	^0.1.6	命令建模：子命令定义、flag schema、lazy 加载	github.com/unjs/citty
Clack	^0.9.1	人类交互层：`@clack/prompts` 提供 TTY 交互 UI	github.com/bombshell-dev/clack
MCP TypeScript SDK	^1.0.0	Agent 协议层：实现 MCP Stdio 服务器，暴露工具接口	github.com/modelcontextprotocol/typescript-sdk
Changesets	workspace	发布治理：语义版本管理与 CHANGELOG 生成	github.com/changesets/changesets

Giget（远程模板拉取）已在选型中，当前版本模板内置于 CLI npm 包，Giget 将在支持远程模板注册表时引入。

分层架构

CLI 的核心设计约束：Human / CI / Agent 三种消费者复用同一执行器核心，表面层完全可替换。

┌─────────────────────────────────────────────┐
│              命令层 (Citty)                  │
│   src/commands/init.ts  src/commands/mcp.ts  │
│   - flag schema 定义                         │
│   - 环境检测，分发到对应适配器               │
└───────────────┬─────────────────────────────┘
                │
    ┌───────────┼────────────┐
    ▼           ▼            ▼
┌───────┐ ┌─────────┐ ┌──────────┐
│ Human │ │  Agent  │ │   MCP    │
│Adapter│ │ Adapter │ │ Adapter  │
│(Clack)│ │  (JSON) │ │(Stdio)   │
└───┬───┘ └────┬────┘ └────┬─────┘
    └──────────┴────────────┘
                │
    ┌───────────▼──────────┐
    │     执行器核心        │
    │  src/core/scaffold   │  ← 文件复制、版本检查
    │  src/core/registry   │  ← 模板注册表读取
    └──────────────────────┘