Espalier

Trellis 的任务流程、grilling 的需求访谈、Impeccable 的前端能力，一次初始化。 0.3.0 起直接使用未改名的 Trellis 原包，保留其命令、目录、技能、环境变量与任务流程。

| 组件 | 固定版本 | 分工 | |---|---|---| | Trellis | 0.6.17 | 任务状态、文档、执行、验收与归档 | | grilling + grill-me | 技能集 1.2.3 | 复杂决策的逐轮 frontier 访谈 | | Impeccable | skill 4.3.1 / engine 0.1.5 | UX 规划材料、前端规则与检测 |

安装与使用

环境：Node.js ≥ 18.17、Python ≥ 3.9、Git。Impeccable 首次检测需联网下载官方引擎。

npm install -g @zyaiting/[email protected]

在目标项目根目录初始化：

trellis init --codex --codebuddy -u your-name

只使用一个宿主时，只保留对应的 --codex 或 --codebuddy 参数。 也可使用 npx @zyaiting/[email protected] init --codex --codebuddy -u your-name。 安装后在项目中重新打开 AI 会话，直接描述需求。

| 名称 | 用法 | |---|---| | npm 包 | @zyaiting/espalier；融合发行版，不替换上游包身份 | | CLI | trellis / tl；espalier 保留为已有用户的兼容入口 | | 项目目录 / 原生技能 | .trellis/ / trellis-* | | 宿主命令 / 环境变量 | /trellis:* / TRELLIS_* | | 全局 channel / 恢复状态 | 沿用上游 ~/.trellis/ | | trellis --version | 上游版本 0.6.17；融合版本见 npm ls -g @zyaiting/espalier --depth=0 或初始化完成提示 |

如果全局已安装独立 @mindfoldhq/trellis，先运行 npm uninstall -g @mindfoldhq/trellis，再安装本包，避免同名 bin 冲突；项目文件会保留。

日常流程

1. 描述需求，例如“按 Trellis 工作流，帮我规划并实现用户管理页面”。
2. AI 按复杂度选择 grilling 或 trellis-brainstorm，前端规划按需读取 Impeccable shape。
3. 审阅规划文档后，另发“方案确认，批准开始实现”；才运行 task.py start。
4. 实现后执行测试与 UI detect 检查，再按原生 finish-work 流程收尾。

三个组件一起安装，按协议协作，无需逐个选择或手动调度。 grill-me 和 Impeccable 的原生能力完整保留。

已有项目升级

trellis update --dry-run
trellis update

0.1.0 的 .trellis 项目直接更新；0.2.0 的 .espalier 项目先自动备份并回迁。 迁移完成后重启 AI 会话。冲突、全局状态和临时移除项目的边界见 迁移说明。 以后使用 trellis upgrade 升级本融合包，再在各项目执行 trellis update。

交付与维护

| 内容 | 约定 | |---|---| | .trellis/workflow.md | 状态注入、规划路由与 UI 检测门禁 | | .agents/skills/espalier/ | 三层分工、三条铁律、两阶段触发协议 | | .agents/skills/grilling/、grill-me/、impeccable/ | 固定上游版本原样复制，Codex / CodeBuddy 共享 | | .trellis/spec/guides/doc-writing.md | 文档 ≤ 200 行、表格优先、无占位和空话、path:line 引用 | | Trellis CLI / core / 脚本 | 直接运行固定版本原包；无派生运行时或全局命名替换 | | 更新 / 卸载 / 恢复 | 沿用上游所有权清单和保护机制，融合文件纳入管理 |

默认 native workflow 为验证路径；不兼容的自定义模板会明确报错并保留原内容。 规划与门禁属于 agent 工作协议，不是操作系统强制访问控制。 shape 是 skill reference，detect 是实际 CLI 命令；检测失败不会标为通过。 其他宿主保留 Trellis 原生初始化能力；自动发现重点验证 Codex / CodeBuddy。

npm ci
npm test
npm run test:package
npm pack

完整历史升级验证需保留 releases/ 中的 0.1.0 / 0.2.0 归档；归档不随新 npm 包重复分发。

更多约定见 集成说明、验证记录。 来源及许可证见 THIRD-PARTY-NOTICES.md。