Town CLIAgent

town agent create

创建/初始化一个 Downcity Agent 项目

town agent create

在目标路径创建/初始化一个 Downcity Agent 项目。

这页保留为命令入口。更完整的项目初始化说明见 创建第一个 AgentCLI / create

用法

town agent create [path]

参数

  • path(可选):项目路径,默认当前目录。
  • 交互默认的 Agent id 会基于目录名自动推导,并规整为 snake_case(仅作为默认值,可手动修改)。
  • 交互过程中会从已连接的 City 上下文读取可用执行目标,并把所选 ID 写入 downcity.json.execution.modelId
  • 创建出的项目会直接写入统一的 downcity.json.execution,不再拆成旧的 model 和 session 字段。

选项

  • -f, --force [enabled]:允许覆盖已有 downcity.json(危险操作)

示例

# 在当前目录初始化
town agent create .

# 在指定目录初始化
town agent create ./my-agent-project

示例输出(基于当前实现)

以下示例直接对齐 cli/town/src 当前命令实现(含默认输出模式与字段结构),示例值使用占位符表示。

$ town agent create .
town v1.0.0
🚀 Initializing Downcity project: <projectRoot>
✅ Created PROFILE.md
✅ Created SOUL.md
✅ Created downcity.json
✅ Created .downcity/ directory structure
✅ Created downcity.schema.json

常用后续命令:

town city status
town plugin
town agent start