القائمة
调试诊断 — 结构化错误定位、根因分析、最小化修复与回归验证。当用户报告运行时错误 / stacktrace / 测试失败 / 脚本异常 / testing 阶段缺陷清单待修复时使用此 skill。本 skill 处理已知症状的根因定位与最小修补；新功能开发循环由 tdd-engine 负责，新测试编写由 testing 负责。
التثبيت باستخدام Codex أو Claude انسخ هذا Prompt والصقه في Codex أو Claude أو مساعد آخر ليراجع صفحة Skill ويثبّتها لك.
استنادا إلى تصنيف SOC المهني
项目走查 — 在隔离沙盒中以指定执行模式（缺省 standard 全阶段）把一个小型示例项目跑通整条 SDLC 工作流（初始化→核心执行链路→分支→异常→终止清理），逐路径观察各阶段/门禁/降级/恢复的真实行为，产出『框架本身 + 走查流程本身』两类改进建议，并把走查流程自身的改进经自更新协议回灌本 skill 迭代。与 framework-review 形成动静对偶：后者静态审元资产，本 skill 动态端到端自测。当用户想验证一次框架部署是否真能跑通、为非 Claude-Code 平台做行为级冒烟、或自测 workflow-framework-generator 生成的框架时使用。
测试 — 测试策略规划、测试编写与执行、覆盖率分析、缺陷记录。当需要规划测试策略、编写或执行测试套件、分析覆盖率或记录缺陷时使用。本 skill 不改源码（缺陷修复由 debug 负责），单任务 RED/GREEN 单元测试由 tdd-engine 负责，testing 聚焦集成/E2E 与覆盖盲区补充。
代码评审 — 任务粒度评审 (review) 与项目级健康度扫描 (scan) 双入口；代码质量检查、规范合规验证、安全漏洞检测、腐化指标扫描。当任务卡 GREEN 完成 / Sprint 发布前 / 用户要求扫描代码腐化时使用此 skill。审查范围限 src/ 业务代码：文档审查由 doc-review 负责；框架元资产 (.cataforge/) 审查由 framework-review 负责；Sprint 完成度由 sprint-review 负责。
统一上下文 I/O — 按需读取章节/实体、查询追溯关系、生成与写入、门禁校验。文档生命周期的单一入口；后端(知识图谱/文件)由框架按配置方案透明路由,调用方只表达意图。按操作分支见 references/。
功能走查 — 对交付项目的功能实现做验收式动态走查，两层正交判定：①功能是否兑现 spec（missing/drift/bug/pass）；②代码本身是否健康（复用 COMMON-RULES §统一问题分类体系的 code category）。用真实数据路径起真实服务复现，专捞门禁全绿仍漏的跨模块集成缝隙。当项目功能交付后需验收、Sprint 发布前做功能级复核、或用户要求走查某功能域时使用。与 framework-walkthrough 动静对偶：后者在沙盒自测框架 SDLC，本 skill 验收交付项目的功能实现。
框架元资产审查 — 对 .cataforge/ 下的 agents/skills/hooks/rules + workflow 拓扑做内容质量与一致性审查。与 platform-audit 形成内审/外审对偶；与 code-review/doc-review 服务于业务产物不同，本 skill 专审框架自身配置。当用户提到框架腐化、SKILL.md/AGENT.md 质量、agent 引用孤立、SKILL/MANIFEST 漂移、Workflow 完整性、model_tier 合规时使用。
| name | debug |
| description | 调试诊断 — 结构化错误定位、根因分析、最小化修复与回归验证。当用户报告运行时错误 / stacktrace / 测试失败 / 脚本异常 / testing 阶段缺陷清单待修复时使用此 skill。本 skill 处理已知症状的根因定位与最小修补；新功能开发循环由 tdd-engine 负责，新测试编写由 testing 负责。 |
| argument-hint | <错误信息或stacktrace> |
| suggested-tools | file_read, file_edit, file_glob, file_grep, shell_exec |
| depends | ["context"] |
| disable-model-invocation | false |
| user-invocable | true |
调用方提供以下信息（至少一项）:
语言细则: 根据
framework.jsonproject.languages，按需载入本 skillreferences/lang-<lang>.md（仅 active 语言，逐个 Read），获取对应语言的调试诊断细则（调试器使用、traceback 解读、日志实践、运行时问题定位）。与本 skillreferences/debug-patterns.md（scan-similar 的特征模式范例）分工：lang-.md 为完整调试细则，debug-patterns 为同类扫描的模式库。
适用于: 收到错误报告，需要从零开始诊断和修复。
Step 1: 复现与信息收集
Step 2: 定位根因
Step 3: 应用修复
Step 4: 回归验证
Step 5: 总结
适用于: 根因已明确（如用户已定位到具体文件和行），剩余动作仅为应用修复和验证。
Step 1: Read 相关文件确认问题 Step 2: 应用修复（Edit） Step 3: Grep 检查同类问题并一并修复 Step 4: 回归验证（Bash 运行命令/测试） Step 5: 输出摘要
适用于: 已修复一个问题，需要检查整个项目中是否存在同类问题。
Step 1: 从已修复的问题中提取特征模式（如未显式声明编码的文件读写、未转义的正则元字符；语言特定示例见 debug-patterns.md） Step 2: 使用 Grep 在项目范围内搜索该模式 Step 3: 逐一检查匹配项，判断是否存在同类问题 Step 4: 对确认存在问题的文件应用修复 Step 5: 汇总扫描结果: 检查了 N 个文件，修复了 M 个
语言/平台特定的症状—修复对照（Python/Windows 等）见 debug-patterns.md，新增语言在该文档增条。
catch + pass 吞异常 —— 信号被埋掉后续 debug 复杂度指数上升