SuperAPI AI 工具集

script-kit-agent-workflow

编程与开发

查看项目

更新于 10-15 23:34

技能介绍

用途:这是 Script Kit GPUI 所有代码改动的强制工作流,用于修 bug、做变更或完成任务,强调不要请求用户手动测试,也不要跳过验证。

主要能力:覆盖探索、修复、构建、启动、查日志、视觉验证与测试的完整循环。开始前应先读 CLAUDE.md,检查 .hive/issues.jsonl 获取任务与上下文,遵循 TDD(先写失败测试,再实现,再重构),并在开始和完成工作时更新 bead 状态。日志条目与 span 需包含 correlation_id;UI 改动必须通过 stdin JSON 协议测试,不能用 CLI 参数。

必要用法:每次提交前执行 cargo check && cargo clippy --all-targets -- -D warnings && cargo test。启动应用并记录日志:echo '{"type":"show"}' | SCRIPT_KIT_AI_LOG=1 ./target/debug/script-kit-gpui 2>&1。查日志:grep -i "keyword" ~/.scriptkit/logs/script-kit-gpui.jsonl。日志模式包括 SCRIPT_KIT_AI_LOG=1(AI 代理默认的紧凑日志)、RUST_LOG=debug(完整调试日志)和 RUST_LOG=script_kit::theme=debug(针对单个模块)。若涉及 UI 改动,需编写含 captureScreenshot() 的测试脚本,把 PNG 保存到 ./test-screenshots/ 并实际读取该文件进行验证。

会话收尾:工作以 git push 成功为完成标准,包括为剩余工作建 issue、运行质量门、更新 issue 状态、执行 git pull --rebase && git push && git status、清理 stash 与分支、确认全部提交并推送、交接上下文。规则要求不得在推送前停止,不得说“准备好推送了等你操作”,推送失败要解决并重试直至成功。

限制与反模式:不应说“用户应手动测试”或“改了应该没问题”,不应只截屏不读图,不应在未运行 cargo check 前启动,不应缺少 SCRIPT_KIT_AI_LOG=1 或 RUST_LOG=debug,也不应未查日志就断言修复生效。原文未提供收费、价格或平台支持等信息。