本项目通过多个流程学习并尝试设计一个Coding Agent。
需要注意的是本项目通过gpt5.5进行Vibe Coding，因此主要是学习设计理念，整体只把关了功能需求，技术栈，架构设计，模型层和数据流通等方向。 其余如命令行操作之类的则全由模型提供方案进行选择。
本项目采用 Spec 驱动开发（你也可以根据按照习惯的Vibe方式进行）。
spec.md -> plan.md -> task.md -> checklist.md
- spec.md：要做什么，边界是什么，如何验收。
- plan.md：架构上怎么做，模块如何拆分。
- task.md：按什么顺序实现，每一步如何验证。
- checklist.md：最终如何确认行为正确。
仓库不会长期保留每一次开发过程中的 spec.md、plan.md、task.md、checklist.md，这些文件属于本地工作文档。
如果你想基于本项目继续开发，请先根据你的简要需求与模型沟通，之后拉紧边界明确需求。
| 章节 | 主题 | 说明 |
|---|---|---|
| ch01 | 单轮/多轮聊天客户端基础链路 | 打通配置加载、Provider 抽象、OpenAI-compatible / Anthropic 流式响应、thinking 展示和 Bubble Tea TUI。 |
| ch02 | 工具系统与 Agent 雏形 | 新增统一工具层，支持 Read、Write、Edit、Bash、Glob、Grep，并完成单轮工具调用、结果回灌和 Agent Loop 阻断。 |
| ch03 | Agent Loop、AgentEvent 与多轮工具编排 | 从单轮工具闭环升级为多轮自主执行，重点讨论 Plan 模式、并行工具、AgentEvent 事件流以及 UI 联动。 |
| ch04 | 工具权限与安全沙箱 | 为 Agent Runtime 接入五层权限系统，覆盖危险命令硬拦截、符号链接路径沙箱、可配置规则、权限模式和 TUI 人在回路确认。 |
| ch05 | MCP Client 与延迟工具发现 | 接入外部 MCP Server，支持 stdio / Streamable HTTP、JSON-RPC 会话、工具发现、ToolSearch 延迟 schema 和多 Server 生命周期管理。 |
| ch06 | 上下文管理与长会话压缩 | 引入工具结果落盘、稳定预览体、LLM 结构化摘要、恢复段、/compact 手动入口和 prompt_too_long 紧急压缩重试。 |
| ch07 | 启动恢复、长期记忆与内置命令框架 | 接入指令恢复、JSONL 会话存档、异步长期记忆，并新增零参数斜杠命令注册中心、TUI 分流、补全菜单和安全退出。 |
| ch08 | Skill 技能包系统与两阶段加载 | 将可复用 AI 操作封装为本地 Skill，支持 catalog 注入、LoadSkill 激活、会话级专属工具 overlay、inline/fork 执行模式和 /skill 列表命令。 |