oops
GitHub修复构建失败、测试错误、状态陈旧和环境漂移等基础设施故障。通过复现、诊断(优先检查状态而非代码)、修复根因、验证和提交的标准流程,解决用户项目及内部系统的异常问题。
触发场景
安装
npx skills add poteto/noodle --skill oops -g -y
SKILL.md
Frontmatter
{
"name": "oops",
"schedule": "When infrastructure failures are detected (build breaks, test failures, stale Noodle state)",
"description": "Infrastructure fix for broken builds, failed tests, stale state, and environment drift. Covers both user-project and Noodle-internal failures. Triggers when builds break, tests fail, state is stale, or environment drifts. Use on 'oops', 'fix the build', 'tests are failing', 'something broke', 'broken build'."
}
Oops
Fix infrastructure failures. Applies to both user-project code and Noodle-internal state.
Fix flow
Reproduce -> Diagnose -> Fix -> Verify -> Commit
1. Reproduce
Run the failing command. Capture exact error output. If intermittent, run multiple times to confirm.
2. Diagnose
Suspect state before code. Check in this order:
- Noodle state —
.noodle/files, queue consistency, config validity - Environment — Go version, missing deps, stale caches, tmux session health
- Config —
.noodle.toml(project root),.agents/skills/structure,brain/integrity - Persistent files — lock files, temp files, incomplete writes
- Code — only after ruling out state and environment
Principles
- [[fix-root-causes]]
- [[prove-it-works]]
Noodle-internal checklist:
.noodle/state files: corrupt, stale, or inconsistent?- Queue state: orphaned tasks, stuck sessions?
- Config: valid TOML, referenced paths exist?
- tmux sessions: zombie processes, detached sessions?
3. Fix
Trace to root cause. Never paper over symptoms.
After fixing, grep for the same pattern elsewhere — the bug may exist in multiple locations.
4. Verify
Run the original failing command. Confirm it passes. Run related tests to check for regressions.
5. Commit
Commit message describes the root cause, not symptoms.
# Good: fix(queue): stale lock file prevented task dequeue after crash
# Bad: fix: tasks not running
版本历史
- 82d2921 当前 2026-11-19 21:08


