pangtiankai
c29af91113
Initial documentation for route A (port claude-code-action to Gitea Actions). Research complete, no implementation code yet. See docs/02-roadmap.md for milestones.
49 lines
1.8 KiB
Markdown
49 lines
1.8 KiB
Markdown
# 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
|