maou_redux

Imported from odradekk/maou_redux (AGENTS.md). Install upstream with npx skills add odradekk/maou_redux. Copyright stays with the author.

ere-game（EraElectron 游戏《魔王 Redux》）

工作语言：简体中文。 对话、提交信息、代码注释、文档、Issue 一律中文；代码标识符用英文（见「代码约定」）。

项目目标

《魔王 Redux》：运行在 EraElectron 4.8.0 上的 JavaScript 游戏。游戏源码为 ere/*.js（入口 main.js），静态数据表为 yml/*.yml，资源在 res/。

引擎不内置任何玩法系统：存读档界面、商店、调教、事件、日循环与主循环全部游戏侧自实现，引擎只提供输出、输入、变量、存档、角色、媒体与日志 API。

当前状态

移植已完成：路线图 #101 于 2026-09-29 关闭，各阶段的决策与验收记录在它和各阶段子地图里。此后本项目独立开发（ADR-0008）：改游戏按普通产品改动处理，理由写在代码注释和提交说明里。首个公开版本 0.1.0 于 2026-09-29 发布（#714），发版步骤见「发版」一节。

从新游戏到结局的流程由 test/event-ending-e2e.test.js 持续验证（侵略线到 ENDING_1）。另有迷宫到 ENDING_2（event-ending2-e2e、event-ending2-2d-e2e）、战役全通关（campaign-e2e）、角色堕落（event-corrupt-e2e）、据点一日循环（event-daycycle-e2e）等端到端测试，都包含在 npm test 中。

开始开发前阅读以下文档：

• docs/skeleton.md：模块分层、注册机制、变量访问和测试约定，以及早期端到端验证的结论。
• CONTEXT.md：游戏概念与引擎 API 的术语对照。命名使用「本项目用词」一列；文档中的「写作约定」说明中文表达要求。

sav/global.sav 由引擎生成，不纳入版本控制。 其中保存的游戏标识（当前为 931060）必须与 yml/GameBase.yml 的【游戏标识】一致，否则引擎拒绝启动并报错。dev-guides/11-saves.md:55 说明了此行为；公共存档自动重置仅适用于版本号过低的情况。修改【游戏标识】后，需要删除旧的 global.sav，由引擎重新生成。

目录结构

<仓库根>/（当前 Windows 主工作目录为 D:/Code/era）
├── ere/              # 游戏源码，入口 main.js；era-electron.js 是引擎 SDK，勿改名或移动
├── yml/              # 静态数据表（YAML），即引擎的静态数据目录
├── tools/            # 离线脚本，不受 ere/ 的依赖限制
├── test/             # node --test；helpers/era-fixture.js 是全项目唯一的注入点（issue #16）
├── res/              # 图片/音频（#69 起启用，resource: true；六图 + 三首 BGM）
├── sav/              # 存档，*.sav 已 gitignore
├── third-party/      # 随发布包分发的第三方许可证
├── dist/             # 发布包产物，已 gitignore
└── dev-guides/       # 引擎手册的本地副本，已按引擎行为修正

引擎运行时不进 git。Windows 发布包放在仓库内的 ere-4.8.0-win-x64/；Linux 运行时沿用 ~/.era-engine/。测试共用的引擎包放在用户目录：

~/.era-engine/
├── app.asar          # 引擎本体，与平台无关；测试的引擎比对直接解析它
└── runtime/          # 仅 Linux：Electron 34（npm install electron@^34.5.8）

游戏代码和资源分别写入 ere/、yml/、res/。

运行与调试

当前开发环境为 Windows / PowerShell，Node 至少 24.13.1。 24.13.0 在 Windows 清理中文临时目录时会原生崩溃；版本依据、依赖安装、引擎配置、worktree 与 PowerShell 命令见 Windows 开发指南。新机器、引擎启动失败或跨平台验证失败时先读该指南。

npm start

1. 运行 npm start 启动引擎。
2. 在【游戏】→【打开游戏】中选择仓库根目录。路径由引擎维护；手工编辑全局配置会在引擎退出时被覆盖。
3. 显示「加载成功」后按任意键进入标题；修改代码后按 Ctrl+R 重新加载。

npm start 与 Electron MCP 共用启动配置：Windows 启动发布包的 .exe，Linux 启动 ~/.era-engine/runtime/ 下的 Electron 与 ~/.era-engine/app.asar。Electron 版本取自上游 4.8.0 的 devDependencies（electron ^34.5.8），换引擎版本时一并核对。

启动顺序：读配置 → 读 yml/*.yml（GameBase.yml 必需）→ 读 res/ → 以 ere/main.js 为入口加载脚本 → 注入 SDK → 读 sav/ → 执行 main.js 导出的函数。

项目提供以下三项检查，按下表选择测试范围：

npm test                 # node --test，零第三方依赖
npm run lint             # ESLint，零警告标准
npm run format:check     # Prettier，只检查格式

全库 npm test 本机带引擎约 4 分钟（#452 实测 217 秒，199 个文件、5923 例），按下表选择测试范围：

曾有按改动文件选择测试的选择器（#256），实测最多省一半时间，#452 撤掉：本地和 CI 只有 npm test 一个入口，PR 的 CI 通过即全库通过。

引擎验收要走到后期流程时，用 tools/make-acceptance-save.mjs 造档。 从新档实打到「人间界已征服」这类前置要上百个游戏日的交互，不现实。做法是两步：先在引擎里开新档、存一个槽（存档结构由引擎自己写），再用该脚本把前置所需的那几个 flag 注入到另一个槽（预设 campaign ＝人间界已征服走战役，#471；ending1 ＝只注满侵攻度走 ENDING_1，#549）。注入哪些键写在脚本的 PRESET_PATCHES 预设表里，改它要同步改对应工单的验收记录——验收记录必须写明「基础存档是引擎产出的，构造的只有所选预设列出的键」，不能当成「从新档打通」（#471 的用法见该票评论）。

测试入口统一限制为 4 个测试文件并发，包括 npm 测试与变异子进程。它限制进程并发数，不等于 CPU 配额；同时跑多个 agent 或变异副本时仍要控制任务数。Linux 可额外用 bash tools/capped.sh npm test 施加 systemd CPU 配额；Windows 直接用 npm 命令。

测试命令必须有超时。npm test、npm run lint、npm run format:check 直接跑——package.json 里这三条脚本本身就是 node tools/run-node.mjs -- …，默认 600 秒上限已经在里面了。run-node.mjs 自己 spawn 的是 node，参数必须是 node 脚本或 node 选项；手工再包一层（run-node … -- npm run test）在 Windows 上会报 Cannot find module …\npm，因为它找的是 npm 而不是 npm.cmd。单文件测试与长任务用 run-node 显式给更大的 --timeout，不依赖默认值。npm run test:ci 是例外，脚本里显式声明 1200 秒——它跑全库测试，本机带引擎实测 326 秒（node --test --test-concurrency=4，5916 例全过），但 ci.yml 的 windows 任务在 CI runner 上首次运行就撞上默认的 600 秒被杀（#443：35329826228，09:30:15 起跑、09:40:16 被 taskkill 终止，未跑完），1200 秒留出约 3.7 倍于本机实测的余量。这与 ci.yml 各 job 的 timeout-minutes: 30（1800 秒）是两层不同的上限：后者是 job 级兜底，覆盖检出、装依赖、跳过数守护等全部步骤；前者是 test:ci 这条命令自己的上限，必须留在 job 级上限之内。Windows 的 timeout.exe 只是等待命令，不能替代 GNU timeout。PowerShell 示例：

New-Item -ItemType Directory -Force logs/migration | Out-Null
node tools/run-node.mjs --timeout 5400 -- tools/mutation-check.mjs --jobs 2 *> logs/migration/mutation-full.log

超时返回 124；Windows 用 taskkill /T /F 终止本次命令的子进程树，POSIX 先中断、5 秒后强制终止。强制终止不执行 finally，所以 mutation-check 的串行档和 --jobs 并行档都在临时目录的隔离副本里变异，工作区不会停在某条变异的状态（#536）；每次运行先复制副本、跑一遍不带变异的对照，多花几秒。只有显式加 --in-place（并行子进程和 CI 分片用）才直接改 --root。长时间的全量任务用 --jobs 2 或更高缩短时间。

等待长任务时，使用任务本身提供的等待接口，并取得最终退出码。 不要另写基于进程名的轮询：pgrep -f 可能匹配轮询命令自身，导致循环无法结束。

日志保存到仓库内的 logs/<工单号>/<用途>.log，该目录已被 Git 忽略。每个 worktree 使用自己的日志目录，避免多个 agent 覆盖同名文件；需要保留的验收记录，应在删除 worktree 前写入工单评论。系统临时目录可能被清理，不适合保存长期验收记录。

格式工具的使用要求：

• 格式选项在 .prettierrc 与 .eslintrc.js 的 prettier/prettier 规则里各写了一份且取值相同。改格式约定必须同时改这两处，否则两条命令会给出互相矛盾的结果。
• .prettierignore 是必需品：prettier 默认扫描全仓库，没有它 --write 会把 yml/ 产物的双引号键名改成单引号，也会重写仓库内不受 Git 跟踪的引擎发布包。
• 先运行 npm ci，再使用仓库安装的 ESLint 和 Prettier。 缺少本地依赖时，npx 可能下载其他版本：ESLint v9 不兼容当前配置格式；不同 Prettier 版本可能对 Markdown 表格对齐和循环尾部空格给出不同结果。工具版本以 package-lock.json 为准，不以 package.json 中的 ^ 范围为准。必须通过 npx 使用工具时，显式指定锁文件中的版本。

CI

.github/workflows/ci.yml 根据触发方式运行以下检查（#92 引入 CI，#302 增加引擎检查，#452 改为 PR 也跑全库）：

PR 与 master push 跑同一套全库测试，PR 绿即全库绿。无引擎任务只在 master push 跑，用于发现引擎缺失时的退化。

全量变异测试只对阶段收尾 PR 跑。 .github/workflows/mutation.yml 在 PR 被打上 phase-acceptance 标签时触发，之后每次推送重跑，去掉标签即停。条目按 --slice i 12 分成 12 个并行分片各自串行运行（阶段 7 收尾时 7046 条，12 片并行实测约 20 分钟；分片单条命令上限 2100 秒，条目再涨到贴近上限时加分片），汇总任务把「拦截 / 跳过 / 红」合计写进 job summary；合格线是每片退出码 0（拦截全部、跳过 0、红 0）。本机全量仍可用 --jobs 2 跑，但 7000 条左右实测约 3.5 小时，阶段验收优先走 CI。上千条的单工单验收也可以借这个标签在 CI 跑全量，跑完去掉标签。

CI 从 Release 下载引擎。 .github/actions/setup-engine 下载 engine-4.8.0 的 app.asar，校验 SHA256 后放到 ~/.era-engine/app.asar，测试按默认路径查找。引擎文件约 42 MB，不提交到 Git，也不依赖缓存是否存在。升级引擎时，创建新的 Release tag，并更新 action 中的 SHA256 校验值。

跳过数分别与两份基线比较：无引擎时使用 test/engine-skip-baseline.txt，新增依赖引擎的用例必须同步更新该文件；有引擎时使用 test/engine-present-skip-baseline.txt，预期为 0。引擎已安装却仍有测试跳过时，应检查跳过条件和 locate_asar 的查找结果。

concurrency 会取消 PR 的旧运行，不取消正在执行的 master push 任务。 但同组等待中的运行仍可能被后续运行替代。因此，连续合并多个 PR 后，中间提交不一定各有一次完整结果；最终提交的测试失败时，应检查自上次通过以来的全部合并。

发版

版本号与存档兼容按 ADR-0006「玩家存档保护」：0.1.0 已有玩家，已发布版本的存档必须能继续读取。发版只提高 yml/GameBase.yml 的【版本】与【版本代号】，【最低支持版本】固定在 1000（0.1.0），提高它需要用户单独决定。破坏性改动先改写法避开，避不开就写迁移代码。每个版本在 CHANGELOG.md 写明与哪些旧版本的存档通用。

1. 发版工单的 PR 改版本号和 CHANGELOG.md，合并后切回 master。
2. 在 master 上运行 node tools/pack-release.mjs，在 dist/ 下生成纯游戏包和整合包，并输出两个包的 SHA256。脚本只收 git 已跟踪的 ere/、yml/、res/ 与说明文件，这些路径有未提交的改动时拒绝打包。整合包里的引擎取本机引擎目录，查找顺序同 npm start；压缩需要 7-Zip。
3. 解压整合包，在解压目录里启动 exe，确认不手动选目录也能进入标题画面，且标题显示新版本号。
4. 在合并提交上打 v<版本代号> tag 并推送，用 gh release create v<版本代号> dist/*.zip --repo odradekk/maou_redux 发布。发版说明取自 CHANGELOG.md，附两个包的 SHA256。

游戏的 Release 带 Latest 标记。engine-4.8.0 是 CI 下载引擎用的 Release，CI 按固定地址下载，不受 Latest 标记影响。整合包附带的引擎要与测试使用的版本一致，换引擎版本另开工单。

静态数据目录

引擎按 yml > json > csv 挑一个目录读全部静态表，不逐文件混读；system.static 只是搜索起点，且只向低优先级方向回落，不会往回找。

• 全新克隆免配置：ere.config.json 不进 git，缺失时引擎默认无 system.static 键，从 yml 起步，直接命中 yml/。
• 本地旧配置写着 "static": "csv" 会直接失败：csv/ 已随 issue #17 迁移移除，起点之后没有更低优先级的目录可退，引擎报「静态数据文件夹 (yml / json / csv) 不存在! 游戏数据载入失败!」。把该键改成 "yml"，或删掉 ere.config.json 让引擎重新写回。

配置优先级：yml/_fixed.json > ere.config.json > yml/_config.json > 引擎默认值。

默认配置不会逐键补齐用户配置。 引擎会整体选择 ere.config.json、yml/_config.json 或内置默认值，再应用 _fixed.json 的固定设置（#69）：

try { this.defaultConfig = JSON.parse(…readFileSync(join(staticPath,"./_config.json"))) }
catch(e) { this.defaultConfig = getEmptyConfigForm() }
if (this.config || (this.config = JSON.parse(JSON.stringify(this.defaultConfig))), …)

• yml/_config.json 必须提供完整的默认配置。 文件存在且可解析时，defaultConfig 整体取自该文件，缺少的键不会从引擎默认值补齐。各使用位置对缺值的处理不同：saveFiles 使用 ||10，window.* 交给渲染层，resource 按假值关闭。文件必须包含 getEmptyConfigForm() 的全部字段；test/resource-media.test.js 逐键与引擎默认配置比较，目前只允许 resource 的值不同。
• 已有 ere.config.json 时，修改默认配置不会自动生效。 代码中的 || 会直接使用已加载的 this.config，不读取 _config.json 的值。需要在本机应用新默认值时，修改 ere.config.json 中的对应键，或删除该文件后让引擎按新默认配置重建。
• 哪个键放哪个文件：结构性要求（如 extendedCharaTables，缺了会直接崩溃或静默降级）放 _fixed.json，它优先于用户配置；用户偏好（如 resource，引擎配置 UI 里有对应开关）放 _config.json，放进 _fixed.json 会让 UI 开关点了没反应。
  • saveFiles 固定为 99，写在 _fixed.json 中（#135）。 游戏提供 99 个手动存档槽（0–98）和 99 号自动存档槽（ADR-0006）。引擎 listSaveFiles 的扫描条件为 for (let t = 0; t <= saveFiles; ++t)，因此 99 能覆盖 0–99；dev-guides/03-config.md:76 规定取值为 10–99 的整数，不能设为 100。若只写在 _config.json 中，旧的本地配置仍可能使用 10，导致 loadGlobal 不维护槽位 11–98 的备注，界面显示为空；仅使用默认配置的测试无法发现这一问题。固定该值后，配置界面的「存档数量」设置不再生效，这是 #135 接受的限制。
  • erauma、ere-kanon、ere-example 所需槽位数未超过引擎默认范围，因此未设置 saveFiles。erauma 还会通过 era.get('gameconfig')?.system.saveFiles 读取生效配置，但 4.8.0 不提供 gameconfig 键，本项目不能使用这一方法。

yml/ 文件是静态数据的唯一来源，由人工维护（issue #10 迁移后接续）。键名一律加引号，避免含 :、# 或首尾空格的键产生解析问题；名称用简体（tools/lang-table.js，issue #60），引擎列名键如 素質/名前 保持原样。

引擎 API 与硬约束

• 一切能力来自 require('#/era-electron')，权威清单 dev-guides/A-api-docs.md。分组：输出（print / printAndWait / printMultiColumns / printInColRows / printButton / printImage）、输入（input / waitAnyKey）、变量（get / set / add）、存档（saveData / loadData / saveGlobal）、角色（getAllCharacters / addCharacter / beginTrain / endTrain）、媒体（playMusic）、日志（logger.*）。

• 手册与实测行为冲突时，以引擎代码为准。 dev-guides/ 是本项目根据 app.asar 修正过的手册副本。发现差异后直接修正文段，不另建勘误表；上游原文可从 Git 历史查看（#163）。新确认的引擎行为按 tools/engine-contract-facts.mjs 文件头的说明增加检查：能直接执行的行为加入 engine-bundle 测试；只能通过源码片段定位的行为加入 anchors 表。

• 游戏运行时仅可使用 era API 与 crypto。 引擎禁止导入其他 Node 内置模块和第三方库（dev-guides/18-tools.md）；tools/ 中的离线脚本不受此限制。

• 异步 API 必须 await：printAndWait、input、clear、waitAnyKey、delay、存档系列。漏 await 造成的时序错乱极难排查。

• 变量以字符串寻址：era.get('base:0:0')、era.get(`staticcflag:${cid}:1`)，也支持列名 era.get(`static:${cid}:name`)。读取未声明的序号返回 undefined，不是 0（issue #13）；在名字表和数据容器存在时，写入未声明的下标不会报错，且会进入存档。因此必须检查下标是否正确，包装层的 getter 按项目约定使用 || 0 处理缺值。

• 文件编码用 UTF-8 或 UTF-8 BOM。

• 写变量前，先确认它所属的静态表已存在于 yml/。 setVar 的行为由名字表和 data 容器是否存在共同决定，与地址是两段还是三段无关（PR #57）：两者都存在时写入成功，未声明下标按数字处理；只有名字表时静默丢弃写入；只有数据容器时直接崩溃。已出现过的问题包括 item*（PR #34）和 stain、ex、cstr、tequip、tflag（PR #57）。test/static-table-coverage.test.js 会提取源码中的变量类别并检查对应表，但只能识别 era.get/set/add 的字面量前缀；动态拼接的地址仍需人工检查。

• 首次使用输出 API 前，检查引擎渲染层对参数的处理。 手册未必描述最终显示效果，测试夹具也不完整模拟渲染。例如，printButton 的 showAcc 默认为真，引擎会添加 [快捷键] ，并将正文中的连续空白合并为一个空格。按钮正文不得自行添加 [编号] 前缀，否则会显示为 [0] [0] 旧的奴隶（PR #30）。 在 ~/.era-engine/app.asar 中按 API 名或配置项名搜索，可找到 bundle 附带的未压缩源码。确认渲染规则后，将需要验证的结果补充到 test/helpers/era-fixture.js 的记录字段，并增加断言。

• 验收时必须确认引擎实际执行了调用。 夹具只能记录 API 调用，无法证明引擎接受了参数；例如，addCharacter 遇到不存在的预设角色会直接返回 false（#21/#22）。test/helpers/engine-bundle.js 直接加载 app.asar 中的解析器、装载循环和 EraApi 方法，只为调用方法提供最小的模拟 this，避免在测试中重新实现引擎逻辑。ASAR_CANDIDATES 按环境变量 ERE_ENGINE_ASAR → 仓库内路径 → ~/.era-engine/ 的顺序查找文件；找不到时跳过相关测试并输出警告。

  查找列表目前分别维护在三个文件中：test/helpers/engine-bundle.js、tools/mutation-check.mjs、tools/engine-contract-check.mjs。test/asar-candidates.test.js 检查三处是否一致。~/.era-engine/ 路径供 worktree 和并行变异测试副本共用：仓库内的 ere-4.8.0-win-x64/ 不受 Git 跟踪，不会被复制到这些目录，缺少用户目录查找路径会导致引擎测试被跳过（#113）。

  • 通常不必设置 ERE_ENGINE_ASAR。 在新机器上，将 Release 中的文件放到 ~/.era-engine/app.asar，并按 .github/actions/setup-engine/action.yml 校验哈希即可。
  • 检查无引擎基线时，必须设置 ERE_ENGINE_ASAR=none。 三处均将这个值解释为禁用引擎查找；仅删除环境变量仍会找到用户目录中的引擎，不能模拟无引擎环境。

代码约定

格式由 .eslintrc.js 与 .prettierrc 约束，无须记忆。以下是格式之外、参照 erauma 的工程约定：

• 文件名 kebab-case 带类别前缀：sys-calc-*.js（系统计算）、page-*.js（界面）、*-factory.js（工厂）、calc-*.js / *-utils.js（工具）。

• 文件名一律使用 ASCII，描述部分用英文单词。 例如 kojo-k3-noble.js、stronghold-2.mp3，不用日文罗马字或中文拼音代替翻译。人名无对应英文词时使用拉丁转写（菲娅 → fia）。口上文件按同一约定命名。

  • 资源的注册名不跟着改：res/*.csv 是「注册名,文件名」两列，注册名是 ere/ 里调用点正在使用的名字（如 era.playMusic('据点2.mp3')），不跟着磁盘文件名一起改；调用点按注册名取用资源，一行不动。

• 标识符 snake_case（get_display_name、birth_list）；引擎 API 自身是 camelCase（era.printMultiColumns）。

• 模块引用 ere/ 内一律用 #/ 别名，引擎原生解析、无需构建步骤；别名不覆盖 tools/、test/，那些目录之间用相对路径。

• 导入分组排序：era 置顶，其后 system / page / event / chara / kojo / facade / utils / data / i18n（chara = 角色域代码，如 #/chara/chara-ex，T6 引入；kojo = 口上模块，独立顶层目录，#46 起存在；facade = 按域门面，#71 起存在）。

• 必须注释变量的含义。 仅凭 era.get('global:3') 无法判断该下标代表什么：

  // GLOBALNAME:3 = 语言
  set_lan(era.get('global:3') || era.set('global:3', 'zh-CN'));

• 注释只写「为什么这样写」。 不写来源标注（外部文件路径、行号），不写「同某处一致」这类脱离当前代码的说明；提到函数名时用当前代码的函数名，解释性注释用当前代码自身能说明的说法，例如「游戏提供 99 个手动存档槽」。口上里的日文分支注释（それ以外、初めて 等）是分支标记，保留。

• 金额提示中的字面量 $ 保留。 游戏内金额按 $ 加数值的格式显示（如 所持金：$800点），JavaScript 模板串要写成 `所持金：$${era_flag.money}点`——只写一个 $ 会把它用作插值语法，输出里就少了货币符号。ESLint 发现不了这类语义差异，测试必须断言实际输出（#338 发现，M7700 验证对应测试能检测该错误）；其余金额提示（如生活费的扣款提示）同样处理。

• 玩家可见文本一律使用简体（issue #60）。字符映射、词语译法和整串豁免分别维护在 tools/lang-table.js；直接写简体，检查报错时按表手工改正。以下检查共同验证结果：

  • test/output-lang-lock.test.js 扫描 ere/ 字符串字面量和 yml/ 文本，检查归一表中的非简体字，以及 tools/lang-simp-ref.js 中的繁体字；后者由 OpenCC 字表派生，补充归一表未收录的字符（#188）。引擎列名按清单豁免。未收录的日文新字体仍需通过归一表处理；假名按字符区间检查。
  • 新增字符映射或词条只在检查漏报、误报时进行，提交说明写明触发它的文本位置。

• 提交信息 用 Conventional Commits，scope 按子系统划分（train / ero / event / chara / page / data / util）。

参考资料

引擎手册 dev-guides/，25 篇简体中文，文件名即主题。三篇从文件名看不出内容的：A-api-docs.md 是 API 权威清单，18-tools.md 讲开发套件与依赖限制，E-erauma-train.md 讲 EraUma 的调教系统设计思路。

开源参考项目（gitgud.io）：

erauma 的 ere/ 分层可直接借鉴：data/（静态数据）、event/（事件）、page/（界面）、system/（系统逻辑，按域再分子目录）、utils/（工具）、i18n/（多语言）。但代码层面以 ere-example 与 ere-kanon 为范例：官方明确提醒 EraUma 代码缺注释、缺类型检查（dev-guides/E-erauma-train.md），它只值得参考设计思路与工程组织。

技能与流程文档

工单流程

流程文档分两份：主 agent 分配任务、验收与合并按 docs/agents/dispatch-sop.md（Paseo 用法、并发上限、profile 选用、提示词开场模板、验收清单与阶段验收）；执行工单的 worker 按 docs/agents/worker-sop.md（先写测试、用 /code-review 做审查、自己开 PR 等 CI、在 issue 下写完成评论）。

Issue 跟踪

工单在 odradekk/maou_redux 的 GitHub Issues 上，用 gh CLI 操作，每条命令都要显式带 --repo odradekk/maou_redux。见 docs/agents/issue-tracker.md。

分类标签

五个标准分类标签，标签字符串与名称相同。见 docs/agents/triage-labels.md。

领域文档

术语统一维护在根目录的 CONTEXT.md，架构决策记录在 docs/adr/。维护规则见 docs/agents/domain.md。