Trellis魔改版为Claude Code添加多项开发策略

背景

Trellis 是一个面向 Claude Code 的开发工作流管理工具，旨在将 AI 辅助编码过程中的多步骤任务结构化、可追溯化。原版 Trellis 提供了任务创建、实现、检查等基础能力，但面对复杂项目时，开发者在细节追问、代码质量把关、架构一致性等方面仍缺乏系统化的自动化支持。为此，社区开发者 LonelyHerbivore 基于 Trellis 0.6.0-beta.17 进行定向魔改，推出了 Trellis-Herbivore（项目名 trellis-hgl），专门针对 Claude Code 的单工具工作流场景引入一系列可选增强策略，形成了一套更严谨、更可控的开发流程。

核心内容

Trellis-Herbivore 在保留原生 Trellis 所有能力的前提下，新增了多个可选策略模块，覆盖从需求分析到最终合并的完整流程。整个工作流的执行顺序为：

用户以自然语言提出需求 → 判断是否需要创建 Trellis 任务 → 执行 trellis-brainstorm → 执行 trellis-grill-me（基于 PRD 追问细节并更新 PRD）→ 进行开发策略决策 → 执行 trellis-implement → 执行 trellis-check → 执行 trellis-spec-review（spec 二次检查）→ 执行 trellis-code-review（代码守护者）→ 执行 trellis-code-architecture-review（代码架构守护者）→ 执行可选的 trellis-improve-codebase-architecture（代码深层架构分析师）→ 执行 trellis-update-spec → 合并分支（可选）→ 执行 trellis-merge-review（合并后的最终质量检查）→ 编译/测试运行 → 以 /trellis:finish-work 或自然语言提出任务存档结束。

新增策略模块说明：

• trellis-grill-me：基于 PRD 向用户追问细节，完善需求。
• subagent：开发策略之一，选择是否将具体开发任务交给子 agent 执行（当前会话持续开发 vs subagent）。
• worktree：开发策略之一，选择在当前分支直接开发还是使用独立的 worktree（工作树）进行隔离开发。
• TDD：开发策略之一，选择走 Trellis 默认开发流程还是测试驱动开发（TDD）流程。
• trellis-spec-review：在 trellis-check 之后，二次检查 spec 是否执行完毕、是否有遗漏。
• trellis-code-review：代码质量审查，确保代码合格。
• trellis-code-architecture-review：代码架构审查，确保修改或新增代码不污染现有架构，拒绝“屎山”代码。
• trellis-improve-codebase-architecture：代码深层架构分析师，二次检查修改或新增代码是否污染现有架构，可选。
• trellis-merge-review：分支合并前对合并后的分支做最终质量检查，可选。

安装命令（二选一）：

# 安装最新版 trellis-hgl（beta）
npm install -g trellis-hgl@beta
# 安装正式版
npm install -g trellis-hgl@latest

之后进入项目目录，对已初始化过的项目执行 trellis update，新项目执行 trellis init -u yourname --claude。

卸载命令：

npm uninstall -g trellis-hgl

项目经历了多个版本迭代（v0.6.0-beta.24、v0.6.0-beta.26、v0.6.0-beta.29），关键变更包括：

• v0.6.0-beta.24：将 trellis-check、trellis-spec-review、trellis-code-review、trellis-code-architecture-review 调整为只读审查/建议型审查，仅反馈问题，由主 Agent 根据用户之前选择的开发策略（是否调用 subagent、是否在 worktree 修复、是否用 TDD 流程）去修复；新增 trellis-switch 开关，可控制是否开启 Trellis 流程（关闭/打开）。
• v0.6.0-beta.26：将 trellis-spec-review、trellis-code-review、trellis-code-architecture-review、trellis-improve-codebase-architecture、trellis-merge-review 全部设为可选，并并入开发策略。
• v0.6.0-beta.29：worktree 路径从 ./.claude/worktree 改为 ./.trellis/trellis-worktrees/<对应任务名>。

关键要点

• Trellis-Herbivore 是在 Trellis 0.6.0-beta.17 基础上针对 Claude Code 单工具工作流做的定向增强，所有新增策略均为可选。
• 工作流从用户自然语言需求开始，经过 brainstorm、grill-me（追问细节）、开发策略决策、implement、check、多轮 review、merge-review，最终存档，形成闭环。
• 开发策略包含三个维度：当前会话 vs subagent、当前分支 vs worktree、默认流程 vs TDD，用户在每个维度均可选择。
• 新增的审查模块（spec-review、code-review、code-architecture-review、improve-codebase-architecture、merge-review）在 v0.6.0-beta.24 后变为只读审查（仅反馈问题），修复工作由主 Agent 依据用户选择的策略执行；在后续版本中全部成为可选。
• v0.6.0-beta.24 新增 trellis-switch 命令，可随时开启或关闭 Trellis 流程，方便灵活使用。
• worktree 路径在 v0.6.0-beta.29 中统一到 .trellis/trellis-worktrees/ 目录下，按任务名组织，便于管理。
• 安装和更新都通过 npm 全局包 trellis-hgl 完成，需在项目目录中执行 trellis update 或 trellis init。
• 项目遵循开源推广要求，完整开源，无未开源部分，并已链接认可 LINUX DO 社区。

意义与影响

Trellis-Herbivore 将 AI 辅助编码从单一的命令执行提升为可定制、多阶段、质量门控的工程化工作流。其意义在于：

• 降低手动决策负担：用户只需以自然语言表达需求，系统会自动决策是否创建任务、追问细节、选择开发策略，并串联多轮审查，减少了开发者在琐碎流程上的精力消耗。
• 提升代码质量与架构一致性：通过多层次的代码审查和架构分析，阻止低质量代码或架构污染进入主分支，尤其适合多人协作或长期维护的项目。
• 适应不同开发风格：subagent、worktree、TDD 等可选策略让工作流能适配从快速原型到严格质量控制的多种场景，兼顾效率与规范性。
• 推动 AI 开发工具标准化：此类魔改工作流展示了如何通过开源社区迭代，将 LLM 辅助编程从“提示词技巧”转向“可复用的工程工具”，可能启发更多针对 Cursor、Copilot 等工具的类似实践。
• 影响开发者生态：项目在 LINUX DO 社区发布并获得 27 位参与者讨论，说明社区对结构化 AI 工作流有真实需求；未来可能衍生出更多基于 Claude Code 的定制化工作流框架。