mcpField
O
oops

oops

github.com/poteto开发564217 次安装32 周前更新
代码仓库

关于 oops

用于排查用户项目和 Noodle 内部基础设施故障的技能。流程包括复现、诊断、修复、验证和提交，并优先检查状态与环境，再检查代码。

主要功能

  1. 01复现故障并记录错误
  2. 02检查项目状态与配置
  3. 03排查环境和持久化文件
  4. 04定位根本原因
  5. 05验证修复及相关测试
  6. 06以根因描述提交

适用场景

  1. 01诊断卡住的任务队列
  2. 02追查过期状态或配置导致的故障
  3. 03验证基础设施修复

安装

复制下面的命令，在终端中运行。

$npx skills add https://github.com/poteto/noodle --skill oops

安装后在 Claude Code 中输入/oops确认已加载。

详细介绍

哎呀

修复基础设施故障。适用于用户项目代码和 Noodle 内部状态。

修复流程

复现 -> 诊断 -> 修复 -> 验证 -> 提交

1. 复现

运行失败的命令。记录精确的错误输出。如果问题偶发，多次运行以确认。

2. 诊断

优先怀疑状态，而不是代码。 按以下顺序检查：

  1. Noodle 状态 — .noodle/ 文件、队列一致性、配置有效性
  2. 环境 — Go 版本、缺失的依赖项、过期的缓存、tmux 会话健康状况
  3. 配置 — .noodle.toml（项目根目录）、.agents/skills/ 结构、brain/ 完整性
  4. 持久化文件 — 锁文件、临时文件、未完成的写入
  5. 代码 — 排除状态和环境问题后再检查
原则
  • [[fix-root-causes]]
  • [[prove-it-works]]

Noodle 内部检查清单：

  • .noodle/ 状态文件：是否损坏、过期或不一致？
  • 队列状态：是否有孤立任务或卡住的会话？
  • 配置：TOML 是否有效，引用的路径是否存在？
  • tmux 会话：是否有僵尸进程或已分离的会话？
3. 修复

追溯到根本原因。切勿掩盖症状。

修复后，搜索其他位置是否存在相同模式——该错误可能出现在多个位置。

4. 验证

运行最初失败的命令。确认其通过。运行相关测试以检查是否引入回归。

5. 提交

提交消息应描述根本原因，而不是症状。

# Good: fix(queue): stale lock file prevented task dequeue after crash
# Bad:  fix: tasks not running

评论

支持 Markdown