ZenlessZoneZero-OneDragon 的 AI 编码助手接入指南：三级晋升体系与全工具协作实践

桌面应用RPA计算机视觉【免费下载链接】ZenlessZoneZero-OneDragon绝区零 一条龙 | 全自动 | 自动闪避 | 自动每日 | 自动空洞 | 支持手柄项目地址https://gitcode.com/gh_mirrors/ze/ZenlessZoneZero-OneDragon点击查看免费下载本文是绝区零一条龙ZenlessZoneZero-OneDragon项目 docs/develop/setup/ai_coding.md 的深度展开。它讲解了本项目如何把 Claude Code、GitHub Copilot 等多种 AI 编码助手接入协作开发流程以「三级晋升」为核心原则管理所有 AI 约定以根目录AGENTS.md为跨工具统一信息源并覆盖 MCP 服务、测试仓访问、LSP、Skills 与 AI 提交署名等完整工程实践。读完本文你将掌握一套可直接复用的多工具 AI 协作治理方案以及本项目为 AI 开发者准备的开发环境接入细节。核心原则三级晋升任何新增的「给 AI 看的约定」都应当按下面的阶梯从低到高放置——能放低就不放高。这一原则贯穿项目全部 AI 协作文件入口文件、skill、提交署名规则是整个协作体系的骨架。级别位置是否提交适用① 个人级CLAUDE.local.md及各工具的本地文件❌ gitignore只对自己有用的偏好、实验性约定。先在这里试。② 项目级工具的项目文件如.claude/CLAUDE.md、.github/copilot-instructions.md或docs/develop/文档✅ 提交团队共享、但某个工具特有的内容。③ 统一源根目录AGENTS.md✅ 提交跨工具通用的项目知识架构、硬约束、流程。晋升路径① 个人级 →证明对团队有用→ ② 项目级 →证明跨工具通用→ ③AGENTS.md。两条关键约束工具特有的内容如 Claude 专属的 uv / context7 规则不进AGENTS.md留在该工具的项目级文件里。只有「所有工具都该知道」的内容才晋升到AGENTS.md。从仓库的 .gitignore 可以验证第①级的落地方式CLAUDE.local.md、.lingma/、.qwen/、.pai/、.kiro/等各工具的个人本地文件均被显式忽略第 14-22 行而!.claude/CLAUDE.md这条例外则保证了团队共享的 Claude Code 入口文件能够正常提交。AGENTS.md统一源根目录 AGENTS.md 是跨工具的单一信息源只保留会直接影响实现落点与提交流程的约束项目架构、开发硬约束、提交流程详细编码规范见 docs/develop/spec/agent_guidelines.md。修改这两份文件即等同于更新所有已接入工具的行为——前提是内容确实跨工具通用否则按上面的阶梯放低一级。从 AGENTS.md 的实际内容看它承载的核心信息包括项目概述Python 3.11 uv PySide6src-layout布局运行基准 1080p配置以 YAML 为主常用命令uv sync --group dev、uv run --env-file .env src/zzz_od/gui/app.py、uv run --env-file .env pytest zzz-od-test/等架构落点核心分层src/one_dragon/、src/one_dragon_qt/、src/onnxocr/、src/zzz_od/、功能开发优先路径、ZContext懒加载机制与 GPU 推理约束开发硬约束类型注解、中文注释、禁止相对导入、pathlib与 f-string、直白表述等提交流程与协作边界Conventional Commits 规范、两仓协同主仓 测试仓等。配套的维护规范见 docs/develop/harness/entry_files.md入口文件只放给 AI 的 always-on 指令不掺杂元信息维护注释、TODO、变更说明一律移出逐条用「删了会出错吗」自检以保持精简AGENTS.md是源其他入口文件用import引入而非复制。对AGENTS.md的大改须先在.claude/CLAUDE.md试验验证后再晋升。各工具接入原则入口文件优先放该工具自己的配置目录如.claude/、.github/而不是项目根目录避免根目录堆积。最理想的是工具能直接读AGENTS.md——这样根本不需要入口文件。Claude Code用引用不用硬链接仓库已提交 .claude/CLAUDE.md其内容第一行即../AGENTS.md通过语法引入AGENTS.md。Claude Code 启动时自动加载无需配置。该文件本身保持极简正文只追加了一条项目特有规则临时文件统一放.debug/temp/体现了「一处维护、不复制」的原则。Claude 特有的项目级规则写在.claude/CLAUDE.md里引入的下方提交、团队共享。例如强制uv、用 context7、Bash 后台等。个人偏好写在仓库根CLAUDE.local.mdgitignore加载顺序在CLAUDE.md之后。GitHub Copilot仓库已提交 .github/copilot-instructions.md。其 frontmatter 声明applyTo: **对所有文件生效每次会话自动注入并 defer 到AGENTS.md取完整上下文。该文件内容浓缩了「General Instructions中文回复、sequential-thinking、context7、activate uv」和「Coding StandardsPython 3.11、类型注解、pathlib、f-string」以及「Code Review Guidelines1080p 硬编码坐标合理、只关注严重逻辑错误等」并明确指向根目录AGENTS.md获取完整项目结构、架构概念与编码规范。其他工具无原生引入机制时若某工具既读不了AGENTS.md、又没有之类的引入语法只能读它自己固定的入口文件就用硬链接让该文件镜像AGENTS.md。入口文件位置同样遵循上面的原则——优先配置目录其次根目录。示例文件名依工具而定此处以CLAUDE.md作占位演示命令形式New-Item -ItemType HardLink -Path CLAUDE.md -Target AGENTS.md该入口文件应被.gitignore忽略仅本地生效个人级。工具特有的项目级内容另起一个提交的文件维护不要塞进AGENTS.md。将来某工具支持引入语法时优先用引入、弃用硬链接。Unixln AGENTS.md CLAUDE.md。这里要注意硬链接的局限docs/develop/harness/entry_files.md 评估过跨工具单源方案后明确「暂不采用」path-scoped rules原因包括git 不保留 hardlink需脚本重建、各工具 frontmatter 字段不同Claudepaths/ Cursor·Traeglobs、rules 文件不支持import且 Codex/Pi/OpenCode 无 path-scoped 机制——覆盖不全、运维成本高。所以本项目用「AGENTS.md 为源 CLAUDE.mdimport」的单一源方案。内容该放哪速查内容放哪只对自己有用的偏好 / 实验① 个人级CLAUDE.local.md团队共享、但某工具特有② 项目级该工具文件如.claude/CLAUDE.md跨所有工具通用③AGENTS.mdMCP项目自有 MCP感知/操作 tool 已实现本项目把游戏感知/操作能力窗口状态 / 截图 / OCR / 进游戏 运行态查/停经 MCP 暴露给 agent辅助开发与调试。传输使用 streamable-http端点/mcp默认端口 23001。完整工具清单见 docs/develop/zzz/backend/mcp.md不在此列举避免随实现演进过时整体设计见 docs/develop/zzz/backend/路线图见 docs/develop/harness/README.md。启动与接入命令# 先启动后端 MCP 服务 uv run --env-file .env python -m zzz_od.backend.entry.server # 再向 Claude Code 注册 MCP 端点 claude mcp add --transport http zzz_od http://127.0.0.1:23001/mcp从 docs/develop/zzz/backend/mcp.md 可以看到这套 MCP 的实现细节22 个mcp.tool多数委托一个 backend 方法覆盖check_game_window窗口状态、capture_game_screen截图落盘、analyze_screen结构化画面分析含vision_hint能力边界提示、open_game/click_game/key_tap/drag/input_text实机操作、run_one_dragon/run_standalone_app/run_operation运行调度以及list_mcp_usage_guides/get_mcp_usage_guide帮助索引等。其核心理念是MCP 只做感知 / 操作编码 / 调试交给 AI。instructions与prompts双通道引导get_run_status/stop_run作为统一状态查询与停止入口单进程内已有运行时会返回并发拒绝以避免重复操作游戏资源。浏览器chrome-devtools-mcp让 agent 经 Chrome DevTools Protocol (CDP) 驱动本机浏览器读取/操作 WebSearch 搜不到或抓不到的页面米游社攻略、需登录的活动页等。推荐connect 模式 调试 Edge由你在桌面会话手动开一个带调试端口的浏览器--remote-debugging-port19999 --user-data-dir$env:USERPROFILE\.edge-debug-profileMCP 连上去从而保留登录态cookie 持久适合米游社登录签到、兑换码等场景。装法与「Session 0 会话隔离」等踩坑点见 docs/develop/setup/chrome-devtools-mcp.md。该 MCP 的主要消费者是zzz-od-miyousheskill。推荐的通用 MCPcontext7推荐context7——查询库文档已在本项目.claude/settings.json启用Claude Code 场景。项目详细编码规范 docs/develop/spec/agent_guidelines.md 中也明确要求「需要库/API文档、代码生成、安装方法、使用方法时请始终使用 context7」。测试仓测试代码在独立仓zzz-od-test/.gitignoreclone 到项目根目录不在主仓。Claude Code 的 Grep/Glob 默认尊重.gitignore不会自动搜zzz-od-test/——查/改测试须Read/grep显式指定zzz-od-test/路径。clone 指引见 docs/develop/setup/quickstart.md「② 跑测试可选」章节规范见 docs/develop/spec/agent_guidelines.md测试代码规范部分。这一点在根目录 AGENTS.md 中被作为硬约束重申主仓git add zzz-od-test/...会被.gitignore静默跳过不报错但未加入因此测试改动必须用git -C zzz-od-test add test/ git -C zzz-od-test commit在测试仓内单独提交两仓须同分支、配对提交、同开关联 PR跨仓 PR 链接用OneDragon-Anything/zzz-od-test#N全名禁裸#N且合并顺序为测试仓先 → 主仓后。LSP项目用uv 方式 pyright做 LSP代码导航定义 / 引用 / 符号——不用 Claude Code 官方的全局 pyright走系统 PATH解析不到项目.venv依赖跟 uv 环境冲突。pyright 在 dev 组、[tool.pyright]配置团队共享Claude Code 的插件安装见 docs/develop/setup/claude-code/pyright-lsp.md。具体落地摘自 pyright-lsp.md团队共享部分已提交uv sync --group dev即装好 pyrightdev 组pyproject.toml中[tool.pyright]已配置include [src]、extraPaths [src]src-layout packagefalse让 pyright 去src/解析导入、typeCheckingMode off起步只用导航后续随改造提升到 basic → standard。个人本地部分gitignore通过claude plugin marketplace add OneDragon-Anything/OneDragon-CC-Pluginsclaude plugin install uv-pyright-lsponedragon-cc-plugins安装改造版插件其 command 是uv run pyright-langserver锁在项目 venv与项目依赖、Python 版本同源再在.claude/settings.json里开env: { ENABLE_LSP_TOOL: true }并确认插件启用。注意不要在settings.json另写lspServers——插件已提供同一份定义重复手写是冗余。SkillsSkill 是 Claude Code及 Codex 等少数工具的可调用能力。要点每个工具只读自己目录下的 skill——Claude Code 读.claude/skills/不读根目录skills/且 skill 没有import之类的引入逃逸口。推荐安装 superpowers项目已统一采用 superpowers团队共识——它是一整套开发流程方法论指导从需求探索brainstorming、写计划writing-plans、TDD 实现test-driven-development、调试systematic-debugging、code review、到分支收尾合并finishing-a-development-branch的全链路本项目按这套流程开发。本项目 dev skillzzz-od-dev-*是叠加在 superpowers 之上的项目特定补充PR 收尾适配 CodeRabbit、本项目 skill 写作硬规范、修复决策框架等非替代——使用者需同时具备 superpowers。Claude Code 安装插件市场搜superpowers或/plugin install superpowers。推荐安装 mcp-server-dev写 MCP tool 时写本项目 backend MCP toolsrc/zzz_od/backend/mcp/时通用 MCP tool 设计方法论遵循 Anthropic 官方mcp-server-devpluginclaude-plugins-officialmarketplace专门 MCP 开发、3 个 skill 无杂烩——尤其build-mcp-server/references/tool-design.md写好 tooldescription 契约 / tight schema / annotations / 结构化返回 / actionable error / 读写分离 / token 经济。项目特化内容只叠加在 docs/develop/zzz/backend/ 下的 mcp-implementation 文档中哪些 tool 标哪个 hint、MCP·HTTP 对称、screen_info CRUD、操作后 sleep 等不重复通用知识。Claude Code 安装claude-plugins-officialmarketplace两步/plugin marketplace add anthropics/claude-plugins-official /plugin install mcp-server-devclaude-plugins-official # 3 个 MCP skill(build-mcp-server/app/mcpb)专门 MCP 无杂烩Skill 分类与命名Skill 分两类统一用zzz-od-项目前缀开发类再加dev-类别前缀用途开发zzz-od-dev-指引 AI 在本项目开发/配置/构建superpowers 风格历史遗留无前缀早期 skill暂保留原名迁移价值待评估从仓库 skills/ 目录的实际内容看当前已有zzz-od-dev-character新增角色、zzz-od-dev-screen-onboarding画面建档、zzz-od-dev-gameplay-onboarding玩法建档、zzz-od-dev-pr-finishingPR 收尾、zzz-od-dev-pr-reviewPR 审查、zzz-od-dev-skill-guideskill 写作硬规范等以及zzz-od-miyoushe、zzz-one-dragon-player等无dev-中缀的 skill。每个 SKILL.md frontmatter 有触发描述具体清单见目录本身不在此罗列以免随增减过时。zzz-od-兼作项目命名空间——避免和插件/个人 skill 撞名/列表里本项目 skill 聚一起。命名示例zzz-od-dev-character新增角色、zzz-od-dev-build构建配置、zzz-od-player安装使用。将来若出现第 3 类如调试加对应中缀zzz-od-debug-*即可。Skill 开发三级晋升跟整体「三级晋升」一致新增 skill 从低到高放级别位置是否提交说明① 个人级.claude/skills/name/.claude/*已 gitignore天然不提交或~/.claude/skills/❌先在这里试做、验证有用再升级。② 工具项目级.claude/skills/name/提交.gitignore放行.claude/skills/✅团队共享、Claude Code 特有。③ 项目级跨工具源根目录skills/name/提交✅多个「skills 感知」工具都要用时作单一源。晋升路径① 个人试做 →验证有用→ ② 提交到.claude/skills/→多工具都要→ ③ 根skills/作跨工具源。⚠️ 根skills/不会被工具自动发现只是③的单一源要目录联接junctionmklink /J目录级进各工具目录如.claude/skills/。Windows junction 免管理员symlink 需特权/开发者模式。只有 Claude Code 一个消费者时停在②即可不必上③。现状仓库根 skills/ 是 skill 的单一源③开发类zzz-od-dev-*superpowers 风格经 junction.claude/skills/name→ 根skills/name被 Claude Code 自动加载。现有 skill 清单见目录本身每个 SKILL.md frontmatter 有触发描述不在此罗列以免随增减过时。新 skill 按上面的命名规范用zzz-od-前缀。AI 辅助提交的署名推荐用 AI 编码工具协作时推荐在 commit 消息里用Co-Authored-Bytrailer 标明 AI 参与——让提交历史能看出哪些是 AI 协作的透明、可追溯GitHub 会识别该格式并把 co-author 显示在提交上。Co-Authored-By: 名字 邮箱落地有两种做法按「靠模型自觉 → 全自动」递进做法一在指令文件里写指引在该 AI 工具的指令文件里写一条让它自己加 trailer例如「提交时在 message 末尾追加Co-Authored-By: 工具 (模型) 邮箱」。✅ 零配置、跨工具。❌靠模型自觉会忘、会漏模型名也可能写错。做法二用 git hook 自动注入推荐用 git 的prepare-commit-msg钩子在每次提交时自动追加 trailer不依赖模型记忆。git 每次提交都会调它链式、git -C dir、--amend全覆盖。两种粒度2a. 钩子里写死内容静态硬编码固定 trailer。最简单、稳但不反映实际模型。2b. git hook AI 工具 hook 写入模型名动态git 钩子注入 trailer再用 AI 工具自带的 hook 在每次git commit前把当前模型名写到侧信道文件git 钩子读取 → trailer 反映实际模型模型一换跟着变。需把工具默认的 co-author 指令关掉避免重复。各工具的具体实现不同——Claude Code 的做法见 docs/develop/setup/claude-code/commit-trailer.md其他工具用各自等价的 hook 机制。Claude Code 的具体落地摘自 commit-trailer.md由三个部分组成Claude Code hookPreToolUsecommit_trailer.ps1每次git commit前从会话 transcript 取当前模型只读尾部 200 行取最后一条带 model 的记录写到.debug/temp/.cc_model。不改命令只记模型永远exit 0、静默失败绝不阻断。git hookprepare-commit-msggit 每次提交自动调它读.cc_model→ 用git interpret-trailers追加两行 trailer工具行固定Claude Code noreplyanthropic.com模型行按模型前缀映射邮箱glm*→noreplybigmodel.cn、deepseek*→noreplydeepseek.com、其余 →noreplyanthropic.com。无模型记录非 Claude Code 提交则跳过已有则幂等跳过。attribution.commit把 Claude Code 默认的 co-author 指令置空避免和 git hook 撞车重复。为什么用 git 钩子注入、而不是让 Claude Code hook 改写命令git 钩子由 git逐提交调用链式、git -C dir、--amend都自动覆盖也不用解析命令文本不会误伤提交消息里出现的「git commit」字样。注部分工具/模型厂商没有官方 GitHub bot 邮箱模型那行的邮箱只是占位GitHub 上不出头像/contributor推荐用对应厂商官网域名如noreply官网域名作占位。相关文档AGENTS.md — 统一 AI 编码协作入口docs/develop/spec/agent_guidelines.md — 详细编码规范docs/develop/README.md — 开发指南docs/develop/harness/README.md — AI Coding Harness 工程知识分层 / 上下文工程docs/develop/harness/entry_files.md — AI 入口文件维护规范docs/develop/zzz/backend/mcp.md — 项目自有 MCP 工具清单docs/develop/setup/claude-code/commit-trailer.md — Claude Code 自动注入 commit trailerdocs/develop/setup/claude-code/pyright-lsp.md — uv 方式 pyright LSPdocs/develop/setup/chrome-devtools-mcp.md — 浏览器 MCP 接入赞分享桌面应用RPA计算机视觉【免费下载链接】ZenlessZoneZero-OneDragon绝区零 一条龙 | 全自动 | 自动闪避 | 自动每日 | 自动空洞 | 支持手柄项目地址https://gitcode.com/gh_mirrors/ze/ZenlessZoneZero-OneDragon点击查看免费下载相关推荐ZenlessZoneZero-OneDragon绝区零一条龙AI 编码协作入口与开发规范解析ZenlessZoneZero OneDragon绝区零一条龙AI 编码协作入口与开发规范解析 本文以仓库根目录的 AGENTS.md https://li桌面应用RPA计算机视觉btcrecover完全指南如何用这款开源工具找回你的比特币钱包密码与助记词btcrecover完全指南如何用这款开源工具找回你的比特币钱包密码与助记词 btcrecover是一款功能强大的开源比特币钱包密码与助记词恢复工具专为那些应用安全区块链CLIDebezium 仓库的 AI 编码助手协作指南AGENTS.md 全解与工程实战Debezium 仓库的 AI 编码助手协作指南AGENTS.md 全解与工程实战 Debezium 是一个开源的变更数据捕获Change Data Cap后端变更数据捕获数据集成流处理创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考