换项目还要重新交代编码规范？3 步让 Gemini CLI 命令行 AI 记住你的项目

换项目还要重新交代编码规范3 步让 Gemini CLI 命令行 AI 记住你的项目【免费下载链接】gemini-cliAn open-source AI agent that brings the power of Gemini directly into your terminal.项目地址: https://gitcode.com/GitHub_Trending/gemi/gemini-cli如果你的团队也这样每接一个新仓库都要把技术栈、命名习惯、安全红线重新对 AI 讲一遍。Gemini CLI 是一个开源命令行 AI 助手靠 GEMINI.md 上下文管理和技能Skills系统把这份交代变成一次性的配置。 配置什么GEMINI.md 的三级上下文结构加载顺序全局、项目、模块GEMINI.md 就是写下来的上下文。启动 Gemini CLI 时它会按固定顺序拼接各级 GEMINI.md并随每次请求一起发给模型所以你只需要交代一次。层级路径写什么全局~/.gemini/GEMINI.md个人通用偏好语言、语气、工具习惯项目项目根目录 .gemini/GEMINI.md团队约定技术栈、命名、错误处理风格模块特定目录下的 GEMINI.md组件级细节工具实际访问该目录时才加载在我们用的 0.59.x 版本里终端底栏会显示 Using: 2 GEMINI.md files | 2 MCP servers一眼能看到加载了几个上下文文件会话内输入 /memory show 可看拼接后的完整内容/memory reload 强制重新扫描。规范太长用 import 拆文件项目级文件膨胀后可以用 file.md 语法拆成子文件主文件只留技术栈 代码规范末尾写一行 ./docs/style-guide.md 引入团队详细风格。上下文文档里还有 settings.json 的 context.fileName 配置让工具同时识别 AGENTS.md 这类命名。 配置什么技能系统把审查标准变成共享资产一个目录就是一项按需加载的专长GEMINI.md 常驻技能则是按需的。会话开始时 Gemini CLI 只把每个技能的名称和描述注入系统提示词当它判断任务匹配比如你说审查这个 PR才调用 activate_skill经你确认后SKILL.md 全文才进入对话。这种渐进式加载不会占用上下文预算。我们团队的 PR 审查流程就固化在项目的 .gemini/skills/code-review/SKILL.md先查安全漏洞、单测覆盖率门槛、TypeScript 规范。之后 AI 做代码审查会照着这份清单走。跨项目共享四个发现层级发现顺序是内置 扩展 用户级~/.gemini/skills/ 工作区级.gemini/skills/同名时高优先级覆盖低优先级。工作区级技能随仓库走提交后全团队共用同一套审查标准个人技能库可以用 link 方式接入。/skills list gemini skills link ./shared-skills --scope workspace细节见技能文档。 场景化演示从接手老项目到 CI 流水线接手老项目先规划后动手面对陌生仓库先别让它动文件。Plan 模式是纯只读环境只产出方案gemini --approval-modeplan 审查这个认证重构关注向后兼容性方案确认后再切换审批执行。--approval-mode 有 default、auto_edit、plan、yolo 四个取值默认 default 下写文件会逐项征求确认。编辑器与 CI 里的 Gemini CLI编辑器内运行 /ide install 装 VS Code 伴侣扩展后Gemini CLI 能感知最近打开的 10 个文件、光标位置和选中文本AI 的修改直接在编辑器原生 diff 里审阅。CI 里则用 headless 模式跑同一套审查-p 指定提示词、--output-format json 输出结构化 JSON退出码 0/1/42/53 分别表示成功、一般错误、输入错误、超出轮次脚本里直接断言即可。⚠️ 容易踩的坑与解法会擅自改代码吗Plan 模式纯只读默认模式下写文件都要确认。CI 里建议 headless json 输出别顺手开 yolo。大代码库塞不下上下文模块级 GEMINI.md 是工具实际访问该目录时才加载的即时上下文不是一次全读多目录仓库用 --include-directories src,lib,docs 补工作区。网络不稳定可配置本地模型承担路由判断见本地模型路由断网时简单分类逻辑仍可用。技能建好了 /skills list 看不到检查 SKILL.md 是否直接位于技能一级目录内然后跑 /skills reload 刷新。 下一步3 件本周就能做的事在项目根建 .gemini/GEMINI.md先写技术栈、缩进、命名和错误处理约定提交进仓库。把团队 PR 审查流程写成 .gemini/skills/code-review/SKILL.md跑一次 gemini skills list 确认被发现。给 CI 加一条 headless 审查gemini -p review this diff --output-format json并按退出码断言。从这两个文件开始换机器、换项目交代都还在。【免费下载链接】gemini-cliAn open-source AI agent that brings the power of Gemini directly into your terminal.项目地址: https://gitcode.com/GitHub_Trending/gemi/gemini-cli创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考