本帖使用社区开源推广，符合推广要求。我申明并遵循社区要求的以下内容： 我的帖子已经打上 开源推广 标签： 是 我的开源项目完整开源，无未开源部分： 是 我的开源项目已链接认可 LINUX DO 社区： 是 我帖子内的项目介绍，AI生成、润色内容部分已截图发出： 是 以上选择我承诺是永久有效的，接受社区和佬友监督： 是 以下为项目介绍正文内容，AI生成、润色内容已使用截图方式发出 时隔两个月 我经历了半个学期的学习 成绩也是回到初始的状态了 既然状态已经调好 那就要vibe coding了 本次主要更新 UI布局、导入书源 等新功能 算是一次重大的更新吧（应该吧w）从Tauri换为了Fluent 为了后面更快适配手机端 或许优化了漫画导入？喵 Github链接： Tavre/QingJuan: 一款基于 Fluent + Vue 3 + Python 的桌面小说集成工具，面向“抓取、整理、下载、翻译、阅读”一体化使用场景 1 个帖子 - 1 位参与者 阅读完整话题
安装： npm install -g @mindfoldhq/trellis 从 0.4.x 升级： trellis update --migrate （ --migrate 必须加 —— breaking-change gate 会拦下没加的，详见下文"迁移流程"） 1. /start 不再是必需入口 之前每次会话开始需要 /start 加载 Trellis 上下文，再开始描述需求。现在直接自然语言描述需求就进入 Trellis 工作流，无需手动启动命令。 如果习惯先手动 start 一下再开始对话，现在 /trellis:continue 直接替代 /start 当起手命令；不放心也可以 /trellis:continue 需求是 xxx 。 2. Skill-first 架构 /start /continue /finish-work 以外的所有 Trellis 命令都变成 auto-triggered skill —— AI 看到合适的上下文会自己激活，不用你敲命令（喜欢主动节奏的用户也能继续主动唤起）。5 个命令完成转换： before-dev / brainstorm / break-loop / check / update-spec 。 每个平台下，对应位置从 commands/<name>.md 迁移到 skills/trellis-<name>/ SKILL.md 。65 条 rename migration 自动处理升级，本地改过的文件会在 confirm prompt 里让你选。 同时所有平台的命令和 skill 模板合并到单一源 packages/cli/src/templates/common/ （ 3 命令 + 5 skill ）—— 以前 "A 平台改了 B 平台没跟上" 的漂移问题一次性消除。 3. workflow.md 是工作流唯一的源 这次最核心的重构： 把工作流定义收敛到 .trellis/ workflow.md 一个 markdown 文件 。 之前工作流行为分散在三处：hook Python 脚本里硬编码、TS configurator 模板生成、命令 markdown 里的指令。想 fork 一份"我自己的工作流"得同时改三处才能自洽。 现在 workflow.md 是唯一事实源：Phase 1/2/3 step 内容、 [workflow-state:STATUS] 面包屑标签块、Skill routing 表、 task.py 16 个子命令参考。现在想修改工作流只需要改一个 markdown 文件即可。 4. /trellis:continue 命令：单任务内的 continue ，消除工作流学习成本 注意： /trellis:continue 不是跨任务的，是 单个任务内 的 continue 。它消除了用户对 Trellis 工作流的学习成本。 之前 ：用户得自己记住每一步该调哪个 slash 命令，比如 brainstorm 写 PRD → 讨论 → 让 AI 写 implement.jsonl → 调 sub-agent → check → check-cross-layer → finish-work → record-session 。 现在 ： 自然语言对话进入 brainstorm 状态、创建 task AI 跟你确认 PRD ，你 ok 就输入 continue AI 知道下一步是填充 implement.jsonl ，填完再确认 你 /trellis:continue ：AI 知道下一步是跑 implement + check 你 /trellis:continue ：AI 知道该 update-spec 你 /trellis:continue ：AI 知道该 commit + finish-work 用户只需要自然语言 + 一路 continue 就可以直接使用 trellis 工作流。底层是 /continue 读 task.json.status + artifact 状态（ prd.md / implement.jsonl curation ）查表，通过 get_context.py --mode phase --step X.X 加载具体 step 的 how-to 。 5. 多窗口并行不再互相覆盖 active-task 指针从全局 .trellis/.current-task 文件改成 per-session .trellis/.runtime/sessions/<context-key>.json 。多窗口并行时每个窗口独立 active task ，不再互相覆盖。 各平台的 session-key 来源：Claude Code 走 CLAUDE_ENV_FILE 、Codex 用 CODEX_SESSION_ID / CODEX_THREAD_ID 、Cursor 用 beforeShellExecution ticket 、OpenCode 走 Bash 前缀、Pi 注入 nested 进程。 6. Joiner onboarding：新开发者克隆 Trellis 项目自动生成入门任务 trellis init 三分支判定（基于 .trellis/ × .trellis/.developer 的存在状态）： 无 .trellis/ → Creator bootstrap （原有路径） .trellis/ 存在 + 无 .developer → Joiner （新）：自动生成 00-join-<slug> 任务 都存在 → no-op 7. 7 个平台升级到 agent-capable Qoder / CodeBuddy / Factory Droid / Cursor / Gemini CLI / Kiro / GitHub Copilot 从"仅命令"升级到完整的 agent-capable： Sub-agent 定义（ implement / check / research ）按各平台原生格式生成 Hook 基于 shared-hooks/ Python 脚本（ session-start / inject-subagent-context / statusline ）+ 各平台输出 adapter Claude Code 的 hook 也迁移到共享实现，删了 1435 行平台专有代码 同时移除了对 iflow 的支持（悲） 8. Sub-agent 上下文注入 Codex / Copilot / Gemini / Qoder （ class-2 ）无法可靠地通过 hook 改写 sub-agent prompt （上游 bug 或架构限制）。这 4 个平台只能通过在 sub-agent 定义最前面加一段指令，让 sub-agent 第一轮自己 Read prd.md 和 implement.jsonl 。 其它平台（ Claude / Cursor / OpenCode / Kiro / CodeBuddy / Droid ）继续走 hook 注入。 9. 每轮工作流面包屑 新增 inject-workflow-state.py 共享 hook ，每次用户消息触发一次（ 8 个平台的 UserPromptSubmit ； OpenCode 走 Bun plugin 的 chat.message ）。注入一个 ~200 字节的 <workflow-state> 块，根据 task.json.status 提示 AI 下一步该做什么。 面包屑内容来自 workflow.md 的 [workflow-state:STATUS] 标签块，所以魔改工作流的只需改一个 markdown 文件，不用碰 hook Python 代码。 10. SessionStart payload 重构 每次开新 session ，AI 读取的 SessionStart 块从 2.7 KB （只有 TOC + Phase Index ）升级到 9.5 KB （内联 Phase 1/2/3 每个 step 的完整 how-to ）。 <guidelines> 同时从 10.9 KB 压到 4.6 KB （ spec layer index 改成 paths-only ）。总 payload 16.7 KB ，卡在 Claude Code additionalContext 的 ~20 KB 截断阈值下。 效果：AI 不用再临时 lazy-load get_context.py --mode phase --step X.Y ，step 级指令第一轮就在上下文里。 11. 迁移与升级流程改进 行为 0.5.0 之前 0.5.0 Breaking-change gate 静默半迁移 trellis update exit 1 ，要求加 --migrate breaking 时 config.yaml 的 update.skip 半迁移状态（老路径留、新模板没写） 自动 bypass：safe-file-delete / 新文件 / 模板更新 Confirm prompt 通用 "Modified by you, [k]eep / [r]eplace?" 展示 What + Why prompted （ per-entry reason ） + 每个选项的推荐 Backup 内容 包含 .claude/worktrees/ 等（可能数百 MB ） 排除 --dry-run 仍然绕过 gate ，可以先预览迁移计划。 12. 大规模清理（ 138 条 safe-file-delete ） 这版本移除了四类"已有更好替代"的老功能： iFlow 平台 —— CLI 已不再维护 Multi-agent pipeline （ scripts/multi_agent/ + worktree.yaml ）—— 主流 agent CLI/IDE 都有原生 worktree 支持了 Ralph Loop hook （ ralph-loop.py ）—— SubagentStop + exit-code-2 跨平台不可移植； check sub-agent 自己的修复循环已经够用 6 个命令 + 3 个 sub-agent —— parallel （被原生 worktree 取代）、 onboard / create-command / integrate-skill （使用率低）、 check-cross-layer （合并进 check ）、 record-session （被 finish-work 吸收）； dispatch / debug / plan agent （被 skill routing 取代） 13. Codex 用户须知 已修 （ rc.5 ）： .codex/config.toml 默认开启 multi_agent_v2 ， min_wait_timeout_ms = 480000 （ 8 分钟） wait() 超时下限 —— 阻止父线程频繁轮询子 agent 。 需要 Codex CLI ≥ v0.128.0 ，旧版会报 untagged enum FeatureToml in features.multi_agent_v2 。 Codex 上游限制（ Trellis 侧无法修复） ： Hook context 渲染在终端 （ #191 ）—— 每轮对话都把 SessionStart hook 的 context 打印到终端，目前没有开关关闭（用 Codex desktop app 可以避免） Sub-agent 启动可能卡在 MCP server 上 —— 等某个慢/失败的 MCP 永远不返回，从 multi_agent_v1 时期就有， v2 仍未修复 doc： https://docs.trytrellis.app/zh repo: https://github.com/mindfold-ai/Trellis
安装： npm install -g @mindfoldhq/trellis 从 0.4.x 升级： trellis update --migrate （ --migrate 必须加 —— breaking-change gate 会拦下没加的，详见下文"迁移流程"） 1. /start 不再是必需入口 之前每次会话开始需要 /start 加载 Trellis 上下文，再开始描述需求。现在直接自然语言描述需求就进入 Trellis 工作流，无需手动启动命令。 如果习惯先手动 start 一下再开始对话，现在 /trellis:continue 直接替代 /start 当起手命令；不放心也可以 /trellis:continue 需求是 xxx 。 2. Skill-first 架构 /start /continue /finish-work 以外的所有 Trellis 命令都变成 auto-triggered skill —— AI 看到合适的上下文会自己激活，不用你敲命令（喜欢主动节奏的用户也能继续主动唤起）。5 个命令完成转换： before-dev / brainstorm / break-loop / check / update-spec 。 每个平台下，对应位置从 commands/<name>.md 迁移到 skills/trellis-<name>/ SKILL.md 。65 条 rename migration 自动处理升级，本地改过的文件会在 confirm prompt 里让你选。 同时所有平台的命令和 skill 模板合并到单一源 packages/cli/src/templates/common/ （ 3 命令 + 5 skill ）—— 以前 "A 平台改了 B 平台没跟上" 的漂移问题一次性消除。 3. workflow.md 是工作流唯一的源 这次最核心的重构： 把工作流定义收敛到 .trellis/ workflow.md 一个 markdown 文件 。 之前工作流行为分散在三处：hook Python 脚本里硬编码、TS configurator 模板生成、命令 markdown 里的指令。想 fork 一份"我自己的工作流"得同时改三处才能自洽。 现在 workflow.md 是唯一事实源：Phase 1/2/3 step 内容、 [workflow-state:STATUS] 面包屑标签块、Skill routing 表、 task.py 16 个子命令参考。现在想修改工作流只需要改一个 markdown 文件即可。 4. /trellis:continue 命令：单任务内的 continue ，消除工作流学习成本 注意： /trellis:continue 不是跨任务的，是 单个任务内 的 continue 。它消除了用户对 Trellis 工作流的学习成本。 之前 ：用户得自己记住每一步该调哪个 slash 命令，比如 brainstorm 写 PRD → 讨论 → 让 AI 写 implement.jsonl → 调 sub-agent → check → check-cross-layer → finish-work → record-session 。 现在 ： 自然语言对话进入 brainstorm 状态、创建 task AI 跟你确认 PRD ，你 ok 就输入 continue AI 知道下一步是填充 implement.jsonl ，填完再确认 你 /trellis:continue ：AI 知道下一步是跑 implement + check 你 /trellis:continue ：AI 知道该 update-spec 你 /trellis:continue ：AI 知道该 commit + finish-work 用户只需要自然语言 + 一路 continue 就可以直接使用 trellis 工作流。底层是 /continue 读 task.json.status + artifact 状态（ prd.md / implement.jsonl curation ）查表，通过 get_context.py --mode phase --step X.X 加载具体 step 的 how-to 。 5. 多窗口并行不再互相覆盖 active-task 指针从全局 .trellis/.current-task 文件改成 per-session .trellis/.runtime/sessions/<context-key>.json 。多窗口并行时每个窗口独立 active task ，不再互相覆盖。 各平台的 session-key 来源：Claude Code 走 CLAUDE_ENV_FILE 、Codex 用 CODEX_SESSION_ID / CODEX_THREAD_ID 、Cursor 用 beforeShellExecution ticket 、OpenCode 走 Bash 前缀、Pi 注入 nested 进程。 6. Joiner onboarding：新开发者克隆 Trellis 项目自动生成入门任务 trellis init 三分支判定（基于 .trellis/ × .trellis/.developer 的存在状态）： 无 .trellis/ → Creator bootstrap （原有路径） .trellis/ 存在 + 无 .developer → Joiner （新）：自动生成 00-join-<slug> 任务 都存在 → no-op 7. 7 个平台升级到 agent-capable Qoder / CodeBuddy / Factory Droid / Cursor / Gemini CLI / Kiro / GitHub Copilot 从"仅命令"升级到完整的 agent-capable： Sub-agent 定义（ implement / check / research ）按各平台原生格式生成 Hook 基于 shared-hooks/ Python 脚本（ session-start / inject-subagent-context / statusline ）+ 各平台输出 adapter Claude Code 的 hook 也迁移到共享实现，删了 1435 行平台专有代码 同时移除了对 iflow 的支持（悲） 8. Sub-agent 上下文注入 Codex / Copilot / Gemini / Qoder （ class-2 ）无法可靠地通过 hook 改写 sub-agent prompt （上游 bug 或架构限制）。这 4 个平台只能通过在 sub-agent 定义最前面加一段指令，让 sub-agent 第一轮自己 Read prd.md 和 implement.jsonl 。 其它平台（ Claude / Cursor / OpenCode / Kiro / CodeBuddy / Droid ）继续走 hook 注入。 9. 每轮工作流面包屑 新增 inject-workflow-state.py 共享 hook ，每次用户消息触发一次（ 8 个平台的 UserPromptSubmit ； OpenCode 走 Bun plugin 的 chat.message ）。注入一个 ~200 字节的 <workflow-state> 块，根据 task.json.status 提示 AI 下一步该做什么。 面包屑内容来自 workflow.md 的 [workflow-state:STATUS] 标签块，所以魔改工作流的只需改一个 markdown 文件，不用碰 hook Python 代码。 10. SessionStart payload 重构 每次开新 session ，AI 读取的 SessionStart 块从 2.7 KB （只有 TOC + Phase Index ）升级到 9.5 KB （内联 Phase 1/2/3 每个 step 的完整 how-to ）。 <guidelines> 同时从 10.9 KB 压到 4.6 KB （ spec layer index 改成 paths-only ）。总 payload 16.7 KB ，卡在 Claude Code additionalContext 的 ~20 KB 截断阈值下。 效果：AI 不用再临时 lazy-load get_context.py --mode phase --step X.Y ，step 级指令第一轮就在上下文里。 11. 迁移与升级流程改进 行为 0.5.0 之前 0.5.0 Breaking-change gate 静默半迁移 trellis update exit 1 ，要求加 --migrate breaking 时 config.yaml 的 update.skip 半迁移状态（老路径留、新模板没写） 自动 bypass：safe-file-delete / 新文件 / 模板更新 Confirm prompt 通用 "Modified by you, [k]eep / [r]eplace?" 展示 What + Why prompted （ per-entry reason ） + 每个选项的推荐 Backup 内容 包含 .claude/worktrees/ 等（可能数百 MB ） 排除 --dry-run 仍然绕过 gate ，可以先预览迁移计划。 12. 大规模清理（ 138 条 safe-file-delete ） 这版本移除了四类"已有更好替代"的老功能： iFlow 平台 —— CLI 已不再维护 Multi-agent pipeline （ scripts/multi_agent/ + worktree.yaml ）—— 主流 agent CLI/IDE 都有原生 worktree 支持了 Ralph Loop hook （ ralph-loop.py ）—— SubagentStop + exit-code-2 跨平台不可移植； check sub-agent 自己的修复循环已经够用 6 个命令 + 3 个 sub-agent —— parallel （被原生 worktree 取代）、 onboard / create-command / integrate-skill （使用率低）、 check-cross-layer （合并进 check ）、 record-session （被 finish-work 吸收）； dispatch / debug / plan agent （被 skill routing 取代） 13. Codex 用户须知 已修 （ rc.5 ）： .codex/config.toml 默认开启 multi_agent_v2 ， min_wait_timeout_ms = 480000 （ 8 分钟） wait() 超时下限 —— 阻止父线程频繁轮询子 agent 。 需要 Codex CLI ≥ v0.128.0 ，旧版会报 untagged enum FeatureToml in features.multi_agent_v2 。 Codex 上游限制（ Trellis 侧无法修复） ： Hook context 渲染在终端 （ #191 ）—— 每轮对话都把 SessionStart hook 的 context 打印到终端，目前没有开关关闭（用 Codex desktop app 可以避免） Sub-agent 启动可能卡在 MCP server 上 —— 等某个慢/失败的 MCP 永远不返回，从 multi_agent_v1 时期就有， v2 仍未修复 doc： https://docs.trytrellis.app/zh repo: https://github.com/mindfold-ai/Trellis
历时多个迭代之后，Trellis v0.5.0 第一个可用 beta 正式上线！这是 0.4.0 GA 以来最大的一次架构换血，期待大家上手试试并反馈问题！ 安装： npm install -g @mindfoldhq/trellis@beta 从 0.4.x 升级： trellis update --migrate （ --migrate 这次必须加，详见下文"强制迁移"） 1. Skill-first 架构 /start /continue /finish-work 以外的所有 Trellis 命令都变成 auto-triggered skill —— AI 看到合适的上下文会自己激活，不用你敲 /trellis:before-dev （另外 skill 本身也是可以由用户主动唤起触发的，所以更喜欢主动掌控节奏命令的用户仍旧可以继续使用原有流程）。5 个命令完成转换： before-dev / brainstorm / break-loop / check / update-spec 每个平台下，对应位置从 commands/<name>.md 迁移到 skills/trellis-<name>/ SKILL.md 。升级时有 65 条 rename migration 自动处理，用户本地改过的文件会在 confirm prompt 里让你选。 同时所有平台的命令和 skill 模板合并到单一源 packages/cli/src/templates/common/ （ 3 个命令 + 5 个 skill ）—— 以前 "A 平台更新了 B 平台没跟上" 的漂移问题一次性消除。 2. 7 个平台升级到 agent-capable Qoder / CodeBuddy / Factory Droid / Cursor / Gemini CLI / Kiro / GitHub Copilot 从 "仅命令" 升级到完整的 agent-capable： Sub-agent 定义（ implement / check / research ）按各平台原生格式生成 Hook 基于 shared-hooks/ Python 脚本（ session-start / inject-subagent-context / statusline ）—— 单一实现 + 跨平台输出 adapter Claude Code 的 hook 也迁移到共享实现，删了 1435 行平台专有代码 同时我们移除了对 iflow 的支持（悲） 3. Workflow enforcement v2：每轮面包屑 新增 inject-workflow-state.py 共享 hook ，每次你发消息触发一次（ 8 个平台的 UserPromptSubmit ； OpenCode 走 Bun plugin 的 chat.message ）。会注入一个 ~200 字节的 <workflow-state> 块，根据当前任务的 status 提示 AI 下一步该做什么，帮 AI 更稳地走完 plan → execute → finish 三阶段。 面包屑内容来自 workflow.md 里的 [workflow-state:STATUS] 标签块 —— fork 工作流的用户 只需改一个 markdown 文件 ，不用碰 hook Python 代码。 4. Sub-agent 上下文注入：class-1 hook vs class-2 pull-based Codex / Copilot / Gemini / Qoder （ class-2 ）无法可靠地通过 hook 改写 sub-agent prompt （上游 bug 或架构限制）。这 4 个平台改走 pull-based prelude —— sub-agent 定义的最前面加一段指令，让 sub-agent 在第一轮自己 Read .current-task + prd.md + implement.jsonl 。 Class-1 平台（ Claude / Cursor / OpenCode / Kiro / CodeBuddy / Droid ）继续走 hook 推送注入。两种路径都在共享基础设施里，以后新加平台挑一种就能用。 5. workflow.md ：唯一的工作流 SoT 这次 0.5.0 最核心的重构 —— 把"Trellis 的工作流定义"收敛到 .trellis/ workflow.md 一个 markdown 文件 。 之前工作流行为分散在三处：hook Python 脚本里硬编码分支、configurator TypeScript 里的模板生成、命令 markdown 里的分步指令。想 fork 一份"我自己的工作流"得同时改三处才能自洽。 现在 workflow.md 是 单一事实源（ single source of truth ） ： Phase 定义 ： ## Phase 1: Plan / ## Phase 2: Execute / ## Phase 3: Finish 三阶段 + 每阶段的 step 内容，AI 从这里读指令 Skill routing 表 ：哪个场景用哪个 skill ，改 workflow.md 就改路由 Per-turn 面包屑内容 ： [workflow-state:no_task]...[/workflow-state:no_task] 标签块定义每个状态下 AI 该做什么 task.py 16 个子命令的使用时机 ：lifecycle / context / metadata / hierarchy / PR 五组用途 Fork 工作流 = 改一个 markdown 文件 。不用碰 Python 、不用改 hook 、不用重发包。自己团队想要"多一个 review phase"、"把 plan 拆成 A/B 两条分支"、"加一个 [workflow-state:blocked] 状态"？全在 workflow.md 里改。 workflow.md 本体也瘦身了（ 17 KB → 14 KB ）：去掉重复段、 task.py 命令表从 5 条扩到 16 条并加了 --help 指引。 同时我们引入 /continue 命令，配合上面的 workflow.md SoT + SessionStart 注入形成完整闭环。 让 ai 获取到当前的工作流进入到哪一步，以及下一步需要干什么（比如下一步应该 before-dev 还是 check 还是 update-spec ），通过这个机制也可以让 ai 更好的进入 brainstorm 或者是创建 task 的流程，避免之前的 ai 跳步骤的情况（同时因为只维护唯一的 workflow 的 source of truth ，也更方便大家魔改二开流程，不用费劲去各个地方修改脚本，文档） 6. SessionStart payload 重构：step 级 how-to 直接前置 每次开新 session ，AI 读取的 SessionStart 块从 2.7 KB （只有 TOC + Phase Index ）升级到 9.5 KB （内联 Phase 1/2/3 每个 step 的完整 how-to ） 。效果： 开场即上手 ：AI 不用再临时 lazy-load get_context.py --mode phase --step X.Y ，step 级指令第一轮就在上下文里 <workflow> 和 <guidelines> 一起瘦身 ：guidelines 从 10.9 KB 压到 4.6 KB （跨包 guides/ index.md 保留内联， spec/<pkg>/<layer>/ index.md 改成 paths-only ； sub-agent 需要的具体 spec 走 jsonl 注入，主 agent 需要时按需读） 总 payload 控制在 16.7 KB ，卡在 Claude Code additionalContext 的 ~20 KB 截断阈值下 加上每轮面包屑 hook （每个用户消息注入 <workflow-state> 块），AI 整个 session 的"当前该做什么"感知成本降到几乎 0 。 7. /record-session 被 /finish-work 吸收 /trellis:record-session 命令移除了。它原本唯一的职责（写 session journal ）现在是 /trellis:finish-work 的 Step 3 ，finish-work 同时覆盖 Quality Gate 和 Commit 提醒。 如果你的 alias 或脚本引用了 record-session ，请改成 finish-work 。 8. 强制迁移 gate （--migrate 必加） 这是 breaking release ，从 0.4.x 升级时 trellis update 会 exit 1 明确要求你加 --migrate ： ✖ MIGRATION REQUIRED Breaking changes between 0.4.0 → 0.5.0-beta.3 require --migrate. Run: trellis update --migrate 之前的行为是安静跳过 rename/delete 条目但仍然推进 .version 戳，留下"半迁移"状态（老路径和新模板并存）。新 gate 避免这种坑。 --dry-run 会绕过 gate ，你可以先 trellis update --migrate --dry-run 预览。 8.1 config.yaml 里的 update.skip 自动 bypass （只有 breaking change 时会这样） 如果你在 .trellis/config.yaml 配了 update.skip （比如保护 .claude/commands/ ），之前升 breaking release 会卡在半迁移状态 —— 老命令留着、新命令不来。现在 gate 触发时 update.skip 会对三类操作全部 bypass： safe-file-delete （清理老文件） 新文件写入（比如 continue.md ） 模板更新（比如 finish-work.md ） 本地改过的文件仍由 "Modified by you" confirm prompt 保护，不会粗暴覆盖。顶部会有 ⚠ 黄色提示列出 bypass 的文件。 9. 大规模清理（ 126 条 safe-file-delete + 12 额外） 这版本移除了四类"已有更好替代"的老功能： iFlow 平台 —— CLI 已不再维护；整个 .iflow/ 目录移除 Multi-agent pipeline （ .trellis/scripts/multi_agent/ + worktree.yaml ）—— 目前基本主流的 agent cli/ide 都有原生 worktree 支持了 Ralph Loop hook （ ralph-loop.py ）—— SubagentStop + exit-code-2 跨平台不可移植； check sub-agent 自己的修复循环已经够用 6 个命令 + 3 个 sub-agent —— parallel （被原生 worktree 取代）、 onboard / create-command / integrate-skill （使用率低）、 check-cross-layer （合并进 check ）、 record-session （被 finish-work 吸收）； dispatch / debug / plan agent （被 skill routing 取代） 所有清理都 hash 校验 ：本地改过的文件就保留 + 警告；只有原版 Trellis 写入的文件会被清。 10. 其他值得一提的改进 Confirm prompt 重设计 —— 现在显示 What （这次 migration 做什么）+ Why prompted （为什么被 flag 成 modified ，可以由 manifest 作者在 reason 字段里写版本特定的上下文）+ 每个选项的推荐场景和后果 Backup 不再打包 .claude/worktrees/ / .cursor/worktrees/ / .gemini/worktrees/ —— 开了 worktree 后 backup 不会再膨胀到数百 MB SessionStart payload 从 2.7 KB 增至 9.5 KB ，把 Phase 1/2/3 step body 内联进去 —— AI 一开场就有 step 级 how-to task.py 命令表从 5 条扩到 16 条（ lifecycle / context / metadata / hierarchy / PR 分组） v0.5.0 GA 的时间线预计看 beta 稳定性决定 —— 大的架构改动都在 beta.0 / beta.3 落地了，后续 beta 应该主要跑 bug 修复。 11. 后续 roadmap 加强 brainstorm 的规划，提问能力 对 tdd 流程提供可选模板 引入类似 plugin 的机制，让用户能接入自定义的外部流程 repo: https://github.com/mindfold-ai/Trellis doc: https://docs.trytrellis.app/zh
历时多个迭代之后，Trellis v0.5.0 第一个可用 beta 正式上线！这是 0.4.0 GA 以来最大的一次架构换血，期待大家上手试试并反馈问题！ 安装： npm install -g @mindfoldhq/trellis@beta 从 0.4.x 升级： trellis update --migrate （ --migrate 这次必须加，详见下文"强制迁移"） 1. Skill-first 架构 /start /continue /finish-work 以外的所有 Trellis 命令都变成 auto-triggered skill —— AI 看到合适的上下文会自己激活，不用你敲 /trellis:before-dev （另外 skill 本身也是可以由用户主动唤起触发的，所以更喜欢主动掌控节奏命令的用户仍旧可以继续使用原有流程）。5 个命令完成转换： before-dev / brainstorm / break-loop / check / update-spec 每个平台下，对应位置从 commands/<name>.md 迁移到 skills/trellis-<name>/ SKILL.md 。升级时有 65 条 rename migration 自动处理，用户本地改过的文件会在 confirm prompt 里让你选。 同时所有平台的命令和 skill 模板合并到单一源 packages/cli/src/templates/common/ （ 3 个命令 + 5 个 skill ）—— 以前 "A 平台更新了 B 平台没跟上" 的漂移问题一次性消除。 2. 7 个平台升级到 agent-capable Qoder / CodeBuddy / Factory Droid / Cursor / Gemini CLI / Kiro / GitHub Copilot 从 "仅命令" 升级到完整的 agent-capable： Sub-agent 定义（ implement / check / research ）按各平台原生格式生成 Hook 基于 shared-hooks/ Python 脚本（ session-start / inject-subagent-context / statusline ）—— 单一实现 + 跨平台输出 adapter Claude Code 的 hook 也迁移到共享实现，删了 1435 行平台专有代码 同时我们移除了对 iflow 的支持（悲） 3. Workflow enforcement v2：每轮面包屑 新增 inject-workflow-state.py 共享 hook ，每次你发消息触发一次（ 8 个平台的 UserPromptSubmit ； OpenCode 走 Bun plugin 的 chat.message ）。会注入一个 ~200 字节的 <workflow-state> 块，根据当前任务的 status 提示 AI 下一步该做什么，帮 AI 更稳地走完 plan → execute → finish 三阶段。 面包屑内容来自 workflow.md 里的 [workflow-state:STATUS] 标签块 —— fork 工作流的用户 只需改一个 markdown 文件 ，不用碰 hook Python 代码。 4. Sub-agent 上下文注入：class-1 hook vs class-2 pull-based Codex / Copilot / Gemini / Qoder （ class-2 ）无法可靠地通过 hook 改写 sub-agent prompt （上游 bug 或架构限制）。这 4 个平台改走 pull-based prelude —— sub-agent 定义的最前面加一段指令，让 sub-agent 在第一轮自己 Read .current-task + prd.md + implement.jsonl 。 Class-1 平台（ Claude / Cursor / OpenCode / Kiro / CodeBuddy / Droid ）继续走 hook 推送注入。两种路径都在共享基础设施里，以后新加平台挑一种就能用。 5. workflow.md ：唯一的工作流 SoT 这次 0.5.0 最核心的重构 —— 把"Trellis 的工作流定义"收敛到 .trellis/ workflow.md 一个 markdown 文件 。 之前工作流行为分散在三处：hook Python 脚本里硬编码分支、configurator TypeScript 里的模板生成、命令 markdown 里的分步指令。想 fork 一份"我自己的工作流"得同时改三处才能自洽。 现在 workflow.md 是 单一事实源（ single source of truth ） ： Phase 定义 ： ## Phase 1: Plan / ## Phase 2: Execute / ## Phase 3: Finish 三阶段 + 每阶段的 step 内容，AI 从这里读指令 Skill routing 表 ：哪个场景用哪个 skill ，改 workflow.md 就改路由 Per-turn 面包屑内容 ： [workflow-state:no_task]...[/workflow-state:no_task] 标签块定义每个状态下 AI 该做什么 task.py 16 个子命令的使用时机 ：lifecycle / context / metadata / hierarchy / PR 五组用途 Fork 工作流 = 改一个 markdown 文件 。不用碰 Python 、不用改 hook 、不用重发包。自己团队想要"多一个 review phase"、"把 plan 拆成 A/B 两条分支"、"加一个 [workflow-state:blocked] 状态"？全在 workflow.md 里改。 workflow.md 本体也瘦身了（ 17 KB → 14 KB ）：去掉重复段、 task.py 命令表从 5 条扩到 16 条并加了 --help 指引。 同时我们引入 /continue 命令，配合上面的 workflow.md SoT + SessionStart 注入形成完整闭环。 让 ai 获取到当前的工作流进入到哪一步，以及下一步需要干什么（比如下一步应该 before-dev 还是 check 还是 update-spec ），通过这个机制也可以让 ai 更好的进入 brainstorm 或者是创建 task 的流程，避免之前的 ai 跳步骤的情况（同时因为只维护唯一的 workflow 的 source of truth ，也更方便大家魔改二开流程，不用费劲去各个地方修改脚本，文档） 6. SessionStart payload 重构：step 级 how-to 直接前置 每次开新 session ，AI 读取的 SessionStart 块从 2.7 KB （只有 TOC + Phase Index ）升级到 9.5 KB （内联 Phase 1/2/3 每个 step 的完整 how-to ） 。效果： 开场即上手 ：AI 不用再临时 lazy-load get_context.py --mode phase --step X.Y ，step 级指令第一轮就在上下文里 <workflow> 和 <guidelines> 一起瘦身 ：guidelines 从 10.9 KB 压到 4.6 KB （跨包 guides/ index.md 保留内联， spec/<pkg>/<layer>/ index.md 改成 paths-only ； sub-agent 需要的具体 spec 走 jsonl 注入，主 agent 需要时按需读） 总 payload 控制在 16.7 KB ，卡在 Claude Code additionalContext 的 ~20 KB 截断阈值下 加上每轮面包屑 hook （每个用户消息注入 <workflow-state> 块），AI 整个 session 的"当前该做什么"感知成本降到几乎 0 。 7. /record-session 被 /finish-work 吸收 /trellis:record-session 命令移除了。它原本唯一的职责（写 session journal ）现在是 /trellis:finish-work 的 Step 3 ，finish-work 同时覆盖 Quality Gate 和 Commit 提醒。 如果你的 alias 或脚本引用了 record-session ，请改成 finish-work 。 8. 强制迁移 gate （--migrate 必加） 这是 breaking release ，从 0.4.x 升级时 trellis update 会 exit 1 明确要求你加 --migrate ： ✖ MIGRATION REQUIRED Breaking changes between 0.4.0 → 0.5.0-beta.3 require --migrate. Run: trellis update --migrate 之前的行为是安静跳过 rename/delete 条目但仍然推进 .version 戳，留下"半迁移"状态（老路径和新模板并存）。新 gate 避免这种坑。 --dry-run 会绕过 gate ，你可以先 trellis update --migrate --dry-run 预览。 8.1 config.yaml 里的 update.skip 自动 bypass （只有 breaking change 时会这样） 如果你在 .trellis/config.yaml 配了 update.skip （比如保护 .claude/commands/ ），之前升 breaking release 会卡在半迁移状态 —— 老命令留着、新命令不来。现在 gate 触发时 update.skip 会对三类操作全部 bypass： safe-file-delete （清理老文件） 新文件写入（比如 continue.md ） 模板更新（比如 finish-work.md ） 本地改过的文件仍由 "Modified by you" confirm prompt 保护，不会粗暴覆盖。顶部会有 ⚠ 黄色提示列出 bypass 的文件。 9. 大规模清理（ 126 条 safe-file-delete + 12 额外） 这版本移除了四类"已有更好替代"的老功能： iFlow 平台 —— CLI 已不再维护；整个 .iflow/ 目录移除 Multi-agent pipeline （ .trellis/scripts/multi_agent/ + worktree.yaml ）—— 目前基本主流的 agent cli/ide 都有原生 worktree 支持了 Ralph Loop hook （ ralph-loop.py ）—— SubagentStop + exit-code-2 跨平台不可移植； check sub-agent 自己的修复循环已经够用 6 个命令 + 3 个 sub-agent —— parallel （被原生 worktree 取代）、 onboard / create-command / integrate-skill （使用率低）、 check-cross-layer （合并进 check ）、 record-session （被 finish-work 吸收）； dispatch / debug / plan agent （被 skill routing 取代） 所有清理都 hash 校验 ：本地改过的文件就保留 + 警告；只有原版 Trellis 写入的文件会被清。 10. 其他值得一提的改进 Confirm prompt 重设计 —— 现在显示 What （这次 migration 做什么）+ Why prompted （为什么被 flag 成 modified ，可以由 manifest 作者在 reason 字段里写版本特定的上下文）+ 每个选项的推荐场景和后果 Backup 不再打包 .claude/worktrees/ / .cursor/worktrees/ / .gemini/worktrees/ —— 开了 worktree 后 backup 不会再膨胀到数百 MB SessionStart payload 从 2.7 KB 增至 9.5 KB ，把 Phase 1/2/3 step body 内联进去 —— AI 一开场就有 step 级 how-to task.py 命令表从 5 条扩到 16 条（ lifecycle / context / metadata / hierarchy / PR 分组） v0.5.0 GA 的时间线预计看 beta 稳定性决定 —— 大的架构改动都在 beta.0 / beta.3 落地了，后续 beta 应该主要跑 bug 修复。 11. 后续 roadmap 加强 brainstorm 的规划，提问能力 对 tdd 流程提供可选模板 引入类似 plugin 的机制，让用户能接入自定义的外部流程 repo: https://github.com/mindfold-ai/Trellis doc: https://docs.trytrellis.app/zh
历时多个迭代之后，Trellis v0.5.0 第一个可用 beta 正式上线！这是 0.4.0 GA 以来最大的一次架构换血，期待大家上手试试并反馈问题！ 安装： npm install -g @mindfoldhq/trellis@beta 从 0.4.x 升级： trellis update --migrate （ --migrate 这次必须加，详见下文"强制迁移"） 1. Skill-first 架构 /start /continue /finish-work 以外的所有 Trellis 命令都变成 auto-triggered skill —— AI 看到合适的上下文会自己激活，不用你敲 /trellis:before-dev （另外 skill 本身也是可以由用户主动唤起触发的，所以更喜欢主动掌控节奏命令的用户仍旧可以继续使用原有流程）。5 个命令完成转换： before-dev / brainstorm / break-loop / check / update-spec 每个平台下，对应位置从 commands/<name>.md 迁移到 skills/trellis-<name>/SKILL.md 。升级时有 65 条 rename migration 自动处理，用户本地改过的文件会在 confirm prompt 里让你选。 同时所有平台的命令和 skill 模板合并到单一源 packages/cli/src/templates/common/ （3 个命令 + 5 个 skill）—— 以前 “A 平台更新了 B 平台没跟上” 的漂移问题一次性消除。 2. 7 个平台升级到 agent-capable Qoder / CodeBuddy / Factory Droid / Cursor / Gemini CLI / Kiro / GitHub Copilot 从 “仅命令” 升级到完整的 agent-capable： Sub-agent 定义（ implement / check / research ）按各平台原生格式生成 Hook 基于 shared-hooks/ Python 脚本（session-start / inject-subagent-context / statusline）—— 单一实现 + 跨平台输出 adapter Claude Code 的 hook 也迁移到共享实现，删了 1435 行平台专有代码 同时我们移除了对 iflow 的支持（悲） 3. Workflow enforcement v2：每轮面包屑 新增 inject-workflow-state.py 共享 hook，每次你发消息触发一次（8 个平台的 UserPromptSubmit ；OpenCode 走 Bun plugin 的 chat.message ）。会注入一个 ~200 字节的 <workflow-state> 块，根据当前任务的 status 提示 AI 下一步该做什么，帮 AI 更稳地走完 plan → execute → finish 三阶段。 面包屑内容来自 workflow.md 里的 [workflow-state:STATUS] 标签块 —— fork 工作流的用户 只需改一个 markdown 文件 ，不用碰 hook Python 代码。 4. Sub-agent 上下文注入：class-1 hook vs class-2 pull-based Codex / Copilot / Gemini / Qoder（class-2）无法可靠地通过 hook 改写 sub-agent prompt（上游 bug 或架构限制）。这 4 个平台改走 pull-based prelude —— sub-agent 定义的最前面加一段指令，让 sub-agent 在第一轮自己 Read .current-task + prd.md + implement.jsonl 。 Class-1 平台（Claude / Cursor / OpenCode / Kiro / CodeBuddy / Droid）继续走 hook 推送注入。两种路径都在共享基础设施里，以后新加平台挑一种就能用。 5. workflow.md ：唯一的工作流 SoT 这次 0.5.0 最核心的重构 —— 把"Trellis 的工作流定义"收敛到 .trellis/workflow.md 一个 markdown 文件 。 之前工作流行为分散在三处：hook Python 脚本里硬编码分支、configurator TypeScript 里的模板生成、命令 markdown 里的分步指令。想 fork 一份"我自己的工作流"得同时改三处才能自洽。 现在 workflow.md 是 单一事实源（single source of truth） ： Phase 定义 ： ## Phase 1: Plan / ## Phase 2: Execute / ## Phase 3: Finish 三阶段 + 每阶段的 step 内容，AI 从这里读指令 Skill routing 表 ：哪个场景用哪个 skill，改 workflow.md 就改路由 Per-turn 面包屑内容 ： [workflow-state:no_task]...[/workflow-state:no_task] 标签块定义每个状态下 AI 该做什么 task.py 16 个子命令的使用时机 ：lifecycle / context / metadata / hierarchy / PR 五组用途 Fork 工作流 = 改一个 markdown 文件 。不用碰 Python、不用改 hook、不用重发包。自己团队想要"多一个 review phase"、“把 plan 拆成 A/B 两条分支”、“加一个 [workflow-state:blocked] 状态”？全在 workflow.md 里改。 workflow.md 本体也瘦身了（17 KB → 14 KB）：去掉重复段、task.py 命令表从 5 条扩到 16 条并加了 --help 指引。 同时我们引入 /continue 命令，配合上面的 workflow.md SoT + SessionStart 注入形成完整闭环。 让 ai 获取到当前的工作流进入到哪一步，以及下一步需要干什么（比如下一步应该 before-dev 还是 check 还是 update-spec），通过这个机制也可以让 ai 更好的进入 brainstorm 或者是创建 task 的流程，避免之前的 ai 跳步骤的情况（同时因为只维护唯一的 workflow 的 source of truth，也更方便大家魔改二开流程，不用费劲去各个地方修改脚本，文档） 6. SessionStart payload 重构：step 级 how-to 直接前置 每次开新 session，AI 读取的 SessionStart 块从 2.7 KB（只有 TOC + Phase Index）升级到 9.5 KB（内联 Phase 1/2/3 每个 step 的完整 how-to） 。效果： 开场即上手 ：AI 不用再临时 lazy-load get_context.py --mode phase --step X.Y ，step 级指令第一轮就在上下文里 <workflow> 和 <guidelines> 一起瘦身 ：guidelines 从 10.9 KB 压到 4.6 KB（跨包 guides/index.md 保留内联， spec/<pkg>/<layer>/index.md 改成 paths-only；sub-agent 需要的具体 spec 走 jsonl 注入，主 agent 需要时按需读） 总 payload 控制在 16.7 KB ，卡在 Claude Code additionalContext 的 ~20 KB 截断阈值下 加上每轮面包屑 hook（每个用户消息注入 <workflow-state> 块），AI 整个 session 的"当前该做什么"感知成本降到几乎 0。 7. /record-session 被 /finish-work 吸收 /trellis:record-session 命令移除了。它原本唯一的职责（写 session journal）现在是 /trellis:finish-work 的 Step 3，finish-work 同时覆盖 Quality Gate 和 Commit 提醒。 如果你的 alias 或脚本引用了 record-session ，请改成 finish-work 。 8. 强制迁移 gate（–migrate 必加） 这是 breaking release，从 0.4.x 升级时 trellis update 会 exit 1 明确要求你加 --migrate ： ✖ MIGRATION REQUIRED Breaking changes between 0.4.0 → 0.5.0-beta.3 require --migrate. Run: trellis update --migrate 之前的行为是安静跳过 rename/delete 条目但仍然推进 .version 戳，留下"半迁移"状态（老路径和新模板并存）。新 gate 避免这种坑。 --dry-run 会绕过 gate，你可以先 trellis update --migrate --dry-run 预览。 8.1 config.yaml 里的 update.skip 自动 bypass（只有 breaking change 时会这样） 如果你在 .trellis/config.yaml 配了 update.skip （比如保护 .claude/commands/ ），之前升 breaking release 会卡在半迁移状态 —— 老命令留着、新命令不来。现在 gate 触发时 update.skip 会对三类操作全部 bypass： safe-file-delete （清理老文件） 新文件写入（比如 continue.md ） 模板更新（比如 finish-work.md ） 本地改过的文件仍由 “Modified by you” confirm prompt 保护，不会粗暴覆盖。顶部会有 黄色提示列出 bypass 的文件。 9. 大规模清理（126 条 safe-file-delete + 12 额外） 这版本移除了四类"已有更好替代"的老功能： iFlow 平台 —— CLI 已不再维护；整个 .iflow/ 目录移除 Multi-agent pipeline （ .trellis/scripts/multi_agent/ + worktree.yaml ）—— 目前基本主流的 agent cli/ide 都有原生 worktree 支持了 Ralph Loop hook （ ralph-loop.py ）—— SubagentStop + exit-code-2 跨平台不可移植；check sub-agent 自己的修复循环已经够用 6 个命令 + 3 个 sub-agent —— parallel （被原生 worktree 取代）、 onboard / create-command / integrate-skill （使用率低）、 check-cross-layer （合并进 check ）、 record-session （被 finish-work 吸收）； dispatch / debug / plan agent（被 skill routing 取代） 所有清理都 hash 校验 ：本地改过的文件就保留 + 警告；只有原版 Trellis 写入的文件会被清。 10. 其他值得一提的改进 Confirm prompt 重设计 —— 现在显示 What （这次 migration 做什么）+ Why prompted （为什么被 flag 成 modified，可以由 manifest 作者在 reason 字段里写版本特定的上下文）+ 每个选项的推荐场景和后果 Backup 不再打包 .claude/worktrees/ / .cursor/worktrees/ / .gemini/worktrees/ —— 开了 worktree 后 backup 不会再膨胀到数百 MB SessionStart payload 从 2.7 KB 增至 9.5 KB，把 Phase 1/2/3 step body 内联进去 —— AI 一开场就有 step 级 how-to task.py 命令表从 5 条扩到 16 条（lifecycle / context / metadata / hierarchy / PR 分组） v0.5.0 GA 的时间线预计看 beta 稳定性决定 —— 大的架构改动都在 beta.0 / beta.3 落地了，后续 beta 应该主要跑 bug 修复。 11. 后续 roadmap 加强 brainstorm 的规划，提问能力 对 tdd 流程提供可选模板 引入类似 plugin 的机制，让用户能接入自定义的外部流程 16 个帖子 - 14 位参与者 阅读完整话题