Engineering Baseline Builder 是一个面向工程规范落地的技能,目标是在项目现有技术栈和版本证据的基础上,创建或校准经批准的技术指导文档与本地重复性流程。其编辑范围严格限定为授权文档、智能体指令和本地技能工件;产品代码、测试、CI 与基础设施均不在修改范围内,审计工作保持只读。
用途方面,该技能主要解决两类问题:一是为项目建立或对齐技术指导(如适用原则、约束、条件性技术义务);二是为有证据支撑的重复性操作创建本地技能。架构质量目标与结构性权衡仍由架构需求与架构决策拥有,本技能只负责把已有输入转化为项目级技术指导,不构成第二套架构基线;可执行配置负责精确取值,本地流程只负责步骤而非复制策略。
主要能力包括:从指令文件、清单、锁文件、聚焦的源码与配置读取以及 Git 状态中确定实际技术栈与规则所有者;分别评估静态分析与类型安全、架构约束执行、依赖与许可证、容器、配置、认证、错误处理、可观测性、变更恢复与数据库生命周期等领域的适用性;区分一般原则、条件性技术义务、项目特定决策与未解决冲突;对机械可执行的不变量识别现有检查或缺失验证,但不实现产品/CI 检查。
执行契约要求对每个检查项标注 PENDING、PROVEN、CLEARED 或 UNPROVEN,读取、委派、工具失败、零退出码与自报成功均不构成证明;每个部分结束后进行对账,返回前解决所有 PENDING,只统计 PROVEN 与 CLEARED,并对每个缺口适用判定与批准规则。证据须绑定到实际命令与受支持环境,版本相关假设须对照官方文档或规范核验,无法获得的证据标记为 UNVERIFIED。
使用方式上,技能通过清单分三步推进:第一步建立适用性,检查请求的工件、Git 状态与现有指令,保留无关和中断的工作,从可执行来源识别项目类型、运行时版本、部署拓扑、信任边界与运维约束,阅读现有需求与契约,定位规范性规则所有者与可变值的可执行所有者;第二步构建项目指导,将适用原则映射到原生技术栈机制,复用现有文档,仅在无所有者时新建,始终加载的指令只保留约束与条件路由,仅为有证据的重复流程创建本地技能;第三步验证所有权与可用性与可操作性。
适用场景为需要建立或校准工程基线文档、统一规则所有者、梳理项目技术指导与本地流程的工程团队。限制包括:不实现或修复代码、测试、CI 与基础设施;不替代架构决策;只读模式只报告缺口;范围、权限、所有权或关键证据不足时判定为 BLOCKED;用户或仓库未提供的版本、环境与审批信息不可推断。结果判定为 READY(指导可用、标准且经来源验证,但不代表实现就绪)、INCOMPLETE(存在重大契约缺口)、PASS/CONCERNS/FAIL(只读评估结论)、BLOCKED(无法产出可用工件)。输出按 Result、Scope、Evidence、Verification、Completion 五字段报告。