本技能是一组工程方法陷阱参考，共 9 条，源自一个生产环境的 Kotlin 与 Compose Multiplatform 应用。每个陷阱单独成文，位于 references/ 下，篇幅均在 150 行以内；每篇给出可用的工作模式、陷阱（实际失败的具体方式及原因）以及“验证”小节（含可对用户自身代码树运行的命令）。
使用方式：将要写的代码或正在追查的症状与条目匹配，每条都标注了主题和应触发阅读的症状；在提出代码或修复方案前，用 Read 工具读完所有可能适用的文件。若验证命令中出现源项目路径，需替换为用户代码树中的对应路径。文件中若出现未列出的反引号陷阱名，则属于相邻领域技能，可用 glob ../*/references/<name>.md 打开。
各条目用途：
- run-discriminating-experiment-first：两个几乎相同的事物表现不同时，先统计仍不同的变量，执行一次交换或取舍测试以排除至少一半变量，再写修复。适用于同一症状在两次以上修复后仍存在、相邻控件/界面/平台一个正常一个不正常、或每次尝试都要付出缓慢构建和他人注意力成本时。
- noop-actual-not-platform-limit：多平台项目中空的或透传的平台实现意味着没人写，而非平台做不到；在断言某功能在该平台不可能前，先检查依赖的已解析变体和声明它的源集。适用于“桌面/iOS 上不工作”、平台文件原样返回输入或空函数体、或准备把功能归为平台限制时。
- read-build-logs-bottom-up：读构建日志先到底部看结论，再找第一个错误标记定位原因，不要从任一端截取固定窗口，因为因果消息和失败横幅位于输出两端。适用于后台构建结束准备总结、日志只说“task X FAILED”无原因、或过滤结果为空准备判定构建干净时。
- changelog-as-war-story：维护一个受跟踪的 markdown 文件，按日期记录症状、机制、已排除项以及移除变通方案的条件，并用“条目随变更落地”的规则强制执行。适用于修复依赖不易察觉的行为、同一调查反复进行、或向人或智能体介绍高代价陷阱区域时。
- writing-agent-skill-house-style：编写能经受对抗性评审的智能体技能：描述同时包含触发条件和读者正面对的错误症状，简短导览，以陷阱部分为主体，并附实际运行过的验证命令。适用于编写或评审 SKILL.md、技能读起来像文档而非经验之谈、或评审不断发现源仓库不支持的断言时。
- xml-to-compose-sequencing：规划大型 XML 到 Compose 迁移的顺序：最难的界面优先，真正的工作是整合分散状态而非替换控件，并预期导航会牵出路由序列化迁移。适用于规划多版本 UI 迁移、界面“已迁移”但布局文件数量不降、或决定下一个转换哪个界面时。
- commit-archaeology-red-flags：挖掘仓库历史而不被误导：空函数体提交的文件统计才是其真正摘要，嵌套仓库升级把全部内容藏在一行指针变更之后，合并会把分支决策轨迹压成单个主题。适用于还原某物为何如此、blame 落在说明不了什么的提交上、或变更看似只动一行却不可能那么小时。
- removing-a-feature-audit-shared-handles：删除与更新功能重复的功能：同一输出上的两个效果会相乘；先审计被删功能看似拥有的句柄还被谁使用，删除其他平台上的空操作桩，并在判断删除是否生效前强制停止，因为已附加的外部效果会存活于变更之后。适用于用应用内集成替换委托式集成、或已删除功能似乎仍在运行时。
- a-stated-rule-needs-annotated-exceptions：有合法例外的设计规则只有在每个例外都在调用点注明原因、且规则本身可被 grep 时才存活，否则无法区分例外与违规，规则会悄然腐化。涵盖规则声明位置、原因位置、将审计限定在规则实际管辖的代码，以及基于注释检查的局限。适用于既定约定出现漂移、评审者无法分辨有意与疏忽、或在把规则写进文件头并假定其成立之前。
限制：资料未提供具体价格、收费、平台支持范围或安装命令；验证命令需按用户代码树替换路径，实际效果取决于用户项目情况。