TauriTavern/docs/Agent/README.md

TauriTavern Agent Detail Docs

本目录保存 Agent 框架的细节设计文档。高层入口仍保留在 docs/ 根目录：

1. docs/AgentArchitecture.md：系统边界、分层、数据流。
2. docs/AgentContract.md：不可破坏的不变量与 fail-fast 约束。
3. docs/AgentImplementPlan.md：当前实施基线、下一步计划与验收命令。

细节文档

文档	内容
Workspace.md	Workspace、Artifact、Checkpoint、commit/rollback 语义
RunEventJournal.md	Run Event、状态机、订阅、恢复、取消与审批
ProfilesAndPreset.md	Agent Profile、Preset agent schema、ContextFrame、Plan Policy
PromptAssembly.md	Agent 独立 Preset / 独立 Model、FrozenRunInputSnapshot 与前后端 prompt assembly 链路
ToolSystem.md	ToolSpec、ToolResult、Tool Registry、Policy、审批与 Legacy ToolManager 边界
SubAgent.md	return-mode SubAgent、AgentInvocation / AgentTask、Agent-friendly workspace view 与开发定位
LlmGateway.md	provider-agnostic LLM gateway 与现有 ChatCompletionService 的复用边界
McpSkill.md	MCP 独立集成、Skill 渐进披露、安全边界
Skill.md	当前 Skill 格式、存储、导入导出、Agent tool 与安全边界
TestingStrategy.md	Domain/Application/Frontend/Security/Performance 测试矩阵

进度跟踪

实时开发进度不写在本目录；请更新 docs/CurrentState/AgentFramework.md。

截至 2026-05-28，canonical model IR、provider native metadata 保真、provider_state continuation、上下文只读工具、Skill 管理与读取、workspace 读改工具循环、前端 dryRun adapter、Phase 3 Agent Profile 基线、独立 Preset 与 model.connectionRef + modelId 组装链路、return-mode SubAgent MVP、run-scoped SubAgent scheduler 基线已落地。当前真实能力边界以 docs/CurrentState/AgentFramework.md、docs/CurrentState/AgentProviderState.md、docs/Agent/PromptAssembly.md 与 docs/Agent/SubAgent.md 为准；MCP、diff/rollback、agent.handoff、模型可见 task cancel、运行中 subagent/handoff 完整 prompt assembly 与 Plan Mode runtime 仍是后续设计。