📝 docs(codex_skills): normalize markdown formatting
This commit is contained in:
@@ -6,25 +6,31 @@ description: "Systematic debugging for bugs, failing tests, regressions (TSL/C++
|
||||
# Systematic Debugging(系统化调试)
|
||||
|
||||
## When to Use
|
||||
|
||||
- Bugs, crashes, failing/flaky tests, regressions
|
||||
- “It doesn’t work” reports with unclear reproduction
|
||||
|
||||
## Inputs(required)
|
||||
|
||||
- Expected vs actual behavior
|
||||
- Repro command/steps (or best-known approximation)
|
||||
- Logs/traces/screenshots/error output
|
||||
- Environment details (OS, versions, configs)
|
||||
|
||||
## Procedure(default)
|
||||
|
||||
1. **Reproduce**
|
||||
|
||||
- Make the failure deterministic if possible
|
||||
- Minimize repro steps (smallest input/command)
|
||||
|
||||
2. **Localize**
|
||||
|
||||
- Identify failing component and boundary conditions
|
||||
- Add temporary logging/assertions if needed (then remove)
|
||||
|
||||
3. **Hypothesize & Test**
|
||||
|
||||
- Form a small number of hypotheses
|
||||
- Design quick experiments to falsify each hypothesis
|
||||
|
||||
@@ -33,6 +39,7 @@ description: "Systematic debugging for bugs, failing tests, regressions (TSL/C++
|
||||
- Add/update tests; rerun the minimal relevant suite
|
||||
|
||||
## Output Contract(stable)
|
||||
|
||||
- Repro: exact steps/command
|
||||
- Diagnosis: root cause + evidence
|
||||
- Fix: what changed + why it works
|
||||
@@ -40,6 +47,7 @@ description: "Systematic debugging for bugs, failing tests, regressions (TSL/C++
|
||||
- Follow-ups: hardening or cleanup tasks
|
||||
|
||||
## Guardrails
|
||||
|
||||
- Avoid changing multiple variables at once
|
||||
- Prefer instrumentation and evidence over guessing
|
||||
- Keep fixes minimal and scoped
|
||||
|
||||
Reference in New Issue
Block a user