SuperAPI AI 工具集

debug-cli

编程与开发

查看项目

更新于 10-16 00:30

技能介绍

用途:面向 code-forge 应用的 CLI 调试技能,帮助调试、修改或扩展其命令、参数解析与命令行行为,包括新增命令与验证改动。

主要能力与工作流:

  1. 构建:改动后始终以调试模式构建,使用 cargo build,调试时不用 cargo build --release。
  2. 获取最新文档:先用 ./target/debug/forge --help 查看当前命令与选项,再执行 ./target/debug/forge [COMMAND] --help 与 ./target/debug/forge [COMMAND] [SUBCOMMAND] --help。
  3. 测试:用 -p 标志给 forge 任务,避免交互模式,如 ./target/debug/forge -p "create a hello world rust program"。
  4. 会话转储:调试提示词或会话问题时用 conversation dump 导出,自动生成带时间戳文件,如 ./target/debug/forge conversation dump <conversation-id>(生成 YYYY-MM-DD_HH-MM-SS-dump.json),加 --html 生成 HTML,可用 ./target/debug/forge --conversation 2025-11-23_12-28-52-dump.json 复现。
  5. 克隆会话:用户提供有缺陷的会话时先克隆再复现,./target/debug/forge conversation clone <source-conversation-id>,再用 --conversation-id <new-cloned-id> 测试;不要修改原始会话,以便保留证据、多次复现与 A/B 验证。

常见模式:测试新功能时先 build,再用 --help 确认命令出现并执行 -p;复现缺陷时先 dump、再 clone、再用克隆 ID 加 -p 复现,修复后再克隆验证。还可测试缺失参数、非法输入、边界值等。调试提示词可用 cat 2025-11-23_12-28-52-dump.json | jq '.messages[] | {role, content}' 查看结构,或用 --html 便于阅读,再用 -p 测试修改后的提示词。

适用场景:forge CLI 命令与参数解析的开发调试、缺陷复现与验证、提示词优化排查。

限制与提示:调试期间不要提交改动,仅经完整验证后才可提交;始终先 --help;用相对路径 ./target/debug/forge;可用 echo $? 检查退出码;注意构建警告。具体支持平台、收费等信息暂未提供。