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

​
新功能

  • 共享 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