QQ音乐以阶段门禁和分层知识管理编码Harness

QQ音乐团队面向单仓多服务与多仓协同场景（业务代码分布在 50+ 微服务、需求常跨多模块）自研 Harness Engineering 框架：把流程、拓扑、契约、知识、演进五类约束分别落到工程制品上——流程约束用五阶段主流程（初始化→需求定义→设计→开发→交付）加 main-process-numbering.md，并在 2.2 需求评审、3.3 设计评审与追溯链、4.2 features.json 合法性、4.3 三仓分支一致性四处设强制门禁，由 requirement-quality-reviewer、detail-design-quality-reviewer 等 Agent 与 traceability-gate-checker Skill 机读执行，不达标即阻塞。 拓扑约束由 .service-matrix/dependencies.yaml 单一真相源声明服务与仓库路径（仓内实际管理 57 个服务，路径深度 1/2/3 级分别为 21/32/4 个），影响面分析由搜索变查表。契约约束用「业务仓 + IDL 契约仓（qqmusicjce）+ Harness 仓」三仓同名分支联动，字段 idl_required 与阶段门禁校验。 知识约束按 context/team/、context/harness-framework/、context/project/ 三层组织，AI 按团队→项目→模块→服务逐层缩小范围。演进约束用 Self-Refinement 把纠错写入 experience/*.md 版本化沉淀。能力侧沉淀 34 个 Skill、24 个 Agent、35 个 Slash Command，阶段 4.4 的代码审查拆成 8 个维度 Agent 并行执行后由 code-review-report 聚合。 执行层不重造 IDE，复用 Claude Code、Gemini CLI、Codex CLI、Continue、CodeBuddy 等，靠 scripts/install.sh 多运行时目录渲染（.claude/、.gemini/、.codex/、.continue/）适配。