TauriTavern/docs/Agent/README.md

28 lines
2.3 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

# TauriTavern Agent Detail Docs
本目录保存 Agent 框架的细节设计文档。高层入口仍保留在 `docs/` 根目录:
1. `docs/AgentArchitecture.md`:系统边界、分层、数据流。
2. `docs/AgentContract.md`:不可破坏的不变量与 fail-fast 约束。
3. `docs/AgentImplementPlan.md`:当前实施基线、下一步计划与验收命令。
## 细节文档
| 文档 | 内容 |
| --- | --- |
| [Workspace.md](Workspace.md) | Workspace、Artifact、Checkpoint、commit/rollback 语义 |
| [RunEventJournal.md](RunEventJournal.md) | Run Event、状态机、订阅、恢复、取消与审批 |
| [ProfilesAndPreset.md](ProfilesAndPreset.md) | Agent Profile、Preset agent schema、ContextFrame、Plan Policy |
| [PromptAssembly.md](PromptAssembly.md) | Agent 独立 Preset / 独立 Model、FrozenRunInputSnapshot 与前后端 prompt assembly 链路 |
| [ToolSystem.md](ToolSystem.md) | ToolSpec、ToolResult、Tool Registry、Policy、审批与 Legacy ToolManager 边界 |
| [SubAgent.md](SubAgent.md) | return-mode SubAgent、AgentInvocation / AgentTask、Agent-friendly workspace view 与开发定位 |
| [LlmGateway.md](LlmGateway.md) | provider-agnostic LLM gateway 与现有 `ChatCompletionService` 的复用边界 |
| [McpSkill.md](McpSkill.md) | MCP 独立集成、Skill 渐进披露、安全边界 |
| [Skill.md](Skill.md) | 当前 Skill 格式、存储、导入导出、Agent tool 与安全边界 |
| [TestingStrategy.md](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 已落地。当前真实能力边界以 `docs/CurrentState/AgentFramework.md`、`docs/CurrentState/AgentProviderState.md`、`docs/Agent/PromptAssembly.md` 与 `docs/Agent/SubAgent.md` 为准;MCP、diff/rollback、真正后台并发、`agent.handoff`、运行中 subagent/handoff 完整 prompt assembly 与 Plan Mode runtime 仍是后续设计。