[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"project-81391":3},{"id":4,"name":5,"fullName":6,"owner":7,"repo":5,"description":8,"homepage":9,"htmlUrl":9,"language":10,"languages":9,"totalLinesOfCode":9,"stars":11,"forks":12,"watchers":13,"openIssues":14,"contributorsCount":14,"subscribersCount":14,"size":14,"stars1d":15,"stars7d":16,"stars30d":17,"stars90d":14,"forks30d":14,"starsTrendScore":18,"compositeScore":19,"rankGlobal":9,"rankLanguage":9,"license":20,"archived":21,"fork":21,"defaultBranch":22,"hasWiki":23,"hasPages":21,"topics":24,"createdAt":9,"pushedAt":9,"updatedAt":25,"readmeContent":26,"aiSummary":27,"trendingCount":14,"starSnapshotCount":14,"syncStatus":15,"lastSyncTime":28,"discoverSource":29},81391,"Trellis-Herbivore","LonelyHerbivore\u002FTrellis-Herbivore","LonelyHerbivore","Trellis-Meta",null,"TypeScript",62,9,37,0,2,10,25,8,54.5,"GNU Affero General Public License v3.0",false,"main",true,[],"2026-06-12 04:01:33","\u003Cp align=\"center\">\n\u003Cpicture>\n\u003Csource srcset=\"assets\u002Ftrellis.png\" media=\"(prefers-color-scheme: dark)\">\n\u003Csource srcset=\"assets\u002Ftrellis.png\" media=\"(prefers-color-scheme: light)\">\n\u003Cimg src=\"assets\u002Ftrellis.png\" alt=\"Trellis Logo\" width=\"500\" style=\"image-rendering: -webkit-optimize-contrast; image-rendering: crisp-edges;\">\n\u003C\u002Fpicture>\n\u003C\u002Fp>\n\n\u003Cp align=\"center\">\n\u003Cstrong>面向 Claude Code 的 Trellis 魔改工作流\u003C\u002Fstrong>\u003Cbr\u002F>\n\u003Csub>把需求对齐、任务规划、开发策略、实现门禁、架构收敛和会话记忆落到仓库文件里，而不是塞进一段越来越长的系统提示词。\u003C\u002Fsub>\n\u003C\u002Fp>\n\n\u003Cp align=\"center\">\n\u003Ca href=\".\u002FREADME_CN.md\">原中文版\u003C\u002Fa> •\n\u003Ca href=\"https:\u002F\u002Fdocs.trytrellis.app\u002Fzh\">官方文档\u003C\u002Fa> •\n\u003Ca href=\"#快速开始\">快速开始\u003C\u002Fa> •\n\u003Ca href=\"#工作流总览\">工作流总览\u003C\u002Fa> •\n\u003Ca href=\"#目录结构\">目录结构\u003C\u002Fa> •\n\u003Ca href=\"https:\u002F\u002Flinux.do\">LinuxDo\u003C\u002Fa>\n\u003C\u002Fp>\n\n\u003Cp align=\"center\">\n\u003Ca href=\"https:\u002F\u002Fwww.npmjs.com\u002Fpackage\u002Ftrellis-hgl\">\u003Cimg src=\"https:\u002F\u002Fimg.shields.io\u002Fnpm\u002Fv\u002Ftrellis-hgl.svg?style=flat-square&color=2563eb\" alt=\"npm version\" \u002F>\u003C\u002Fa>\n\u003Ca href=\"https:\u002F\u002Fwww.npmjs.com\u002Fpackage\u002Ftrellis-hgl\">\u003Cimg src=\"https:\u002F\u002Fimg.shields.io\u002Fnpm\u002Fdw\u002Ftrellis-hgl?style=flat-square&color=cb3837&label=downloads\" alt=\"npm downloads\" \u002F>\u003C\u002Fa>\n\u003Ca href=\"https:\u002F\u002Fgithub.com\u002FLonelyHerbivore\u002FTrellis-Herbivore\u002Fblob\u002Fmain\u002FLICENSE\">\u003Cimg src=\"https:\u002F\u002Fimg.shields.io\u002Fbadge\u002Flicense-AGPL--3.0-16a34a.svg?style=flat-square\" alt=\"license\" \u002F>\u003C\u002Fa>\n\u003Ca href=\"https:\u002F\u002Flinux.do\">\u003Cimg src=\"https:\u002F\u002Fimg.shields.io\u002Fbadge\u002FLINUX-DO-FFB003.svg?style=flat-square\" alt=\"LinuxDo\" \u002F>\u003C\u002Fa>\n\u003C\u002Fp>\n\n\u003Cp align=\"center\">\n\u003Cimg src=\"assets\u002Fworkflow.png\" alt=\"Trellis 魔改工作流示意图\" width=\"100%\">\n\u003C\u002Fp>\n\n## 这是什么\n\n这个分支不是在重新发明一个新的 AI coding 工具，而是在 `Trellis-0.6.0-beta.17` 的基础上，针对 **Claude Code 单工具工作流** 做定向增强：\n\n- 保留 Trellis 原有的 `init`、任务系统、Spec 系统、workspace 记忆、平台接入与 npm 发布能力\n- 把需求对齐、开发策略决策、多重 review gate、架构约束和最终收尾流程进一步前置、显式化\n- 强调“**先规划，再实现；先对齐，再放行**”\n- 尽量让真正重要的过程信息沉淀到仓库文件，而不是散落在聊天上下文里\n\n一句话说，这个分支想把 Trellis 调整成更适合 **自然语言驱动 + Claude Code 主导 + 中文文档可审阅** 的工程化工作流。\n\n## 为什么要做这个魔改\n\n这个分支的目标很明确：\n\n1. **只做加法，不做减法**\n   - 保留 Trellis 现有能力\n   - 在其上融入更强的需求对齐、策略决策和质量门禁\n\n2. **把“如何和 AI 协作开发”变成明确流程**\n   - 不是用户一句“去做吧”，AI 就直接写代码\n   - 而是先进入任务、PRD、brainstorm、grill、策略决策，再进入实现\n\n3. **让开发策略本身成为任务文档的一部分**\n   - 当前会话直做，还是 subagent\n   - 当前分支直改，还是 worktree\n   - 默认流程，还是 TDD\n   - 这次任务要不要启用 `trellis-spec-review`、`trellis-code-review`、`trellis-code-architecture-review`、`trellis-improve-codebase-architecture`、`trellis-merge-review`\n\n4. **把 AI 容易忽略的工程门禁变成显式节点**\n   - 固定保留：`trellis-check`\n   - 任务级可选：`trellis-spec-review`\n   - 任务级可选：`trellis-code-review`\n   - 任务级可选：`trellis-code-architecture-review`\n   - 任务级可选：`trellis-improve-codebase-architecture`\n   - 任务级可选：`trellis-merge-review`\n   - 最终 build\u002Ftest 继续保留\n  \n5. **随时可跳出Trellis流程**\n   - 随时都可以直接对Claude说: \"当前任务直接存档\"，即可跳出工作流直接结束任务\n\n## 核心理念\n\n### 1. Spec 是注入的，不是靠记忆的\n\n项目规范写进 `.trellis\u002Fspec\u002F` 之后，AI 不需要在每次会话里重新听一遍“这个仓库怎么做事”，而是按任务、按阶段加载真正相关的部分。\n\n### 2. 任务是工作流载体，不只是待办项\n\n在这个分支里，任务目录不只是记录状态，还承载：\n\n- `prd.md`：需求与验收标准\n- `design.md`：复杂任务的技术设计\n- `implement.md`：实现策略、review gate、验证与回滚点\n- `implement.jsonl` \u002F `check.jsonl`：给 implement \u002F check agent 装配上下文\n\n### 3. 需求对齐与开发策略必须显式落盘\n\n这里最强调的一点是：\n\n- `trellis-brainstorm` 不等于需求已经收敛\n- `trellis-grill-me` 不等于开发策略已经确定\n- `task.py start` 之前，必须把关键决策写进任务文档\n\n### 4. Review gate 不是一次性“跑个检查”\n\n这个分支把质量控制拆成几层：\n\n- 固定检查：`trellis-check`\n- 任务级可选 gate：\n  - `trellis-spec-review`\n  - `trellis-code-review`\n  - `trellis-code-architecture-review`\n  - `trellis-improve-codebase-architecture`\n  - `trellis-merge-review`\n- 其中 `trellis-spec-review` → `trellis-code-review` → `trellis-code-architecture-review` 一旦启用，仍保持这个顺序\n- 对新任务，这 5 个可选 gate 默认全关；对老任务，若任务文档没有选择记录，则沿用旧行为\n- 最终 `build\u002Ftest` 继续保留\n\n## 工作流总览\n\n更贴近这个本地分支真实意图的一条主线是：\n\n```text\n用户自然语言提出需求\n→ 判断是否需要创建 Trellis 任务\n→ task.py create\n→ trellis-brainstorm\n→ trellis-grill-me\n→ 开发策略决策（同一选项块里确定 subagent\u002Fworktree\u002FTDD\u002Freview gates）\n→ （按需）trellis-improve-codebase-architecture guidance\n→ task.py start\n→ trellis-implement\n→ trellis-check\n→ （按任务选择）trellis-spec-review\n→ （按任务选择）trellis-code-review\n→ （按任务选择）trellis-code-architecture-review\n→ （按任务选择）trellis-improve-codebase-architecture deep-review\n→ trellis-update-spec\n→ 提交代码\n→ 主 agent 合并\n→ （按任务选择）trellis-merge-review\n→ build\u002Ftest\n→ \u002Ftrellis:finish-work\n```\n\n### 开发策略决策包含什么\n\n进入实现前，至少要明确五项：\n\n1. 当前会话持续开发，还是 subagent\n2. 当前分支直接开发，还是 worktree\n3. 走 Trellis 默认开发流程，还是 TDD\n4. 这次任务要启用哪些 review gate（5 个可选 gate 必须落盘为 `Review-gate contract: explicit-selection-v1` + `Optional review gates status: configured` + enabled\u002Fdisabled 列表；就算 5 个都不启用，也要显式写进 disabled，`trellis-check` 固定保留）\n5. 是否在进入实现前运行 `trellis-improve-codebase-architecture guidance`（这不会隐式开启 deep-review；后者仍需在 review gate 里显式选择，而且 deep-review 依赖 `trellis-code-architecture-review`）\n\n如果选择 `subagent + worktree`，本分支约定所有代码开发子代理固定使用同一个路径：\n\n```text\n.\u002F.claude\u002Fworktree\n```\n\n这样可以避免多个 worktree 上重复实现同一个任务，浪费上下文和 token。\n\n### 为什么要有 `trellis-improve-codebase-architecture`\n\n这个 skill 不是普通 code review 的别名，它在这个分支里承担两种不同职责：\n\n1. **guidance（开发前指导）**\n   - 放在 `task.py start` 之前\n   - 针对架构敏感任务，先给边界、抽象与风险建议\n   - 结果追加到 `design.md`\n\n2. **deep-review（深度审查）**\n   - 放在 `trellis-code-architecture-review` 之后\n   - 作为额外的结构性深审\n   - 如果失败，要打回实现并重走 review 流程\n\n因此，它不能被 `trellis-code-architecture-review` 隐含覆盖。\n\n## 目录结构\n\n```text\n.trellis\u002F\n├── spec\u002F                    # 项目规范、模式和指南（按 package\u002Flayer 组织）\n├── tasks\u002F                   # 任务 PRD、设计、实现计划、状态与上下文\n├── workspace\u002F               # Journal 和开发者级连续性\n├── workflow.md              # 三阶段工作流与 breadcrumb 真相源\n└── scripts\u002F                 # 驱动任务、上下文与收尾流程的脚本\n```\n\n除此之外，Trellis 还会根据平台生成接入文件，例如：\n\n- `.claude\u002F`\n- `.cursor\u002F`\n- `.codex\u002F`\n- `.agents\u002F`\n- `AGENTS.md`\n\n但对这个分支来说，**主要关注点默认是 Claude Code**。\n\n## Claude Code 下的自动注入\n\n以当前根目录 `Trellis-0.6.0-beta.17` 为例，自动注入主要看这 3 个文件：\n\n1. `.claude\u002Fhooks\u002Fsession-start.py`\n   - 触发时机：`startup`、`clear`、`compact`\n   - 注入内容：`\u003Csession-context>`、`\u003Cfirst-reply-notice>`、`\u003Ccurrent-state>`、`\u003Ctrellis-workflow>`、`\u003Cguidelines>`、`\u003Ctask-status>`、`\u003Cready>`\n   - 作用：开场先把仓库状态、任务状态和 workflow 摘要喂给主会话\n\n2. `.claude\u002Fhooks\u002Finject-workflow-state.py`\n   - 触发时机：每次用户提交消息前（`UserPromptSubmit`）\n   - 注入内容：简短的 `\u003Cworkflow-state>`\n   - 作用：提示当前 task 状态和下一步该走的 workflow\n\n3. `.claude\u002Fhooks\u002Finject-subagent-context.py`\n   - 触发时机：调用 `Task` \u002F `Agent` 子代理前（`PreToolUse`）\n   - 注入内容：`implement.jsonl`、`check.jsonl`、`prd.md`、`design.md`、`implement.md`\n   - 作用：把任务文档自动拼进 implement \u002F check \u002F research 子代理的 prompt\n\n一句话：**开头看全局，发言前看状态，调子代理前看任务文件。**\n\n## 快速开始\n\n### 前置要求\n\n- **Node.js** >= 18\n- **Python** >= 3.9\n\n### 安装\n\n```bash\nnpm install -g trellis-hgl@beta\n```\n\n### 卸载\n\n```bash\nnpm uninstall -g trellis-hgl\n```\n\n### 替换原版trellis\n\n```bash\n# 卸载旧版 trellis\nnpm uninstall -g @mindfoldhq\u002Ftrellis\n\n# 安装最新版 trellis-hgl\nnpm install -g trellis-hgl@beta\n\n# 进入你自己的项目目录\ncd \u002Fpath\u002Fto\u002Fyour\u002Fproject\n\n# 已经初始化过的项目，执行更新（按需选择文件是否OverWrite）\ntrellis update\n\n# 第一次使用的项目，执行初始化\ntrellis init -u yourname --claude\n```\n\n### 初始化仓库\n\n```bash\n# 创建开发者 workspace\ntrellis init -u your-name --claude\n```\n\n如果你需要按平台生成接入文件，也可以组合初始化参数；但这个分支的默认关注点是 Claude Code 路径。\n\n### 第一次使用\n\n更符合这个分支预期的使用方式是：\n\n1. 在项目里完成 `trellis init`\n2. 用自然语言告诉 Claude Code 你的需求\n3. 让 Claude 根据 workflow 先进入任务与 planning\n4. 在 planning 完整之后再进入实现\n\n也就是说，推荐心智模型不是“先找命令再操作”，而是：\n\n> **先用自然语言发起需求，后台再由 Trellis 把需求变成任务、产物和流程。**\n\n## 适合什么场景\n\n### 1. 希望 AI 不要一上来就写代码\n\n如果你更在意先对齐需求、先收敛边界、先确定实现策略，这个分支会更适合你。\n\n### 2. 希望把开发策略也纳入规范\n\n很多团队会规定代码风格，但不会规定“什么时候用 subagent、什么时候上 worktree、什么时候切到 TDD”。这个分支专门把这些决策前置到 planning 阶段。\n\n### 3. 希望让质量门禁更难被跳过\n\n它不是只跑一次检查，而是把实现后检查、正式 review gate、架构深审、merge review 和最终 build\u002Ftest 分层表达出来。\n\n### 4. 希望文档和任务产物可以用中文审阅\n\n这个分支强调规划文档、任务文档、流程文档和说明性产物默认用中文写，方便直接 review。\n\n## 与原版 Trellis 的关系\n\n这个分支依然保留 Trellis 作为“团队 AI coding harness”的核心结构：\n\n- `.trellis\u002Fspec\u002F`\n- `.trellis\u002Ftasks\u002F`\n- `.trellis\u002Fworkspace\u002F`\n- `.trellis\u002Fworkflow.md`\n- 各平台适配层\n\n区别在于，它把下面这些能力进一步拉高为一等公民：\n\n- `trellis-grill-me`\n- 开发策略决策\n- `trellis-improve-codebase-architecture`\n- 多重 review gate\n- merge 后再验证\n- 中文产物优先\n\n## 进一步了解\n\n如果你想继续理解这个分支，建议按这个顺序看：\n\n1. `.trellis\u002Fworkflow.md`\n2. `CLAUDE.md`\n3. `packages\u002Fcli\u002Fsrc\u002Ftemplates\u002Ftrellis\u002Fworkflow.md`\n4. `packages\u002Fcli\u002Fsrc\u002Fconfigurators\u002F`\n5. `packages\u002Fcli\u002Fsrc\u002Fcommands\u002F`\n\n其中：\n\n- `.trellis\u002Fworkflow.md` 更接近当前本地运行状态\n- `packages\u002Fcli\u002Fsrc\u002Ftemplates\u002Ftrellis\u002Fworkflow.md` 更接近模板真相源和后续生成逻辑\n- `packages\u002Fcli\u002Fsrc\u002Fconfigurators\u002F` 与 `packages\u002Fcli\u002Fsrc\u002Fcommands\u002F` 适合继续追踪初始化、模板生成和命令入口\n\n## 社区与资源\n\n- [官方文档](https:\u002F\u002Fdocs.trytrellis.app\u002Fzh)\n- [快速开始](https:\u002F\u002Fdocs.trytrellis.app\u002Fzh\u002Fguide\u002Fch02-quick-start)\n- [支持平台](https:\u002F\u002Fdocs.trytrellis.app\u002Fzh\u002Fguide\u002Fch13-multi-platform)\n- [使用场景](https:\u002F\u002Fdocs.trytrellis.app\u002Fzh\u002Fguide\u002Fch08-real-world)\n- [更新日志](https:\u002F\u002Fdocs.trytrellis.app\u002Fzh\u002Fchangelog\u002Fv0.3.6)\n- [GitHub Issues](https:\u002F\u002Fgithub.com\u002FLonelyHerbivore\u002FTrellis-Herbivore\u002Fissues)\n\n\u003Cp align=\"center\">\n\u003Ca href=\"https:\u002F\u002Fgithub.com\u002FLonelyHerbivore\u002FTrellis-Herbivore\">当前发布仓库\u003C\u002Fa> •\n\u003Ca href=\"https:\u002F\u002Fgithub.com\u002FLonelyHerbivore\u002FTrellis-Herbivore\u002Fblob\u002Fmain\u002FLICENSE\">AGPL-3.0 License\u003C\u002Fa>\n\u003C\u002Fp>\n","Trellis-Herbivore 是一个面向 Claude Code 的工作流优化项目，基于 Trellis 并针对中文文档可审阅的工程化协作进行了定向增强。该项目保留了 Trellis 原有的初始化、任务系统、Spec 系统、workspace 记忆等功能，并新增了需求对齐、开发策略决策、多重 review gate 和架构约束等特性。这些功能旨在将开发过程中的重要信息沉淀到仓库文件中，而不是散落在聊天记录里，从而实现“先规划，再实现；先对齐，再放行”的原则。适用于需要自然语言驱动且由 AI 主导的软件开发场景，特别适合那些希望提高代码质量和团队协作效率的开发者。","2026-06-11 04:04:52","CREATED_QUERY"]