create-done-coding

name	create-done-coding
description	Use when scaffolding / creating / initializing a new done-coding project from a template（创建、初始化、新建 done-coding 项目；用 done-coding 模板生成工程）. Drives the create-done-coding CLI non-interactively via npx — no resident MCP needed.

创建 done-coding 项目（create-done-coding）

用 create-done-coding CLI 从模板非交互地生成 done-coding 项目，无需常驻 MCP。

调用入口（重要）：有两个参数完全一致的等价入口——

• 本机已全局装 done-coding → 优先 done-coding create ...（最稳）。
• 否则 npx create-done-coding@latest ...（现取现用、无需预装）。

⚠️ 已发布的 create-done-coding（npx 拉取）部分版本有构建缺陷，编译模板时报 assignWith is not defined 直接失败。遇此错 → 改用全局 done-coding create（同参数）。下文示例均以 npx create-done-coding@latest 书写，整体替换为 done-coding create 即等价。

何时用

用户要：创建 / 初始化 / 新建一个 done-coding 项目；用某模板 scaffold 工程；从模板列表里挑一个生成。

心智模型（两步）

1. 查问题 --list-questions：拿到该模板要哪些答案（JSON，机读）。
2. 带答案建 --env：把答案一次性传入，非交互生成项目。

模板要么是一个 git 仓库（远端地址 / 本地绝对路径），要么是仓库内的某个子目录（用 --templateDirectory）。

前置：确定模板来源（templateUrl）

模板来源是 git 地址或本地 git 仓库根路径（/ 开头）。两种拿法：

ⓐ 用户已指明模板（给了 git 地址 / 本地路径）→ 直接作为 -p 的值。 ⓑ 从本地模板列表挑：模板列表的入口是全局指针文件 ~/.done-coding/create/index.json，解析分两跳：

1. 第一跳（指针） 读 ~/.done-coding/create/index.json，内容形如 { "configPath": "<注册表绝对路径>" }，取出 configPath。
2. 第二跳（注册表） 读 configPath 指向的 JSON，取 templateList：

{ "templateList": [
  { "name": "...", "url": "<git 或本地仓库根路径>", "directory": "<仓库内子目录,可选>", "branch": "<分支,可选>" }
] }

按 name 选定一项，取出它的 url / branch / directory。

AI 非交互调用（主场景）[MUST] 自己解析 name→url：把选中项的 url 传 -p、branch 传 -b、directory 传 --templateDirectory。不要指望 --templateConfig + --env '{"template":"<name>"}' 按 name 选——已实测：非交互模式下 CLI 不吃这个，报 缺少参数 template 直接失败（--templateConfig 只为交互式选单供数据，无 TTY 时选不了）。 [MUST NOT] 跳过指针链、凭记忆或上下文里已有的路径硬编码——来源要现查、可复述。

ⓒ 全局没配指针 / 目标不在列表（第一跳 ~/.done-coding/create/index.json 不存在，或列表里找不到要的模板）→ [MUST] 反问用户：「把本地哪个仓库（绝对路径或 git 地址）的哪个目录当作模板？」，仓库作 -p、目录作 --templateDirectory（无子目录则不传）。[MUST NOT] 自己静默回落远端默认列表，也别自己编仓库路径。

[MUST] 显式传 -p <url>（或 --templateConfig <本地列表路径>）。不要依赖「不传任何来源时静默回落远端默认列表」——来源要可见、可复述。 子目录模板用 --templateDirectory <子目录>（如 monorepo 子包 packages/xxx），不要把子目录拼进 url；本地来源的 url 必须是 git 仓库根。

步骤 1 — 查询模板需要哪些答案

npx create-done-coding@latest \
  -p <templateUrl> \
  [--templateDirectory <仓库内子目录>] \
  [-b <分支>] \
  --list-questions

仅向 stdout 打印 JSON（不创建项目，退出码 0）。形如：

[
  { "key": "organization", "required": false, "default": "done-coding" },
  { "key": "name", "required": true },
  { "key": "description", "required": true }
]

判定规则：

• required: true（且无 default 字段）→ 必填，[MUST] 供答。
• required: false（带 default）→ 选填，不供答则回落 default。

步骤 2 — 收集答案后非交互创建

答案拼成 JSON（key 对齐步骤 1 的 key，是 key 不是中文 label），经 --env 一次性供答：

npx create-done-coding@latest \
  -n <projectName> \
  -p <templateUrl> \
  [--templateDirectory <仓库内子目录>] \
  [-b <分支>] \
  --env '{"name":"<projectName>","description":"...","organization":"done-coding"}'

答案多时可改用文件：--env-file ./answers.json（内容为 { key: value }）。两者同给时 --env 浅覆盖 --env-file。

完整示例

从某 monorepo hub 的子包模板 packages/npm-node-cli（本地仓库根 /abs/hub，分支 master）创建名为 my-tool 的项目：

# 1. 先查问题
npx create-done-coding@latest -p /abs/hub -b master \
  --templateDirectory packages/npm-node-cli --list-questions
# → [{"key":"organization","required":false,"default":"done-coding"},
#    {"key":"organizationAbr","required":false,"default":"dc"},
#    {"key":"name","required":true},{"key":"description","required":true},
#    {"key":"repositoryUrl","required":false,"default":""}]

# 2. 补必填(name/description)后创建
npx create-done-coding@latest -n my-tool -p /abs/hub -b master \
  --templateDirectory packages/npm-node-cli \
  --env '{"name":"my-tool","description":"我的命令行工具","organization":"done-coding"}'
# → 生成 ./my-tool/

行为约定（据实测）

• 退出码可信：缺必填 / 失败 → 退出码 1，且在 stderr 列出缺哪些（如 name(包名)、description(描述)），不创建任何目录；成功 → 退出码 0。agent 可直接靠退出码判断成败。
• stdout 只出数据：--list-questions 的 JSON 走 stdout，诊断/报错走 stderr——解析时只读 stdout。
• 无 TTY 自动非交互：CI / agent / 管道环境下不等终端输入，缺答案即快速失败，不会卡住。
• 生成位置：当前工作目录下的 <projectName>/（或 --rootDir 指定的根下）。
• git 行为：默认会对新项目做 git 初始化；但若创建在已有 git 仓库内（如往 monorepo 的 packages/ 下生成），会自动跳过嵌套 git init。
• 创建后提示用户：cd <projectName> && pnpm install。

选项速查（公开项）

选项	别名	说明
--projectName	-n	项目名称（生成的目录名）
--templateUrl	-p	模板地址：git 地址或本地仓库根路径
--templateGitBranch	-b	模板仓库分支
--templateDirectory		仓库内模板子目录
--templateConfig		本地模板列表配置文件路径
--env		预设答案 JSON 字符串
--env-file		预设答案 JSON 文件路径
--list-questions		仅打印模板预设问题清单(JSON)，不创建
--gitCommitMessage	-m	git 初始化的提交信息