Files
cc-web/.planning/2026-08-24-gitea-mcp-failure/task_plan.md

1.2 KiB

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: 前缀。