| 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 工程；从模板列表里挑一个生成。
心智模型（两步）
- 查问题
--list-questions：拿到该模板要哪些答案（JSON，机读）。
- 带答案建
--env：把答案一次性传入，非交互生成项目。
模板要么是一个 git 仓库（远端地址 / 本地绝对路径），要么是仓库内的某个子目录（用 --templateDirectory）。
前置：确定模板来源（templateUrl）
模板来源是 git 地址或本地 git 仓库根路径（/ 开头）。两种拿法：
ⓐ 用户已指明模板（给了 git 地址 / 本地路径）→ 直接作为 -p 的值。
ⓑ 从本地模板列表挑：模板列表的入口是全局指针文件 ~/.done-coding/create/index.json，解析分两跳：
- 第一跳（指针） 读
~/.done-coding/create/index.json，内容形如 { "configPath": "<注册表绝对路径>" }，取出 configPath。
- 第二跳（注册表） 读
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 的项目：
npx create-done-coding@latest -p /abs/hub -b master \
--templateDirectory packages/npm-node-cli --list-questions
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"}'
行为约定（据实测）
- 退出码可信：缺必填 / 失败 → 退出码 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 初始化的提交信息 |
