expert-output-quality

# Expert Output Quality Skill ## 定位 本 Skill 防止 AI 产物停留在“能跑示例”或“解释 fixture”的初级层面。它要求代码、文档、示例、方案和报告体现技术专家、资深架构师或领域专家视角：先给生产推荐路径，再说明测试夹具、演示代码、兼容路径和反模式的边界。 ## 触发条件 | 场景 | 是否触发 | |------|:--------:| | 代码、文档、示例、fixture、quick start、README、站点文档、技术方案、报告需要交付给用户或维护者 | 必须 | | 用户指出“不专业”“像初级”“这不是推荐写法”“示例误导”“怎么又写成开发文档” | 必须 | | 文档或报告需要解释测试 fixture、demo、mock、兼容路径、历史写法或反模式 | 必须 | | 框架、SDK、库、运行时、权限、路由、中间件、鉴权、缓存、事务、队列、ORM、UI 组件等存在原生能力 | 必须 | | 纯内部临时草稿、只读事实查询、无需产物沉淀的短问答 | N/A + skipReason | ## 核心门禁 | Gate | 要求 | 证据 | |------|------|------| | `ExpertOutputQualityGate` | 输出必须体现对应角色的专业判断，不只复述代码或示例现象 | 角色定位、推荐路径、风险和取舍 | | `ExpertRoleBaselineGate` | 根据任务选择技术专家 / 资深架构师 / 领域专家 / 产品化文档作者视角 | 角色与受众说明 | | `ProductionRecommendedPathGate` | 先写生产推荐路径，再写测试、demo、fixture、兼容或历史路径 | recommendedPath / nonRecommendedPath | | `FrameworkNativeCapabilityFirstGate` | 先检查框架、SDK、平台或项目现有能力，避免手写重复机制 | official / repo-local / runtime evidence | | `FixtureBoundaryDisclosureGate` | fixture、mock、样例配置、硬编码单例必须标明不是生产主路径 | fixtureBoundary、allowedUse、forbiddenUse | | `ExampleArchitectureFitnessGate` | 示例要符合项目推荐架构，避免在 route、controller、UI 或测试里重复声明框架已承载的资源配置 | architectureFit、consumerImpact | | `AntiPatternContrastGate` | 必要时列出“错误写法 / 为什么错 / 正确写法”，但不把反模式放成主路径 | antiPattern、replacement | | `ExpertEvidenceMatrixGate` | 关键建议必须绑定代码、类型、官方文档、运行时、测试、构建或用户路径证据 | evidenceMatrix | | `OperationExplanationContractV1` | 面向用户或维护者的操作说明必须写清目标、前置条件、输入、状态影响、结果形态、结果来源、失败语义、下一步和证据 | operationId、userGoal、resultSource、failureSemantics | | `ResponsePr...