diffity-resolve-tree

Diffity Resolve Tree 技能

你正在通过 diffity tree 浏览器查看仓库文件上留下的未解决评论，并根据评论要求修改代码。

参数

• thread-id（可选）：按 ID 解决特定线程，而不是解决所有未解决线程。示例：/diffity-resolve-tree abc123

CLI 参考

diffity agent list [--status open|resolved|dismissed] [--json]
diffity agent comment --file <path> --line <n> [--end-line <n>] --body "<text>"
diffity agent resolve <id> [--summary "<text>"]
diffity agent dismiss <id> [--reason "<text>"]
diffity agent reply <id> --body "<text>"

• comment 必须指定 --file、--line 和 --body
• --end-line 默认为 --line（单行评论）
• <id> 可接受完整 UUID 或 8 个字符的前缀

前置条件

1. 检查 diffity 是否可用：运行 which diffity。如果未找到，请使用 npm install -g diffity 安装。
2. 检查是否存在 tree 会话：运行 diffity agent list。如果运行失败并显示 "No active review session"，请告知用户先启动 diffity tree（例如，运行 diffity tree）。

操作说明

1. 列出未解决评论线程的完整详情：

   diffity agent list --status open --json
   

   如果提供了 thread-id 参数，则仅筛选该线程。JSON 输出包含每个线程的完整评论内容、文件路径、行号和侧别。
2. 如果没有未解决线程，请告知用户无需处理。
3. 对每个未解决线程： a. 跳过一般评论（文件路径为 __general__）——这些是摘要，不是可执行的代码修改请求。 b. 跳过最后一条评论是 Agent 回复且向用户提问、但用户尚未回复的线程——Agent 正在等待用户输入。 c. [question] 评论（来自用户）——阅读问题、检查相关代码，并回复答案：

   diffity agent reply <thread-id> --body "Your answer here"
   

   然后用答案摘要解决该线程。 d. 未明确标记 [question]、但以提问方式表述的评论（例如 "should we add X?" 或 "can we rename this?"）属于建议——将其视为可执行请求并进行修改。 e. 阅读 JSON 输出中的评论内容并理解修改要求。评论锚定在特定文件和行范围上——请阅读完整文件以了解上下文：
   • 如果评论建议修改代码、重构或改进，请进行修改。
   • 如果评论建议添加文档，请添加或更新相关文档。
   • 如果评论确实不明确，请回复并请求澄清：

     diffity agent reply <thread-id> --body "Could you clarify what change you'd like here?"
     

   f. 完成修改后，用摘要解决该线程：

   diffity agent resolve <thread-id> --summary "Fixed: <brief description of what was changed>"
   

4. 解决所有适用的线程后，运行 diffity agent list 确认状态。
5. 告知用户检查浏览器——解决状态会在 2 秒内通过轮询显示。