repo: https://github.com/mindfold-ai/Trellis doc: https://docs.trytrellis.app/zh/

将 .agents/skills/ 解耦为共享 Agent Skills 层，新增完整的 .codex/ 目录支持（ hooks 、平台专属 skills 、自定义 agents ）。

https://docs.trytrellis.app/zh/changelog/v0.4.0-beta.8

新功能

• 共享 Agent Skills 层：.agents/skills/ 现在是遵循 agentskills.io 开放标准的共享目录，不再绑定 Codex 平台。所有 universal agent CLI （ Codex 、Kimi CLI 、Amp 、Cline 等）都可以读取这些 skills
• Codex .codex/ 目录：新增平台专属目录结构：
  • .codex/config.toml — 项目级 Codex 配置
  • .codex/agents/ — 自定义 Codex agents （ implement 、research 、check ）
  • .codex/skills/ — Codex 专属 skills （如带 --platform codex 的 parallel）
  • .codex/hooks/session-start.py + hooks.json — SessionStart hook ，注入完整 Trellis 上下文（工作流、指南、任务状态）
• Codex SessionStart Hook：自动将 Trellis 工作流、指南和任务上下文注入 Codex 会话。需要在 ~/.codex/config.toml 中设置 codex_hooks = true（ Codex 实验性功能）
• 会话分支上下文：会话日志现在包含 git 分支信息 (#108)

修复

• iFlow CLI 适配器：回退了 PR #112 中错误的 --agent flag 改动。iFlow 使用 $agent_name 前缀格式
• Codex agent TOML 格式：修正为正确字段（name、description、developer_instructions、sandbox_mode）

迁移

• 自动：旧 Codex 用户（有 .agents/skills/ 但无 .codex/）在 trellis update 时自动检测并升级
• safe-file-delete：.agents/skills/parallel/SKILL.md（移至 .codex/skills/）、旧 trellis-*.toml agent 文件（已重命名）
• 运行 trellis update 应用所有变更

破坏性变更

• 平台检测：仅 .agents/skills/ 不再检测为 Codex ，需要 .codex/ 目录
• configDir：Codex configDir 从 .agents/skills 改为 .codex

说明

• Codex hooks 需要在 ~/.codex/config.toml 中启用 features.codex_hooks = true
• Codex hooks 的 suppressOutput 尚未生效（ Codex 实验性限制 — context 仍会在 TUI 中打印）
• parallel skill 从共享的 .agents/skills/ 移至 Codex 专属的 .codex/skills/，因为包含 --platform codex

https://docs.trytrellis.app/zh/changelog/v0.4.0-beta.8

（另外 codex hook 本身就有点问题，注入的东西会自动显示，没法关闭）