> ## Documentation Index
> Fetch the complete documentation index at: https://docs.trytrellis.app/llms.txt
> Use this file to discover all available pages before exploring further.

# v0.4.0-beta.8

> 2026-03-24

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

## 新功能

* **共享 Agent Skills 层**：`.agents/skills/` 现在是遵循 [agentskills.io](https://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` 的 `[features]` 下设置 `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`