Trellis（mindfold-ai/trellis）
开箱即用的 AI coding 工程框架（官方 slogan “The best agent harness”）。解决的核心问题：AI 写代码快但每个 session 从零开始——不记得项目、约定和团队需求。Trellis 把 spec、task、memory 持久化进仓库，让任何 coding agent 按团队工程标准干活。
- npm 包：
@mindfoldhq/trellis（CLI）+@mindfoldhq/trellis-core - TypeScript + pnpm monorepo，AGPL-3.0，脚本层用 Python（要求 Node ≥ 18 / Python ≥ 3.9）
- 13,695 stars（2026-08-06 查询），2026-01 创建，持续活跃
- 文档站：https://docs.trytrellis.app
与 CLAUDE.md / AGENTS.md / .cursorrules 的区别
官方 FAQ：那些文件容易变成 monolithic 大杂烩；Trellis 在它们之上加了 scoped specs（按包/层分域）+ task PRD + workflow gates + workspace memory + 按平台生成的适配文件。Trellis init 时会接管/生成这些入口文件（TRELLIS:START/END 块内内容可被 trellis update 覆写，块外内容保留）。
核心结构：.trellis/
| 目录/文件 | 职责 |
|---|---|
spec/ | 按 <package>/<layer>/index.md 组织的编码规范，入口含 Pre-Development Checklist + Quality Check；spec 通过 hook/skill 注入而非靠 agent 记住（“Specs injected, not remembered”） |
tasks/{MM-DD-name}/ | 每任务一目录：task.json + prd.md + 可选 design.md/research/ + 上下文清单 implement.jsonl/check.jsonl（声明注入给子 Agent 的 spec/research 文件） |
workspace/<dev-name>/ | 每开发者独立 journal + session trace（个人数据与共享 spec/task 分离，避免团队冲突），journal 2000 行自动轮转，可自动 git commit |
workflow.md | 开发阶段定义、何时建任务、skill 路由 |
config.yaml | 项目级配置：monorepo packages、task 生命周期 hooks、channel worker guard、context 注入上限、Codex dispatch 模式等 |
scripts/ | Python 辅助脚本（task.py/get_context.py/init_developer.py 等），保证无 skill 平台也能用 |
四阶段工作流（自动调用 skills + sub-agents）
- Plan —
trellis-brainstorm一次一个问题澄清需求 →prd.md；研究类工作派给trellis-research子 Agent；产出被整理进implement.jsonl/check.jsonl - Implement —
trellis-implement子 Agent 按 PRD + 注入的 curated context 写代码（不 git commit） - Verify —
trellis-check子 Agent 对照 spec 审 diff，跑 lint/type-check/tests，能自修则自修 - Finish —
/trellis:finish-work收尾：最终检查 + 归档任务 + 更新 journal，trellis-update-spec把新学到的约定回写.trellis/spec/（下次会话更聪明）
五大核心原则：Plan before code / Specs injected not remembered / Persist everything（对话会压缩，文件不会）/ 一次一个任务 / 任务后回写学习。
多平台：22 个 configurators
trellis init --cursor --opencode --codex ... 按所用平台生成适配文件。内置适配器：Claude Code、Codex、Cursor、OpenCode、Gemini、Copilot、Kimi、Kiro、Devin、Droid（Factory）、Qoder、Trae、Grok、Kilo、Pi、OpenCode（omp）、Antigravity、CodeBuddy、Reasonix、Snow、ZCode 等。每个平台目录（.claude//.codex//.cursor/ 等）含各自的 skills/agents/hooks/commands。
平台差异适配示例：
- Codex：
dispatch_mode可选 auto（派发 trellis-* 子 Agent）或 inline（主会话内执行）；可在生成的.codex/agents/trellis-*.toml里给子 Agent pin 更便宜的模型，trellis update保留手改 - 上下文注入限流：单文件 32KB / 单 artifact 64KB / 总 payload 128KB，超限降级为索引行（path + reason + size）
- 逃生门：用户消息含
no-trellis单词时当轮跳过 workflow breadcrumb 注入
Channel 系统（多 Agent 编排）
trellis channel 提供常驻 worker 式多 Agent 能力：spawn/send/run/messages/threads/forum/supervisor/wait/kill/interrupt，带 OOM 防护（idle timeout 清理 + max_live_workers 预算），支持 thread/forum 组织长对话。配合 trellis mem 的 session/dialogue/phase/search 记忆管理。
快速开始
npm install -g @mindfoldhq/trellis@latest
trellis init -u your-name
# 或按实际平台初始化
trellis init --cursor --opencode --codex -u your-name适用场景与定位
- 个人开发者：跨会话记忆 + 可重复工作流
- 团队（更大收益）：共享标准入仓库可 review、任务边界清晰、跨平台可移植（同一套
.trellis/结构带到 22 个平台，不用按工具重建工作流） - 与同类对照：思路类似 superpowers（强制工程纪律的 Skill 集）和 ecc（harness 原生优化系统），但 Trellis 更偏”项目层持久化结构 + 多平台生成器”，本体是 CLI 而非 Skill 包
资源
- GitHub：https://github.com/mindfold-ai/trellis
- 文档：https://docs.trytrellis.app
- Quick Start：https://docs.trytrellis.app/start/install-and-first-task
- 多平台支持：https://docs.trytrellis.app/advanced/multi-platform
- Spec 模板库：https://docs.trytrellis.app/templates/specs-index
- DeepWiki：https://deepwiki.com/mindfold-ai/Trellis