开发全流程
从看 Issue 到代码合并，让 Agent Team 带你飞
🌐 核心理念：你不是一个人在战斗
你的 Agent Team 包括：
研究员 Agent
帮你分析 Issue、理解需求
程序员 Agent
帮你写代码、改 Bug
测试员 Agent
帮你测试、验证功能
文档员 Agent
帮你写 PR 描述、更新文档
你只需要当产品经理，告诉他们要做什么。
1 看 Issue 领任务
1
浏览 Issue 列表
- 打开 GitHub Issues 页面
- 对 AI 说："帮我看看 AutoPku 有哪些 open 的 issue，找适合新手做的"
- AI 会帮你筛选带有
good first issue或help wanted标签的任务
2
领取任务
- 在感兴趣的 Issue 下留言："I'd like to work on this"（我想做这个）
- 或者直接用中文："这个任务交给我吧"
- 等待维护者确认（通常会回复 "Assigned to you"）
3
理解需求
- 对 AI 说："帮我读一下这个 Issue，告诉我需要做什么"
- AI 会分析 Issue 内容，用大白话解释给你听
- 如果有不明白的，直接在 Issue 下问
2 Vibe Coding
🎧 这是整个流程最爽的部分——你只需要说话，AI 帮你写代码。
4
告诉 AI 你的需求
- 对 AI 说："我要实现 [功能描述]，参考这个 Issue #[编号]"
- 越具体越好，比如："在同步通知功能里，增加一个按截止日期排序的选项"
5
AI 写代码，你当评审
- AI 会自动修改代码文件
- 重要：每改完一个文件，AI 应该向你汇报改了什么
- 你要像产品经理审需求一样审代码："这里逻辑对吗？""有没有漏掉边界情况？"
- 对 AI 说："给我讲讲你这段代码的逻辑"
6
让 AI 自查
- 对 AI 说："检查一下刚才的修改有没有问题"
- AI 会帮你 review 代码风格、潜在 Bug
典型的 Vibe Coding 对话
对话
你: "帮我看看 Issue #15，用户说通知同步时漏掉了没有附件的作业"
AI: "我看了，问题是过滤条件里排除了没有附件的条目。我来修复..."
[AI 修改代码]
AI: "改好了，我把过滤条件从 'has_attachment' 改成了检查 'assignment_type'"
你: "测试一下这个修改"
AI: "我来运行测试... 通过了。我还检查了其他几个边界情况..."3 测试
7
本地测试
- 对 AI 说："帮我测试一下刚才的修改"
- AI 会自动运行相关测试，或手动验证功能
- 如果有报错，AI 会分析并修复
8
检查修改范围
- 对 AI 说："帮我看看我改了哪些文件"
- AI 执行
git diff或git status - 确认没有改到不该改的文件
4 提交与沟通
9
提交代码
- 对 AI 说："帮我把修改提交，写一个好一点的 commit message"
- AI 会执行
git add+git commit - 好的 commit message 示例：
fix: 修复无附件作业被漏掉的问题 (#15)feat: 增加课程通知按截止日期排序
10
推送到你的 Fork
- 对 AI 说："帮我推送到 GitHub"
- AI 执行
git push origin feature/xxx
11
创建 Pull Request
- 对 AI 说："帮我创建一个 PR"
- AI 会打开 GitHub 页面，或直接用
gh pr create - PR 描述要包含：改了什么、为什么改、怎么测试的
5 审查与合并
12
回应 Review
- 维护者可能会在 PR 下提建议
- 对 AI 说："有人 review 了我的 PR，帮我看看需要改什么"
- AI 帮你理解 review 意见，并做出修改
13
庆祝！
- PR 被合并后，你就正式成为了 AutoPku 的 Contributor！
- 你的名字会出现在 GitHub 贡献者列表中 🎉
🏆 恭喜你！完成一次贡献后，你会发现整个过程其实很自然——就像跟一位全能的搭档一起工作。
🤔 常见问题
Q: 我改了代码但 push 失败了？
→ 对 AI 说："push 失败了，帮我看看怎么回事"
Q: 和别人改了同一个文件，冲突了？
→ 对 AI 说："有 merge conflict，帮我解决"
Q: 我的 PR 很久没人 review？
→ 在 PR 下礼貌地 @ 维护者，或在讨论区问问