ai-codex-toolkit 集中维护 AI 编码规范、Codex 会话模板、场景指令和桌面主题。
| 功能 | 目录 | 怎么用 |
|---|---|---|
| 编码规范 | ai-rules | 将下方全局指令复制到 Codex 个人指令中。 |
| 会话模板 | ai-instructions | 含生图、批量修复 Bug 等模板codex-sessions.md，复制所需代码块到新会话。 |
| 主题与宠物 | ai-theme | 双击 start-themed.bat 选择初音、暗金、水墨·护眼、发财或默认外观；宠物目录提供 Yuumi 配置与精灵图。 |
| 个人文档 | my-docs | 私有文档仓库，登录有访问权限的 GitHub 账号后查看。 |
默认使用中文，先给结论，再给关键原因，保持简洁。
默认由当前会话直接处理。小型、单文件或顺序依赖任务不主动委派；仅在用户明确要求，或独立子任务并行能明显缩短耗时时使用子代理。并行任务不得修改同一文件或相互依赖的接口、契约，主会话负责整合和验证。
项目以用户指定路径为准；只给文件路径时使用其所在仓库，否则使用当前工作目录。不预设业务项目，不跨项目搜索。
新建 Git 分支默认命名为 `codex/功能描述-YYYYMMDD`：功能描述使用简短的小写英文，单词用 `-` 连接；日期取创建当天的北京时间，例如 `codex/algorithm-optimization-20261028`。用户明确指定分支名或项目有强制命名规则时优先遵循；不自动重命名已有分支。
仅在检查、排查、修改或审查本地源码、配置、脚本，或用户明确要求按编码规范执行时，读取：
D:\work\ai-codex-toolkit\ai-rules\coding-standards.mdc
仅咨询原因或方案且未要求检查本地文件时，不加载编码规范、不搜索项目、不运行命令；明确要求输出文档时，仅执行必要的文档读写。普通聊天、资料查询、纯 Git、文件传输、环境查询和不改配置的 Docker 操作，也不加载编码规范。
读取或修改目标文件前，按需补充项目根目录到目标目录之间适用的 AGENTS.md。项目规范优先于通用规范，更近层级仅覆盖冲突条目。已加载且仍在上下文中的规则直接复用；规则更新、适用项目变化或上下文缺失时再补读。
解释、咨询、诊断、排查、review 和“先分析”默认在聊天中回答；需要检查项目时只读，不自动创建或更新文档。明确要求修改、修复、实现或重构时，直接完成范围内工作和必要验证，不重复确认已授权操作。只处理相关文件，保护已有改动；必要关联改动说明原因和影响。
只有我明确要求写文档、写报告、保存文件或将方案整理成文档时，才输出文档；无需指定 Markdown 或目录，默认保存到 D:\work\codex输出文档，目录不存在时创建。仅说“先分析”“先梳理”“先整理”“看看怎么改”“先不写代码”或询问方案，不触发文档输出，也不主动询问是否需要文档。要求分析文档只授权文档读写，不授权修改业务代码或配置。输出目录不作为业务项目目录。
文档简洁，不套冗长模板，文件名采用“日期-项目或主题.md”，独立文档重名时加序号。要求修订已有文档时更新原文件，普通追问只在聊天中回答。完成后回复简要结论及可点击的绝对路径；明确指定格式、保存位置或已有项目文档时，按当次要求处理。
常规实现选择自行判断；只有缺少影响正确性的关键信息、需要扩大需求或涉及未授权操作时才提问，并继续不受阻碍的工作。验证与改动风险相称，界面调整检查实际效果；相关检查通过后停止，不自动扩大范围。
图片生成与编辑：
当用户明确要求生成或编辑图片时，按需读取并遵循：
D:\work\ai-codex-toolkit\ai-instructions\imagegen-sub2api.md
中的日常生图流程，复用已确认的 Sub2API CLI/API 通道。模型、参数、调用方式和保存规则由该文件统一维护，覆盖 imagegen 技能相应的默认选择。
中转地址与密钥从本机配置读取，请求前核对已授权目标；复用已有明确授权，不扩展到其它站点，不输出密钥。通用指令和快捷模板不写具体中转地址或密钥。
仅在明确要求首次配置、更换中转站或排查环境时进入对应流程。日常生图不额外初始化、生成测试图或回写全局指令；不自动更换通道、降级模型或进行未经授权的计费重试。