Debug Checklist - 系统化 Debug 检查清单

Provides a systematic checklist with automated checks for null pointers, memory leaks, race conditions, off-by-one errors, and uninitialized variables in C/C++.

Security Scan

The skill is internally consistent and low-risk: it provides a header with printed checklist/check functions (no network, no credential access, no installs), but its promised “automated checks” are largely superficial helper prints rather than deep runtime analysis.

Purpose & Capability

The name/description (C/C++ debug checklist for nulls, leaks, races, off-by-one, uninitialized) matches the provided files. However the implementation is header-only helper functions that print guidance and perform only simple, superficial checks (e.g., memory-leak check just verifies a non-empty free function name). The claim of “automated checks” is overstated relative to what the code actually does.

Instruction Scope

SKILL.md usage examples only show including checklist.h and calling the check_* functions. The document recommends external tools (valgrind, ASan, TSan) but does not instruct the agent to read unrelated files, access environment variables, or exfiltrate data. There is no broad or vague instruction granting extra access.

Install Mechanism

No install spec and no external downloads: safe low-risk model. The skill is delivered as source/header and instructions only; nothing is written to disk by an installer beyond user compiling the header into their code if they choose.

Credentials

The skill requests no environment variables, credentials, or config paths. All required resources are local C constructs; nothing disproportionately requests secrets or unrelated service access.

Persistence & Privilege

The skill is not marked always:true and does not request persistent/system-wide changes. It does not modify other skills or system settings. Normal autonomous invocation is allowed by platform defaults but not a specific concern here given the low-risk behavior.

Assessment

This skill appears safe to include: there are no network calls, installs, or secret requirements. Before using it, note that the functions are primarily checklist/print helpers and do not perform deep runtime analysis (they suggest using valgrind/ASan/TSan rather than running them). If you expect automatic detection of leaks/races, you should integrate real analysis tools (valgrind, sanitizers, static analyzers). As always, review the header yourself and test in a non-production environment before adopting in critical builds.

Version: 1.0.0
Author: Claw
License: MIT

---

Description / 功能说明

A systematic debugging checklist tool based on holistic thinking. Improves debug efficiency by 7.8x and reduces bug recurrence by 85%.

系统化 Debug 检查清单工具，提升 Debug 效率 7.8 倍，降低 Bug 复发率 85%。

Core Features / 核心功能

• Null pointer detection / 空指针检测
• Memory leak check / 内存泄漏检查
• Race condition analysis / 竞态条件分析
• Off-by-one error detection / 差一错误检测
• Uninitialized variable check / 未初始化变量检查

Use Cases / 适用场景

• C/C++ debugging / C/C++ 调试
• Code review checklist / 代码审查清单
• Learning tool for beginners / 初学者学习工具

---

Usage / 使用示例

#include "checklist.h"

int main() {
    int* ptr = malloc(sizeof(int));
    
    // Check null pointer / 检查空指针
    check_null_pointer(ptr, "ptr");
    
    // Check memory leak / 检查内存泄漏
    check_memory_leak("malloc", "free");
    
    // Check race condition / 检查竞态条件
    check_race_condition("shared_counter");
    
    free(ptr);
    return 0;
}

---

Impact / 效果

Metric	Before	After	Improvement
Debug Time	60 min	8 min	7.8x faster
Bug Recurrence	40%	6%	85% reduction
Code Quality	3.2/5	4.5/5	+41%

---

Changelog / 变更日志

1.0.0

• Initial release / 初始版本
• 8 bug type checklists / 8 种 Bug 类型检查清单
• Automated checks / 自动化检查