Game Studio Harness
Game Studio Harness（GSH）是面向完整游戏制作流水线的四层上下文操作系统。它把大模型代理接入制作与方向、策划、工程、品质、美术音频与活服运营。本轮范围写在文件合同里。技能按步打开。默认写入隔离面。正式面回写须制作方批准。
设计逻辑是能力边界隔离、技能蒸馏、任务编排、上下文预算注入。人闸与沙箱晋级是实现这些逻辑的机制，见 工程实践。
策划职种共 11 条，两组并列：系统策划、战斗策划、战斗数值、经济数值、养成数值、商业化、活动；以及关卡策划、剧情策划、文案策划、交互策划。
适用对象：制作人、技术总监、主策划、主程序、品质与美术负责人，以及在同一业务根上协作的 AI 编程工具。
定档 → 切片 → 隔离制作 → 验收 → 晋升
English · 设计哲学 · 原则、范围与运行模型 · 仓库内容 · 库存盘点 · 部门能力地图 · 技能从何而来 · 工程实践 · 要解决的问题 · 关键概念 · 指南 · 平台支持 · 文档 · 前置条件 · 安装
设计哲学
四条设计逻辑决定文件怎么切、上下文怎么进、回合怎么走。人闸、隔离面、沙箱晋级是机制，写在 工程实践。
能力边界隔离
职种、技能、写入面各自声明能力边界。职种文件给出步骤序列与岗位职责。技能文件给出单步程序与输入输出。正式面与隔离面由 .harness/surfaces.json 声明。
本轮工作停在已点名范围内。跨边界移交走 handoff-pack、现行卡与 loadplan.json。下游职种读交接文件；同一回合不覆盖对方正式面。
技能蒸馏
现场流程压成可复用的 SKILL.md：检查表、表写入配方、灰盒与节拍验收、契约与提测口径。职种只排顺序。做法正文在技能里。点名一条技能，打开的是带输入、输出与不合格回退的程序。来源与覆盖见 技能从何而来。
任务编排
制作回合按固定回路推进：检索 id（menu）→ 写合同并激活（activate）→ 执行当前步（next）→ 验收关项（close）。状态写在业务根 .harness。更换客户端后读同一份现行卡。编排对象是文件与命令。聊天记录不作为进度源。
上下文预算注入
上下文窗口按预算分配。开场注入宪法、现行卡、已激活技能或职种正文。catalog.json 供 gsh menu 检索。retrieve_keys 命中后才打开 canon / adr。职种路径只打开 craft_open；其余步骤做到该步再注入。磁盘档位 minimal / core / full 决定投影范围，不决定本轮注入量。
优势与局限
收益。 晋升路径可对照 diff：隔离面写入，人准后只回写记录集。短步可按 verify-report 核验。跨工具共用档案柜。技能可版本化、可复用。点名集合限制本轮改写面。
代价。 架构依赖人闸，因此没有无人值守发版。短步增加会话次数与交接成本。技能质量取决于蒸馏是否跟上现场；过期检查表会把错误做法固化。适配器对等程度因宿主而异：Cursor 与 Claude Code 接入事件钩子；其余工具走 CLI 与 HOOKS.md，开场注入与关项闸的完整度不同。本仓不配送可连接 MCP 进程，表格等外接须本机自备。
下列公开评测百分比属于原文，不是本工作室实测成功率。依据见 威胁与限制。
原则、范围与运行模型
读完设计逻辑再看职种地图。本节给出原则、覆盖边界、运行回路，以及公开评测对长程自主的约束。
核心原则
四层合同分层生效。宪法规定读序、写隔离默认、关项命令、密钥与破坏闸。导演把诉求写成 loadplan.json 并点名 id。能力库按步打开技能。档案柜保存进度与证据。
点名集合决定开场注入。过程中缺技能可当场打开，不必先改名单重生。
职种不预展开 uses_skills。gsh next 前进一步并回写现行卡。
写级别默认 sandbox。晋升须人准，且只回写记录集。
密钥不进仓库，也不进模型上下文。不可逆破坏须本轮明确授权。
范围与非目标
范围。 完整游戏制作流水线。现行 catalog：35 / 35 职种、106 / 106 技能。
策划 11 条，两组并列：
- 系统策划、战斗策划、战斗数值、经济数值、养成数值、商业化、活动
- 关卡策划、剧情策划、文案策划、交互策划
其余：制作与项目管理 4、工程 6、美术与技美 9、QA 5。点名一条路径只打开当前步。未点名职种留在菜单，需要时再激活。
完整职种表：docs/crafts/index.md。完整技能表：docs/skills/index.md。音频事件与 Bank 构建是技能（audio-fmod-checklist、fmod-bank-build），挂在技美 / 管线步骤上。
非目标。 不承担无人值守发版。不配送游戏引擎、DCC 或可连接 MCP 服务器。不把 .harness 做成知识图谱。不把 catalog.json 写入系统提示。第三方打包不在维护范围。
运行模型
人机分工写在运行模型里。晋升正式面是制作流程。AI 在已激活集合内工作。关项须过验收闸。
回路：menu → activate → next → close。岗位职责不同时按职种开子代理；主会话点名与收口。
威胁与限制
公开评测给出同一形态：任务变长、人闸变少时，无闸长程自主的成功可靠度沿 logistic 下降。同一模型换 Harness 后成绩可差数倍（下表有约 6× 的同模型对照）。GSH 据此选择短步与人闸。左轴数字只复述被引文献的区间。
成功概率随「人类专家完成该任务所需时间」下降。METR 用 logistic 拟合；50% 时间地平线自 2019 年起约每七个月加倍。80% 地平线大约短五倍。杂乱、欠规格任务上成绩更低。
成功概率（METR 公开区间；非 GSH 实测）
~100% │●
│ ●
~50% │ ●········ 50% 时间地平线（约每 7 个月加倍）
│ ●
~10% │ ●●
└────────────────────────────→ 人类专家完成该任务所需时间
< ~4 分钟 > ~4 小时
依据（百分比均属原文，勿当作 GSH 产线 KPI）：
- Anthropic：评「代理」= Harness + 模型；SWE-bench Verified 约一年内从 ~40% 到 >80%。https://www.anthropic.com/engineering/demystifying-evals-for-ai-agents
- SWE-Bench Mobile：最好约 12%；同一模型 Cursor ~12%、OpenCode ~2%（约 6×）。https://arxiv.org/abs/2602.09540
- Harness 消融：收紧上下文窗口时，上下文管理贡献最大（主要来自避免溢出失败）。https://arxiv.org/abs/2609.20804
- METR：人类任务 <~4 分钟时成功率约 100%，>~4 小时时 <~10%；50% 地平线约每 7 个月加倍。https://metr.org/blog/2025-03-19-measuring-ai-ability-to-complete-long-tasks/
- LongCLI-Bench：自主通过率 <20%；注入计划约 58%；计划 + 交互约 62%。https://arxiv.org/abs/2602.14337
- SWE-Marathon：pass@1 <30%；13.8% 的 rollout 出现 reward-hack 尝试。https://www.swe-marathon.org/
- Chen 等：相对副驾驶，代理条件正确率高约 35 个百分点，用户耗时约一半。https://arxiv.org/abs/2507.08149
- CentaurEval：该协作必要题上，LLM 单独 ~0.67%、人单独 ~18.89%、人机协作 ~31.11%。https://arxiv.org/abs/2512.04111
仓库内容
game-studio-harness/
├── skills/ # 106 技能（唯一内容源）
├── agents/ # 35 职种路径（唯一内容源）
├── rules/ hooks/ harness/ # 宪法、钩子、运行时、菜单
├── gsh/ # setup / sync / verify / menu / status / next / close
├── studio/.harness/ # 业务根脚手架
├── .cursor/ .claude/ … # 各工具原生约定（仓库内不复制技能全树）
└── docs/ tests/
安装后，共享运行时位于 ~/.gsh（隔离试装则为 <isolate>/gsh）。每个选中的工具家目录再得到一份该工具可识别的完整原生树。
库存盘点
权威来源是 catalog.json（gsh menu 扫描仓库根 agents/ 与 skills/ frontmatter）。下列清单与唯一内容源 agents/（35）和 skills/（106）一致。
职种 35
技能 106
职种 uses_skills 覆盖 85 个事件技能。其余 21 个不挂在任何职种路径上，放在 横切能力：assemble-craft-flow、attr-family-sync、audio-fmod-checklist、build-acceptance、build-gate-checklist、collab-protocol、data-readiness-check、deliverable-sheets、diagram-pack、doctor、excel-format、excel-read、fmod-bank-build、mcp-autostart、memory-retrieve、naming-consistency-check、personal-server-table-sync、promote-adr、terrain-gaea-pass、verify-gate、write-isolation。
完整 id 见下方各部门技能表；能力地图保证 35/35 职种、106/106 技能各至少出现一次。蒸馏口径见地图后的 技能从何而来。
外接 36
accurig · audacity · blender-mcp · cascadeur · chrome-devtools · cloudcompare · docker-mcp · everything-search · excalidraw · excelMCP · ffmpeg · fmod-cli · fmod-studio · gaea · gamedev-mcp · gimp · imagemagick · inkscape · instant-meshes · krita-mcp · lark-mcp · ldtk · magicavoxel · materialize · materialpilot · meshlab · meshroom · miro · pureref · renderdoc · rokoko · roslyn-mcp · tiled · treeit · xmind · xnormal
核心档默认直连 excelMCP；其余懒接，第一次调用再拉子进程。见 MCP 政策。本仓配送 0 条活服务器、36 条用途桩。
部门能力地图
能力地图按工作室部门分块。每个模块包含：（1）该部门在制作管线中的位置；（2）全部职种路径——每一步意图与打开的技能；（3）相关技能的做法、时机与输入输出；（4）一条典型竖切如何用 menu / activate / next / close 穿过这些文件。
会话命令与脚本对应关系：
1. 制作与项目管理
制作部门把方向、容量、依赖和验收收成可跟踪的合同。制作人定目标与发版口径；执行制作人拆包催收；项目管理维护风险与依赖图；创意总监冻结支柱并裁决体验冲突。没有这一层，下游职种会在未批准的范围内改正式面。
职种路径
producer（制作人） — 里程碑目标、构建验收推动、发版说明与跨职种制作推动。
常挂：route-task · milestone-plan · release-notes-stub · sync-state · handoff-pack · file-pack-layout。
associate-producer（执行制作人） — 拆交付包、跨组协调、阻塞闭环、验收前齐套催收。
project-manager（项目管理） — 风险台账、依赖图、定期状态摘要与纠偏选项。
creative-director（创意总监） — 体验支柱、切片批注、fantasy 冲突裁决、scope-cut 原则。
相关技能
典型竖切
里程碑「可玩战斗灰盒」开项：menu 刷新 catalog.json。制作人 activate 点名 producer + creative-director（岗位不同则开子代理），route-task 写入 T2/sandbox。next 先走 pillar-define，再 milestone-plan 拆包给执行制作人；PM 子代理跑 risk-register-update 与 dependency-map。齐套日 status-digest + sync-state。close 核里程碑页、支柱文档与齐套核对表，写 verify-report.json；发版周再激活 release-notes-stub。
2. 策划
策划覆盖 catalog 中全部 11 条职种，两组并列：系统设计与数值（7）与关卡、叙事、文案、交互（4）。成长曲线由 progression-numeric-designer 主笔（progression-curve）；战斗数值主笔属性、公式、克制与技能系数。
职种一览（11）
每条职种在下方有完整路径表（步骤、意图、打开的技能）。
系统设计与数值
系统策划锁规则与接口；战斗策划锁流程与技能组；三路数值分别主笔战斗公式、经济循环与养成曲线；商业化与活动把付费点、活动日历接到同一套实体与开关上。改表一律走读取 → 沙箱写入 → 格式 → diff → 人准晋升。
职种路径
systems-designer（系统策划） — 系统索引、功能 GDD 切片、规则可行性预检、Canon 提案。
combat-designer（战斗策划） — 战斗流程、技能组、手感验收清单。
combat-numeric-designer（战斗数值策划） — 属性、公式、克制、技能数值；改表走写入配方。
重型模拟前先跑 data-readiness-check。
economy-numeric-designer（经济数值策划） — 产销循环、物价、通胀、表晋升。
progression-numeric-designer（养成数值策划） — 成长曲线、解锁节奏、产销接口、属性挂接。
monetization-designer（商业化策划） — 付费点、IAP/礼包/通行证目录、商业化 KPI 口径。
liveops-designer（活动策划） — 活动日历、活动规格、奖励邮件安全检查。
相关技能
典型竖切
「新职业技能组可结算」：menu 后 activate 点名 combat-designer 与 combat-numeric-designer（两只子代理），T2/sandbox，retrieve_keys 指向公式 Canon。战斗策划 next：combat-flow-design → skill-kit-design → combat-feel-checklist。数值策划 next：combat-modeling → attribute-framework → damage-formula-pass → skill-numeric-pass，写入走 excel-com-write。会签后 tunable-table-diff。close 核 kit slots_version、公式 order_version、沙箱 diff 与试玩短片。经济/养成改表同一配方，另开会话点 economy-numeric-designer 或 progression-numeric-designer。
关卡、叙事、文案与交互
本部门把「玩家在空间与故事里经历什么」写成可检测目标、可挂门闸的节拍、可绑定的任务状态机、以及带五态的 UX 流图。关卡策划主笔目标链与遭遇；叙事策划主笔 beat 与 lore；文案策划统一术语与字数；交互策划把系统状态机翻译成可走查的信息架构。灰盒尺度与场景美术共享，文案键与 UI/错误码预留。
职种路径
level-designer（关卡策划） — 关卡目标链、灰盒动线、遭遇编排、节奏峰谷。
narrative-designer（剧情策划） — 节拍表、任务规格、对白规格、世界观一致性。
copywriter-designer（文案策划） — 系统/引导文案、对白润色、命名一致性、字数适配。
ux-designer（交互策划） — 信息架构、UX 流图、可用性走查。
相关技能
典型竖切
「第一章可教战斗门闸」：activate 点名 level-designer 与 narrative-designer。next：narrative-beat-sheet 给出门闸 beat → level-goals-spec 写可测目标 → blockout-pass 验证尺度 → encounter-script + pacing-pass。叙事侧 quest-spec 接检测器，lore-consistency-check 扫命名。文案子代理 copy-pass / dialogue-pass。UX 子代理 ux-flow-spec → ux-review-pass。close 核目标链、beat 挂点、灰盒可走通记录与流图五态。
3. 客户端与服务端工程
工程部门把已冻结的接口做成可构建的竖切：客户端打通主路径与失败态，战斗客户端对齐帧与预测回滚，UI 客户端维护导航栈与红点，服务端冻契约/存档/反作弊，战斗服务端守结算权威，工具工程把导出与校验收成可 CI 的 CLI。权威数字不在客户端回调里终裁。
职种路径
client-engineer（客户端开发工程师） — 非战斗功能竖切、缺陷修复、通用 UI 逻辑协作。
client-combat-engineer（客户端战斗开发工程师） — 帧同步/判定表现、技能接入、预测回滚。
client-ui-engineer（客户端 UI 开发工程师） — 界面逻辑、导航栈、红点。
server-engineer（服务端开发工程师） — 契约 → 实现校验 → 存档迁移 → 反作弊挂点 → 冒烟。
server-combat-engineer（服务端战斗开发工程师） — 战斗权威、结算校验、反作弊协作。
tools-engineer（工具开发工程师） — 管线工具规格、导出修复、CI 工具入口。
相关技能
典型竖切
「技能可放、可结算、可回放」：activate 点名 client-combat-engineer 与 server-combat-engineer。服先 server-combat-authority-check + server-api-contract；端 next feature-vertical-slice 再 client-combat-frame-debug。工具侧若导出阻断，另开会话点 tools-engineer 走 export-pipeline-fix。close 核权威清单、契约测、竖切失败态、结算单测与 ci-smoke 日志。非战斗功能竖切改点 client-engineer + server-engineer（save-schema-pass）。
4. 美术与技术美术
美术部门从可检验的风格锚走到可引用的引擎路径。原画交可制作 Brief；角色/场景生产过清单与命名门禁；UI 维护 Kit 合同与四态屏；绑定与动画把骨架、权重、事件帧交给战斗与特效；技美把导入、LOD、Shader、VFX 预算收成可抽检的规范。概念未批不开生产模；灰盒未过不换高模。
职种路径
character-concept-artist（角色原画师） — 角色视觉设定与可制作 Brief。
character-artist（角色美术） — 角色资产清单与导出规范。
environment-concept-artist（场景原画师） — 场景/道具概念与空间气质。
environment-artist（场景美术） — 场景资产清单与空间表现。
ui-artist（UI 美术） — UI Kit 与界面视觉 Pass。
vfx-artist（特效） — 特效预算与技能挂点对齐。
animator（动画） — 动画集完整度与事件挂点。
rigger（绑定师） — 骨骼绑定、蒙皮权重、变形校验。
tech-artist（技术美术） — 导入校验、命名门禁、LOD/Shader 与性能预算衔接。
开放世界地形程序化另挂横切技能 terrain-gaea-pass（Gaea），不单设职种。
相关技能
典型竖切
「主角可进战斗装配」：activate 点名 character-concept-artist → 批准后另会话点 character-artist → rigger → animator → vfx-artist；技美在导入红灯时点 tech-artist。next 顺序：style-anchor → concept-key-art → character-asset-checklist → export-naming-gate / import-validate → bind-rig-checklist → skin-weight-pass → anim-set-checklist → anim-event-hook → vfx-skill-hook / vfx-budget-pass。close 核 Brief、导入路径、挂点表、事件字典与预算截图。场景线把 environment-concept-artist 的 Brief 交给 environment-artist，先决 blockout-pass。
5. 品质保障 QA
QA 把「能过」收成可观察的开测/收测条件与证据包。负责人主笔计划与豁免；功能测试从 GDD 抽 GWT；测试开发把高价值用例接到稳定脚手架；兼容测 N/N-1 与机型矩阵；性能对照预算复采。验收当天不改口径装绿。
职种路径
qa-lead（测试负责人） — 测试计划、验收口径、风险豁免治理。
qa-functional（功能测试工程师） — 功能用例、缺陷单、回归包。
qa-automation（测试开发工程师） — 自动化脚手架、用例-脚本映射、CI 冒烟稳定。
qa-compatibility（兼容测试工程师） — N/N-1 存档与协议、机型矩阵、机型特异缺陷。
qa-performance（性能测试工程师） — 性能预算实测与报告；认证仅协作条款短项。
相关技能
典型竖切
版本提测：activate 点名 qa-lead（T2/read 或 sandbox）。next：qa-plan 批准后分派——功能子代理 test-case-from-gdd → bug-report-write → regression-pack；自动化 auto-test-scaffold → case-automation-map；兼容 device-matrix-pass → compat-smoke；性能 perf-budget-check。Lead artifacts-append 收证据索引。close 核开测/收测条件、致命缺陷列表、豁免时效与 verify-report.json。构建阻断盘点走横切 build-gate-checklist，主路径验收走 build-acceptance。
6. 横切能力 / 运行时与档案
下列技能不挂在任何职种 uses_skills 上，但制作会话依赖它们才能定档、隔离写入、检索记忆、关项与补齐部署。它们是运行时与档案柜的牙齿，不是「边角工具」。音频与地形暂无专职种，做法仍在能力库中，由制作人在加载计划里显式点名。
模块在管线中的位置
横切技能在四层之间搬运合同：开场拉外接、对照菜单补缺口、按推荐序拼执行单、把正式面写入推进隔离根、按键检索 Canon、关项只核核心证据。数值职种路径会引用 attr-family-sync / data-readiness-check / excel-read / excel-format，但这些 id 必须在加载计划里单独点名才会进入开场名单。
职种关系
横切层没有独立职种 id。任何职种都可以在 loadplan.json 的 items 里点这些 skill。制作人常用 route-task（职种路径内）配合本层的 doctor、assemble-craft-flow、verify-gate、write-isolation。
技能分组
运行时与菜单
写隔离与表格配方
记忆、协作与通用表
构建、验收与关项
音频与地形（无专职种，显式点名）
典型竖切（横切命令本身）
任意部门开项前：menu（刷新菜单.py，菜单旧于源时开场钩子也会后台刷新）。activate 写 loadplan.json（含 write_isolation 与 verify-gate 两项）并生成名单。需要检索既往结论时点 memory-retrieve；改正式面前先打开 write-isolation 与 excel-read。执行类事件 ≥ 3 时 next 走 assemble-craft-flow。部署或握手失败跑 doctor + mcp-autostart。close 只认 verify-gate 报告；架构选型另点 promote-adr。
技能从何而来
技能是从真实工作室流程里蒸馏出来的做法。制作、策划、程序、美术、QA 在产线里已经用过的检查表、表写入配方、灰盒与节拍验收、契约与提测口径，被压成带输入/输出与不合格回退的 SKILL.md。职种文件只排步骤顺序；做法正文在技能里。点名一条技能打开的是带输入、输出与不合格回退的可执行程序。
菜单 106 条是现行蒸馏结果。新流程先写成技能，再挂进职种路径。完整表见 docs/skills/index.md。能力库层说明见 docs/architecture/l3-capability.md。
工程实践
人闸与沙箱晋级落实设计逻辑，本身不是设计哲学。
人工闸门
下列决策改变玩家体验或商业结果，由制作方签字：体验支柱与 fantasy 调性、砍范围、正式面晋升、活服经济与 IAP 定价、不可逆破坏、密钥保管、法务合规、发版。模型代签无效。
代理在短步上产出选项、清单与隔离面 diff。关项命令是 gsh close。Cursor stop 与 Claude Code Stop 核验同一份 verify-report.json。其他工具走 CLI 与 HOOKS.md。探测会话以 _ 开头，不覆盖 LATEST。
沙箱晋级
默认 write_class=sandbox。模型只在 .harness/surfaces.json 声明的隔离根上执行。策划表、引擎资产与已提交历史的回滚成本由制作方承担。
晋升是制作流程：须人准，且只回写记录集，便于对照 diff。禁止整文件覆盖正式面。gsh close 通过后才具备晋升条件；通过验收不等于已写入正式面。
密钥不得进入仓库，也不得进入模型上下文。mcp.json.example 仅含占位符。安装器不覆盖已有 mcp.json。不可逆的 Git 与批量删除须人工确认。MCP core 是握手名单；lazy_stdio 在首次 tools/call 时再拉起子进程。
要解决的问题
以下是制作现场反复出现、且无法靠单次提示词稳定处理的问题。GSH 用四层文件合同与 CLI 处理它们。
上下文预算被菜单占满。 一次把 106 条技能与 35 条职种全文注入对话后，模型会在同一步同时改公式、谈存档、改正式表。GSH 将 catalog.json 作为导演检索菜单（gsh menu），开场只注入宪法、现行卡与已指定正文。
多工种路径被一次性展开。 关卡从目标链到灰盒、剧情从节拍到任务门闸、养成从锚点到成长曲线、战斗数值从锚点到系数表，都有固定顺序。若点名职种即读完全部 uses_skills，第一步会按最后一步的口径填表。GSH 只打开 craft_open，由 gsh next 前进。
正式面与草稿混写。 策划表、引擎资产与已提交历史回滚成本由制作方承担。GSH 默认 write_class=sandbox，正式面回写需制作方批准，且只回写记录集。
会话中断、客户端切换后丢失进度。 聊天记录不是档案。进度写在 current.md、state.json、tasks.jsonl；任意已安装工具上可用 gsh status / gsh resume 读取。
缺少可归档的验收记录。 「感觉可以」无法进入发版材料。gsh close 按模板写出 verify-report.json（verify_kind、evidence_paths、verdict），并追加审计流水。
外接进程在 IDE 启动时全部握手。 数十个 MCP 的 tools/list 会拖垮启动并占用上下文。GSH 只对 mcp-tiers.json 的 core 档位键做开场握手，其余懒加载。本仓不配送活服务器。
密钥进入模型上下文；破坏性命令缺少确认。 Cursor 与 Claude Code 在读取与 Shell 前拦截常见密钥路径，并对 git reset --hard 等操作要求确认。
关键概念
[制作诉求]
→ gsh menu 指定 id
→ loadplan + activate
→ 当前步骤技能
→ 隔离面执行
→ gsh close
→ 制作方批准后晋升
指南
下列命令可换成任意职种 id。完整路径见 部门能力地图。已写成 cookbook 的战斗数值竖切仍可用；关卡、剧情、养成、经济、系统、QA 用同一条 menu → activate → next → close 回路。
定档并走一步
python -m gsh setup --workspace /path/to/studio --tools cursor --profile core --yes
cd /path/to/studio
python -m gsh menu --kind craft -q 关卡
# 也可检索：系统策划 / 剧情策划 / 养成数值 / 战斗数值 / 经济 / QA
编写 .harness/sessions/<会话>/loadplan.json，在 items 中指定一条职种，例如 level-designer、systems-designer、narrative-designer、progression-numeric-designer、economy-numeric-designer 或 combat-numeric-designer。成长曲线点 progression-numeric-designer（技能 progression-curve）。
python -m gsh activate <会话>
python -m gsh resume
# 打开 craft_open 所指技能，在隔离面改表、灰盒笔记或切片草稿
python -m gsh next --craft <职种id>
python -m gsh close --kind schema --evidence .harness/sandbox/<笔记>.md
activated.json 中的 craft_path 显示如 2/9 的进度。现行卡与 state.json 保持同步。制作方批准后再回写正式面记录格。
战斗数值逐步说明：docs/cookbook/combat-numeric-slice.md。文档地图：docs/README.md（架构、适配器、cookbook、发版）。
更换客户端后续作
在 Cursor 完成定档后，于另一客户端打开同一业务根：
python -m gsh status --workspace /path/to/studio
python -m gsh resume --workspace /path/to/studio
两端读取同一套 .harness。Cursor 在 sessionStart 注入现行卡摘要；Claude Code 的 settings.json 调用同一 hooks/开场.py。
导演检索，不注入菜单全文
python -m gsh menu --kind skill -q excel
python -m gsh menu --kind craft -q qa
输出为 id 与一行 description。不要将 catalog.json 写入系统提示。开场钩子若检测到菜单全文进入上下文，会改写为提示使用 gsh menu。
平台支持
每个选中的工具均获得完整的技能/职种树，以及该工具已支持的入口文件。
CLI 可在上述工具对应的业务根上执行。事件钩子运行时目前接入 Cursor 与 Claude Code。
分篇说明：docs/adapters/。
开始使用
打开业务根，不要只打开本仓库。将 .harness/surfaces.json 中的占位符改为本机路径；不要把真实盘符提交回 GSH 仓库。
gsh menu -q 关卡
# 或：系统策划 / 剧情 / 养成数值 / 战斗数值 / QA
→ 编写 loadplan.json（指定一条职种 id）
→ gsh activate <会话>
→ 阅读 current.md，只执行当前步骤
→ gsh next
→ gsh close --evidence <隔离面产物>
→ 制作方批准后回写正式面记录格
CLI
python -m gsh setup | sync | verify | doctor | uninstall
python -m gsh menu [--kind craft|skill] [-q 词]
python -m gsh activate <会话>
python -m gsh status | resume
python -m gsh next [--craft <id>]
python -m gsh close --kind smoke --evidence <路径>
MCP 政策
本仓配送 0 条活服务器、36 条用途桩，以及 mcp.json.example。mcp-tiers.json 的 core 是开场握手名单。excelMCP 出现在 core 中，表示表格管线需要该档位键；本机服务器仍须自行安装。实际拉起走 lazy_stdio。
上下文预算
安全
- 密钥不进入 Git。
mcp.json.example仅为占位符。 - 安装器不覆盖已有
mcp.json。 - Cursor / Claude Code 拦截常见密钥路径。
- 破坏性 Git 操作需要确认。
verify与tests/test_no_secrets.py扫描用户主目录绝对路径、Harness-Apps、token 前缀、私钥头、webhook、非示例邮箱。- 漏洞请使用 GitHub 私密报告，见 SECURITY.md。
排障
测试
python -m unittest discover -s tests -v
覆盖菜单解析、职种路径不预展开、密钥扫描、原生树投影、隔离 CLI，以及 menu / activate / next / close 回路。
贡献
见 CONTRIBUTING.md · SUPPORT.md。
- 技能只修改
skills/<id>/SKILL.md。 - 职种只修改
agents/<id>.md。uses_skills为序列，由gsh next前进。 - 新增 MCP：用途桩 + 占位符。不提交可连接服务器或密钥。
- 新增职种或技能后，两份 README 的部门能力地图都要补上对应 id（35/35、106/106）。
- 变更四层须先转向并撰写 ADR。
- PR 须在隔离根上
verify通过，且unittest通过。
0.1 布局中的 cursor/skills 等重复树已删除。在仓库根修改后执行 sync。
前置条件
环境与工具链，与设计逻辑分开陈述。
- Python 3.11+。Windows 是游戏生产环境的一等目标平台。Linux / macOS 用于隔离试装与 CI。
- 打开业务根，不要只打开本仓库。将
.harness/surfaces.json中的占位符改为本机路径。不要把真实盘符提交回 GSH 仓库。 - 安装器只投影架构文件与技能。不附带游戏引擎、DCC 或其它制作软件安装包。不写入密钥。
- 只从官方仓库或该仓库的 GitHub Release 安装：github.com/limoaCatherine/game-studio-harness。第三方打包不在维护范围。PyPI 尚未发布。
- 内容只在仓库根修改：
skills/agents/rules/hooks/harness/。wheel 将这些目录打进包内，pip install ./pipx install .之后不必保持 clone。
安装
git clone https://github.com/limoaCatherine/game-studio-harness.git
cd game-studio-harness
python -m pip install .
gsh setup --guided
Windows：py -3.11 -m pip install .，然后 gsh setup --workspace <studio-root> --yes。
非交互：
gsh setup \
--workspace /path/to/studio-root \
--tools cursor,claude \
--profile core \
--yes
--tools all（默认）为 19 个客户端各写一套完整原生树。legacy = cursor,claude,codex,grok,deepseek。
隔离试装（不写入真实家目录）：
python -m gsh setup \
--isolate-root /tmp/gsh-probe \
--workspace /tmp/gsh-probe/ws \
--tools all \
--profile full \
--yes
python -m gsh verify \
--isolate-root /tmp/gsh-probe \
--workspace /tmp/gsh-probe/ws
gsh sync --isolate-root /tmp/gsh-probe --workspace /tmp/gsh-probe/ws --yes
gsh uninstall --isolate-root /tmp/gsh-probe --yes
pipx、Release wheel、GSH_PACK_ROOT 与未来 PyPI：docs/install.md。发版与资产：docs/release.md。
许可
CODE_OF_CONDUCT.md · LICENSE MIT · CHANGELOG.md · SECURITY.md
四层已封版。进度写入 .harness。官方源仅为上述 GitHub 仓库。