两步就够
不用先读完仓库。先让 AI 把 JDK 和单测跑通，再用一句话说你要改的那一件事。
1. 复制发给 AI，准备环境
打开 Cursor（或别的编码智能体），点复制，粘贴发给它：
帮我准备开源项目 Agent1（https://github.com/fengshihao/agent1）的贡献环境：请你自己克隆仓库、读 AGENTS.md 和 docs/ai/START.md，安装 JDK 17 后运行 ./java_agent/gradlew -p java_agent :core:test :cli:test。准备好后告诉我，我再说想贡献什么。
环境就绪后，用一句话告诉它你要做什么。一次只做一件事。
我要贡献：〈一件事〉。按 AGENTS.md 与 docs/ai/CHECKLIST.md 修改；新增或改动 Java 行为必须带 JUnit 单测；改完必须 ./scripts/ci-local.sh fast 通过，再按 docs/ai/PR_PLAYBOOK.md 开 PR。若改 Android 组装或大量 Android 代码，再跑 ./scripts/ci-local.sh full。
2. 验收 AI 有没有做对
让 AI 跑，或你在仓库目录运行：
./java_agent/gradlew --no-daemon -p java_agent :core:test :cli:test ./scripts/ci-local.sh fast
Java 行为变更必须有 JUnit。动到 Android 组装时，把 fast 换成 full。
./java_agent/gradlew -p java_agent :core:test :cli:test— 核心与 CLI 单测./scripts/ci-local.sh fast— 与 CI 对齐的快速门禁./scripts/serve-site.sh— 本地打开本官网