> ## 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.10

> 2026-04-09

Ralph Loop 字段名修复（P0）、迁移任务 assignee 解析修复，以及任务生命周期文档补齐。

## 修复

* **Ralph Loop 字段名修复 (#152)**：SubagentStop hook 之前读取的字段（`subagent_type`、`agent_output`、`prompt`）都不在 Claude Code 的实际事件 schema 中，应该是 `agent_type` 和 `last_assistant_message`。导致 **Ralph Loop 自发布以来对所有用户都是静默失效的**。本次修复后，check/implement/debug 子 agent 将按文档预期触发循环控制。感谢 @suyuan2022 发现并定位。
* **迁移任务 assignee 解析修复 (#153)**：`trellis update --migrate` 创建迁移任务时，原先把 `.trellis/.developer` 文件当普通字符串读取，直接把整个 `name=...\ninitialized_at=...` 文件内容塞进 `assignee` 字段。时间戳随后在 `session-start.py` 渲染时泄漏，破坏了 ACTIVE TASKS 的排版。现在会正确解析 `name=` 一行。感谢 @suyuan2022 的修复。

## 文档

* **任务生命周期命令**：`workflow.md` 现在正式记录了 `task.py start <name>` 和 `task.py finish` — 这两个子命令虽然已经在 argparse 中注册，但之前完全没有在工作流指南中出现，导致 AI agent 从来不知道要调用它们，`## CURRENT TASK` 长期显示 `(none)`。Task Development Flow 从 5 步扩展为 7 步，显式加入 Start（第 2 步）和 Finish（第 7 步），并新增"Current task mechanism"段落说明 `.current-task` 如何驱动 SessionStart hook 注入。

## 说明

* 运行 `trellis update` 同步所有变更
* **行为变化**：Ralph Loop 现在会真正触发 check/implement/debug 子 agent 的循环控制。如果此前你无意中依赖了它"安静失效"的行为，升级后请留意新的循环活动。