SuperAPI AI 工具集

lcs-debug

测试与质量

查看项目

更新于 10-16 00:22

技能介绍

用途:lcs-debug 用于集中调查 bug。它在用户提到 bug、失败测试、错误、回归或异常行为时触发,强调在完全理解问题之前不规划也不实施任何修复。

主要能力:先确认工作项并读取 .lcs/state.md 以识别当前工作项文件夹;若未选中工作项(current_work 为 null),先创建或注册新工作项;若已选中则复用,不重复创建。调查时一次只问一个问题,覆盖复现步骤、期望与实际行为、日志、环境、最近提交,优先获取最小复现步骤,在根因清晰前不建议修复。

产出与用法:将调查笔记与拟定的修复计划写入 .lcs/work-items/{timestamp}-{slug-work-item}/debug.md,并更新 .lcs/state.md:current_phase 设为 debug、对应 work_items 的 phase 设为 debug、updated_at 与 timestamp 使用当前 ISO 时间戳、写入 last_session_note 摘要。若 bug 涉及产品或行为需求,需在 debug.md 内分配稳定标识 SRC-###(如 SRC-001 顺序编号),并按契约保留 P0/P1/P2 优先级,供 lcs-toprd 合成 PRD 时使用。结束时输出 Handoff,包含下一推荐技能 lcs-toprd、下一文件、当前阶段与置信度、阻塞问题、风险、真源包、需保留与未解决的 ID。

强制六阶段调试循环:一、构建反馈回路,必须先有能在该 bug 上稳定变红、快速(<10 秒)、确定性且无需人工交互的命令,未完成前禁止进入假设阶段,无法做到则说明阻塞并停止;二、复现并最小化,逐项删减到最小仍变红的场景;三、提出 3-5 个可证伪并按优先级排序的假设,测试前先给用户查看;四、插桩,一次只改一个变量,调试日志统一标记 [DEBUG-XXXX] 便于清理;五、修复与回归,在存在正确接缝时先写回归测试再修复;六、清理与事后复盘,移除调试日志,并考虑何种架构改动可避免该问题。

限制:资料强调不得在根因清晰前设计或建议修复;写入操作需遵循契约中的 Artifact Writing Safety 规则,先生成内容、只写一个文件、写入后验证、失败即停止。debug.md 需按契约包含 YAML frontmatter。关于具体平台、安装方式与收费信息,资料暂未提供。