第一次怎么开始

先选择你的情况。首选路线是把整段提示词交给 AI，不必自己打开终端，也不必手动 cd。

先把准备工作交给 AI

还没有项目
已有项目

在 Codex 新建一个任务，然后复制下面这段。把方括号里的内容换成你的项目名字和想法。

我要创建一个新项目：[项目名]。

它要解决的问题是：[用自己的话描述想法]。

请你替我完成准备工作：
1. 在 /Users/macdu/Documents/Projects/[项目英文名] 创建项目目录；
2. 初始化 Git；
3. 检查本机 Trellis 是否可用；
4. 在项目目录执行 trellis init --codex -u macdu；
5. 初始化后读取 AGENTS.md、.trellis/workflow.md 和生成的 skills；
6. 告诉我创建结果和项目绝对路径。

不要让我手动 cd 或输入命令。如果 Codex 需要我切换到新目录，请创建完成后明确提醒我如何在 Codex 中打开这个文件夹。开始写产品代码前，先让我确认规划。

在 Codex 中打开现有项目文件夹，再复制这段。它会先保护已有改动，然后判断是否需要初始化。

请接手当前项目，并帮我接入 Trellis。

先读取已有的 AGENTS.md、README、docs 和真实代码，执行 git status，保护当前所有用户改动。

然后检查 trellis platforms：
- 如果项目还没初始化，执行 trellis init --codex -u macdu；
- 如果已经初始化，只报告当前状态，不要重复覆盖；
- 如果检测到已有自定义规则，合并前先告诉我可能冲突的地方。

完成后说明 Trellis 新增了什么，并带我处理 00-bootstrap-guidelines。不要先修改产品功能。

做完后会多出什么

.trellis/

保存 workflow、任务、spec、工作记录和辅助脚本。
.agents/skills/trellis-*

当前 Trellis 0.6.8 为 Codex 写入的项目 skills，其他兼容 .agents/skills 的 AI 也能读取。
.codex/

Codex 的代理配置和 hooks。初始化提示会告诉你是否还需启用或批准 hooks。
AGENTS.md

仓库最上层的 AI 工作规则。
00-bootstrap-guidelines

自动创建的第一个任务，用来把模板规范校准成真实项目规范。

接着让它熟悉你的项目

trellis init 生成的是起点，不是完成状态。已有项目应立即让 AI 从真实代码提炼规范。

按 Trellis 流程执行 00-bootstrap-guidelines，并使用 $trellis-spec-bootstrap。

先读取当前仓库的 AGENTS.md、README、docs 和真实代码，
根据项目目前实际采用的目录结构、编码模式、测试方式和发布流程，
完善 .trellis/spec/。

不要写通用模板，不要留下占位内容，不要修改产品代码。
完成后先给我审阅，等我确认后再结束并归档 bootstrap 任务。

这一步只需要做一次

以后进入项目，不再重复执行 trellis init。直接让 AI 使用 $trellis-start 接手当前项目即可。