engineering-collaboration
让 Agent 适配既有代码库、收窄动态或宽泛值，并以用户容易理解的方式交付技术结论。
为什么有这个 skill
把通用开发协作规则从生产工程约束中拆出，使其能独立触发，同时避免 production-engineering 变成万能 skill。
解决什么问题
历史项目的混合编码习惯、动态或粗粒度类型和专业术语容易造成代码不一致、业务语义模糊及协作理解断层。
复制即可安装：安装 engineering-collaboration
自动探测本机已安装的 Agent；命令中的站点地址会根据当前页面自动生成。
正在生成安装命令…人类说明
engineering-collaboration
解决什么问题
开发任务不仅需要代码正确，还需要融入历史代码库，并让参与者能够理解 Agent 的技术判断。现实项目中常同时存在多种编码习惯、动态输入、含义模糊的原始类型，以及专业术语过多导致的沟通断层。
这个 skill 把三项通用协作规则放在一起：适配当前项目的有效约定、尽快收窄动态类型、以浅显但不失真的方式交付技术结论。
核心原则
- 仓库强制配置优先于个人偏好，当前模块的有效约定优先于无关代码；
- 不为完成局部任务而统一全仓库，也不机械复制明显不安全的旧习惯；
- 万能类型和其他宽泛值只停留在真实动态边界，进入业务层前完成校验和收窄；
- 根据业务风险明确值域、结构、缺失/空值、转换、默认和序列化语义，再按字符串、数值、布尔、集合、对象或联合值补充必要约束；
number的整数/小数、单位、范围和精度只是数值类别的常见示例，不替代对其他动态或粗粒度类型的治理；- 会话先解释结论、概念、原因和影响，正式文档再承载完整技术细节；
- 专业术语和缩写首次出现时简短释义，已经解释或用户熟练使用时不重复教学。
内容结构
SKILL.md：通用协作入口与按需路由；references/codebase-conventions.md：历史代码风格冲突与局部改动范围；references/type-semantics.md：动态值收窄、宽泛值的业务语义、运行时校验和契约文档；references/communication-and-explanation.md：分层表达、术语释义、决策说明和正式制品交付。
行为评测位于仓库级 evals/engineering-collaboration/，不会打包进可安装 Skill，也不参与 Agent 的核心决策上下文。
安装
从仓库根目录执行：
bash scripts/install.sh --skill engineering-collaboration --yes安装后需要新建会话或让 Agent 重新扫描 skills 目录。