该技能面向 opencode v2 的完全重写场景:Kilo v1 的修复和功能不会自动带入,因此需要把 v1 的行为和动机记录成足以让 v2 智能体判断“v2 是否已覆盖”或“从零实现”的追踪 issue。入口为 /pr-track-v1 命令,其参数视为可选上下文,不直接粘入 issue。
【用途与产出】 最终在 Kilo-Org/kilocode 生成一个 issue:标题为 [v2-port] <summary>,标签 core-v1-changes-port,指派给 @me;以自动生成的来源说明横幅开头并注明源 PR;正文描述问题、用户可见行为契约、边界情况与验收标准,而非逐文件 diff 叙述;结尾附可直接粘贴的 Prompt For V2 Agent 块;在源 v1 PR 上评论回链;不包含占位符、臆造动机或未经验证的声明;同一 PR 已有追踪 issue 时复用而非重复创建。
【使用方式】
- 解析源 PR:先运行 gh auth status 确认访问权限;每次 gh 调用都显式指定 --repo Kilo-Org/kilocode。参数可含 PR 编号或 URL,可多个;无参数时用 gh pr view --json number,url,title,state 解析当前分支 PR 并确认。无法解析时询问 PR 编号,不猜测。
- 检查变更:用 gh pr view 获取编号、URL、标题、正文、状态、合并时间、合并提交、作者、标签、文件、提交、评论、审查及关联 issue,并用 gh pr diff 查看差异。功能细节优先来源依次为:PR 正文与 diff 中的 changeset 文件、新增或修改的测试、关联 issue 与评审讨论,最后才是代码 diff(仅用于提取意图,如顺序、重试、默认值、平台特例)。同时记录受影响面(CLI/core、VS Code 扩展、JetBrains、网关或 SDK)、引入或变更的配置键、标志、环境变量、默认值、持久化状态或遥测事件,以及该变更是 Kilo 行为变更还是上游 opencode 的变通方案。若 PR 无值得延续的 Kilo 特有行为(依赖升级、纯上游合并、仅格式变更),说明并停止,不创建 issue。
- 避免重复:用 gh issue list --label core-v1-changes-port --state all --search "pull/<N>" 搜索;若已有引用同一 PR 的 issue,报告其 URL,不创建第二个;仅在用户要求时更新已有正文。
- 确保标签存在:用 gh label list --search core-v1-changes-port 检查,无精确匹配时用 gh label create 创建(颜色 5319e7,描述为 Kilo core v1 change to re-implement or verify in opencode v2);“已存在”错误视为成功;因权限失败则报告,不创建无标签 issue。
- 标题:使用 [v2-port] <summary>,摘要取自用户可见结果而非分支名或提交主题;祈使句、可独立阅读;不加约定式提交类型和 [JetBrains]/[VS Code] 前缀;尽量控制在 80 字符内。示例:[v2-port] Keep queued user messages when a session aborts mid-stream。
- 正文:写入临时 Markdown 文件并用 --body-file 传入,以保持多行和嵌套围栏完整。模板包含:来源横幅;## Context(1-3 句说明变更内容、受影响面、修复/功能/行为变更类型);## Problem In V1(具体缺陷、限制或缺失能力,含用户可见症状与触发条件);## Behavior To Preserve In V2(用户可见行为/契约条目、已显式处理的边界或失败模式、引入或变更的配置键/标志/默认值/环境变量/持久化状态/遥测事件);## Non-Goals(v1 有意未处理的内容及不应延续的 v1 特有实现,无则写 None.);## Why This May Not Carry Over Automatically(重写可能遗漏的原因:非显而易见的边界、顺序或竞态、平台特例、上游变通;若 v2 架构很可能已覆盖则说明);## Acceptance Criteria(确认 v2 是否已提供该行为及位置;缺失时以 v2 惯用方式实现而非移植代码;来自 v1 测试的具体可核对验证项);## V1 Reference(源 PR URL、标题、合并日期;关联 issue 或 None.;关键 v1 代码引用,仅参考);## Prompt For V2 Agent(代码块,说明在 opencode v2 代码库中先判断是否已具备该行为,具备则报告位置并停止;不具备则按 v2 惯用方式实现,不移植 v1 代码结构;列出必需行为、验证方式与背景 PR URL)。正文规则:功能细节是核心;代码引用最多几行且仅在承载重写会遗漏的意图时保留;叙述已覆盖时可省略代码引用;绝不臆造症状、issue 链接、遥测名称或配置键;PR 未记录原因时写明“该 PR 未记录动机”;创建前解析所有占位符。
- 创建、指派、回链:用 gh issue create 指定标题、body-file、标签 core-v1-changes-port、指派 @me;不传 --project、不使用 issue 模板(内部 v2 规划追踪,不适用仓库 gh-issues 技能中的看板要求);若 @me 指派失败则报告而非静默留空。随后在源 PR 评论:Tracked for the opencode v2 rewrite in #<issue-number> (core-v1-changes-port)。删除临时正文文件;评论失败(PR 被锁定、权限不足)时保留 issue 并报告,不盲目重试。
- 验证:用 gh issue view --json url,title,labels,assignees,body 确认 [v2-port] 标题、标签、@me 指派、各章节恰好出现一次、无未解析占位符;用 gh pr view --json comments 确认回链评论可见。返回 issue URL、源 PR、一行摘要及需人工补充的内容。
【多 PR 处理】 逐个独立处理,每个 PR 返回一行:issue URL 或跳过原因。当一个 PR 明显包含多个独立行为时,先询问一次是否拆分再创建 issue。
【适用场景与限制】 适用于 Kilo-Org/kilocode 仓库中已合并的 Kilo v1 PR 到 opencode v2 的行为追踪;依赖已认证的 gh CLI 及相应仓库权限。对无 Kilo 特有行为的 PR 会跳过;标签或指派出错时据实报告。