# Gitea MCP 失败链路收尾计划

## 目标

让 Gitea Workflow 在官方 `gitea-mcp` 缺失、无法启动或 stdio 握手失败时，
在有限时间内结束任务并发送一次可见失败回执；正常 MCP 链路保持线程级注入，
不引入 Docker 依赖、不修改用户未授权的部署配置。

## 步骤

- [in_progress] 核对当前 Gitea runner、Codex App 启动和回执结算链路
- [pending] 增加 gitea-mcp stdio 预检与有限超时错误分类
- [pending] 增加针对缺失、启动失败、握手失败的独立回归断言，并验证每类只发一次 giteabot 失败回执
- [pending] 同步中文文档和运行配置说明，明确线程级注入与不自动安装约束
- [pending] 运行静态检查、单测、Webhook 回归并核对运行状态

## 错误记录

| 错误 | 尝试 | 处理 |
|---|---:|---|
| 全局技能路径不存在 | 1 | 改用项目内 `.codex/skills/planning-with-files` 与用户目录 `todo-list-csv` |

## 决策

- 不自动安装外部二进制；安装属于外部系统变更，需用户明确确认。
- 预检只验证命令可执行和 MCP initialize 响应，不记录 Token 或完整 stderr。
- Gitea Workflow 任务失败回执仍统一使用 `giteabot:` 前缀。