# claude-gitea-agent

> Claude Code 自动响应 Gitea issue 的代理 —— 在 issue 里和你交互式确认需求，对齐后自动开发并提 PR。

## 项目目标

复刻 Anthropic 官方 [`claude-code-action`](https://github.com/anthropics/claude-code-action) 的 GitHub 体验，但跑在 Gitea 上：

- **触发**：在 Gitea issue 或 PR 评论里 `@claude ...`
- **交互**：Claude 在评论里和你来回讨论需求（superpowers brainstorming 风格）
- **执行**：对齐后自动建分支、写代码、跑测试、提 PR
- **运行环境**：你的本地 act_runner（已部署）

## 当前状态

🟡 **筹划期** —— 仓库刚建好，docs 在写，代码移植还没开始。

| 阶段 | 状态 |
|---|---|
| 调研开源方案 | ✅ 完成（[docs/02-roadmap.md](docs/02-roadmap.md)） |
| 仓库脚手架 | ✅ 完成 |
| Gitea API 客户端移植 | ⏳ 待开始 |
| 触发器 + 评论交互 | ⏳ 待开始 |
| PR 生成流程 | ⏳ 待开始 |
| 端到端跑通 | ⏳ 待开始 |
| 升级到 webhook 长驻服务（路线 B） | 🔮 未来 |

## 架构选择

**路线 A**：fork 上游 `claude-code-action`，替换 GitHub API 调用为 Gitea API，跑在 Gitea Actions 上。

- 优点：站在巨人肩膀上，提示词/上下文构造/PR 流程沿用官方逻辑
- 缺点：Gitea Actions 冷启动 ~30s，每轮交互有延迟，不算"真实时"
- 后续可升级到路线 B（长驻 webhook 服务 + Claude Agent SDK），细节见 [docs/02-roadmap.md](docs/02-roadmap.md)

详见 [docs/01-architecture.md](docs/01-architecture.md)。

## 快速链接

- [01 - 架构](docs/01-architecture.md)
- [02 - 路线图](docs/02-roadmap.md)
- [03 - 移植计划](docs/03-porting-plan.md)
- [04 - 设计决策](docs/04-decisions.md)
- 上游参考：[anthropics/claude-code-action](https://github.com/anthropics/claude-code-action)

## License

MIT