📝 docs(codex_skills): normalize markdown formatting

This commit is contained in:
csh
2025-12-22 15:36:58 +08:00
parent cc8ad4c59c
commit a52bb246ab
13 changed files with 109 additions and 2 deletions
@@ -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 doesnt work” reports with unclear reproduction
## Inputsrequired
- Expected vs actual behavior
- Repro command/steps (or best-known approximation)
- Logs/traces/screenshots/error output
- Environment details (OS, versions, configs)
## Proceduredefault
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 Contractstable
- 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