该技能用于开发任务涉及上游共享代码并加入 Kilo 专有行为时，目标是尽量缩小 Kilo 相对上游 OpenCode 的长期差异，同时保持行为不变。
适用场景：修改共享上游文件以添加 Kilo 特有行为；清理或修正过宽、过期的 kilocode_change 标记；把新增行为抽取到 Kilo 自有的代码路径。若改动完全限于 Kilo 自有路径（如 packages/kilo-vscode/、packages/kilo-ui/ 以及名称含 kilocode 的路径），则不需要它；它也不是上游合并冲突解决的主要指南。
推荐做法：共享上游文件只保留最小钩子、导入、调用、注册或配置项，Kilo 专有逻辑放在 Kilo 自有代码中，无法避免的共享文件改动使用范围很窄的 kilocode_change 标记，并让注释检查通过。对现有上游行为的修改，优先在原处做最小差异并加窄标记，不要为了避开文本冲突而把上游逻辑搬到 Kilo 路径，以免产生更难处理的语义冲突。
判断规则：新增 Kilo 功能、共享文件改动包含实质 Kilo 行为，或涉及循环、分支、错误处理、异步、存储、网络、UI 渲染、遥测时，建议抽取；若仅单个字段、导入、调用、简单条件或小型注册项，则保持内联。共享文件不得仅为可读性重构、重命名、拆分文件或提取辅助函数，须保留上游格式和导入风格。标记只加在共享上游文件的 Kilo 专有差异行，单行可用行内标记，多行用块标记并采用文件原生注释风格。
验证：编辑共享文件或标记后运行 bun run script/check-opencode-annotations.ts --worktree；与自定义基线比对时用 bun run script/check-opencode-annotations.ts --base <base-ref>；检查过宽或过期标记时先看空跑输出：bun run script/upstream/fix-kilocode-markers.ts <repo-relative-file> --dry-run。