docs: research - add trellis domain

2026-08-20 06:18:05 +00:00 · 2026-07-04 07:13:59 +08:00
parent 332350ca54
commit 663e331cf2
24 changed files with 1393 additions and 14 deletions
@@ -0,0 +1,73 @@
+# mindfold-ai/Trellis 研究域
+
+## 字多不看
+
+- 本目录研究 `mindfold-ai/Trellis` 这个外部仓库。
+- 当前优先级：P1；研究角色：跨平台 Agent Harness 框架、CLI 与任务/规格/记忆系统。
+- GitHub 动态事实放在 `domain.yml`，观测日期为 2026-07-04。
+- 它最值得迁移的不是 AGPL 代码，而是把任务、规格、记忆、验证和多平台适配沉淀为仓库控制面的机制。
+
+## 快速导航
+
+| 文档 | 定位 |
+|:---|:---|
+| [domain.yml](domain.yml) | 仓库事实快照、研究方向、优先级和来源证据。 |
+| [analysis.md](analysis.md) | 本研究域的结构化研究结果、可迁移做法、风险和验证动作。 |
+| [deep-dive.md](deep-dive.md) | L2 结构深度研究、关键机制和对本仓 Harness 体系的应用建议。 |
+| [AGENTS.md](AGENTS.md) | 本研究域维护规则。 |
+
+<details>
+<summary><strong>完整细粒度目录（点击展开/收起）</strong></summary>
+
+### 细粒度目录
+
+- [domain.yml](domain.yml) - 仓库事实快照、研究方向、优先级和来源证据。
+- [analysis.md](analysis.md) - 本研究域的结构化研究结果、可迁移做法、风险和验证动作。
+- [deep-dive.md](deep-dive.md) - L2 结构深度研究、关键机制和对本仓 Harness 体系的应用建议。
+- [AGENTS.md](AGENTS.md) - 本研究域维护规则。
+
+</details>
+
+## 使用方式
+
+- 先读本 README 的判断，再读 `analysis.md` 和 `deep-dive.md` 的研究结论，最后读 `domain.yml`。
+- 需要引用 stars、forks、release、归档状态、主页或主题标签时，先重新核验 GitHub。
+- 需要更新原始事实时，运行 `python3 scripts/fetch-research-raw.py mindfold-ai-trellis`。
+- 如果形成稳定方法论，再下沉到 `docs/research/harness/`、`docs/workflow/`、`scripts/` 或 `skills/`。
+
+## 正文
+
+### 研究定位
+
+`mindfold-ai/Trellis` 的当前研究定位是：跨平台 Agent Harness 框架、CLI 与任务/规格/记忆系统。
+
+### 当前判断
+
+Trellis 是本仓 Harness 研究线的 P1 样本。它不是把 `AGENTS.md`、`CLAUDE.md` 或规则文件再包一层，
+而是把 AI 编程过程做成仓库内可运行控制面：
+
+- 用 `.trellis/spec/` 保存团队约束，让 Agent 通过任务上下文加载规则，而不是靠模型记忆。
+- 用 `.trellis/tasks/` 保存 `prd.md`、`design.md`、`implement.md`、`implement.jsonl` 和 `check.jsonl`。
+- 用 `.trellis/workflow.md` 保存状态机和每轮注入的 breadcrumb，约束从计划、执行到收尾的相位。
+- 用 `.trellis/workspace/` 保存开发者会话记录，解决跨会话恢复和团队共享问题。
+- 用 CLI 同时生成 Claude Code、Codex、Cursor、OpenCode、Gemini、Kiro、Qoder、Copilot 等平台适配层。
+- 用 `channel`、`mem`、`task` 等核心原语把多 Agent 协作、会话检索和任务记录从文档推进到 runtime。
+
+对本仓最有价值的点是：把“AI 协作经验”进一步升级为“可注入、可验证、可迁移、可升级的控制面”。
+经验句子容易被遗忘；任务、规格、上下文清单、状态机和验证命令能被下一轮 Agent 继续执行。
+
+### 观察字段
+
+- GitHub URL：https://github.com/mindfold-ai/Trellis
+- 当前研究方向：`agent-harness-framework`
+- 当前优先级：P1
+- 当前归档状态：`false`
+- 主要语言：`TypeScript`
+
+### 后续观察
+
+- `channel` runtime 是否继续成熟为通用多 Agent 协作层。
+- `mem` 是否从多平台会话检索扩展为更强的长期项目记忆。
+- Codex、Copilot、Gemini 等 pull-based 平台的上下文注入方式是否继续收敛。
+- `.trellis/spec/`、`.trellis/tasks/`、`.trellis/workflow.md` 的状态契约是否能稳定支撑团队协作。
+- AGPL-3.0 许可证边界下，哪些机制可借鉴、哪些代码和模板不能直接搬入本仓。