跳到正文
cccskills
免费在 GitHub 公开

dev-debug

Investigate bugs by clarifying expected behavior, reproducing the problem, and testing possible causes. The skill helps prepare a fix plan with risks and validation steps before code changes begin.

中文简介正在准备中。当前显示英语简介。

原文查看原文说明

AI DevKit · Guide structured debugging before code changes by clarifying expected behavior, reproducing issues, identifying likely root causes, and agreeing on a fix plan with validation steps. Use when users ask to debug bugs, investigate regressions, triage incidents, diagnose failing behavior, handle failing tests, analyze production incidents, investigate error spikes, or run root cause analysis (RCA).

codeaholicguy/ai-devkit星标 1,654(GitHub 1,654 + cccskills 0)

实测评分 未实测

查看安装方法

适用场景

  • Reproducing a bug and documenting its environment
  • Investigating a regression or failing test
  • Triage of production incidents or error spikes
  • Preparing a root cause analysis and fix plan

包含的文件(2)

  • SKILL.md2.8 KB
  • agents/openai.yaml315 B

SKILL.md(原文)

安装前可以查看交给 AI 代理的指令内容。

Local Debugging Assistant

Debug with an evidence-first workflow before changing code.

Hard Rule

  • Do not modify code until the user approves a selected fix plan.

Workflow

  1. Clarify
  • Restate observed vs expected behavior in one concise diff.
  • Confirm scope and measurable success criteria.
  • Before investigating, search for similar past incidents: npx ai-devkit@latest memory search --query "<observed behavior>" --tags "debug,root-cause"
  1. Reproduce
  • Capture minimal reproduction steps. For user-flow bugs, make the repro a dev-smoke check that fails before the fix and passes after.
  • Capture environment fingerprint: runtime, versions, config flags, data sample, and platform.
  1. Hypothesize and Test For each hypothesis, include:
  • Predicted evidence if true.
  • Disconfirming evidence if false.
  • Exact test command or check.
  • Prefer one-variable-at-a-time tests.
  1. Plan
  • Present fix options with risks and verification steps.
  • Recommend one option and request approval.

Validation

  • Confirm a pre-fix failing signal exists.
  • Confirm post-fix success using the verify skill — including regression verification for bug fixes.
  • Summarize remaining risks and follow-ups.
  • Offer dev-retro to prevent recurrence; run only if the user agrees.
  • Store root cause and fix for future sessions: npx ai-devkit@latest memory store --title "<root cause>" --content "<diagnosis and fix>" --tags "debug,root-cause"

Task Tracing

If task tracing is usable, choose a short kebab-case debug task name when no task name exists, then use task optionally: record repro/final results as evidence, the current hypothesis as next, and blockers only when they materially affect progress. Never block debugging because task tracing is unavailable.

Red Flags and Rationalizations

RationalizationWhy It's WrongDo Instead
"I already know the cause"Assumptions skip evidenceReproduce and prove it first
"This is urgent, just fix it"A wrong fix wastes more time10 minutes of diagnosis saves hours
"The fix is obvious from the stack trace"Stack traces show symptoms, not causesTrace backward to the root cause

Output Template

Use this response structure:

  • Observed vs Expected
  • Repro and Environment
  • Hypotheses and Tests
  • Options and Recommendation
  • Validation Plan and Results
  • Open Questions

评价

还没有评价。欢迎分享你的使用感受。

评论

无需登录即可发表。欢迎分享使用感受、提问,或说明在哪些环境下无法运行。

还没有评论。来写第一条吧。

提交后会立即公开。请勿填写邮箱、电话等个人信息。URL 最多 2 个。

0 / 1000 字

此表单受 reCAPTCHA 保护,适用 Google 的隐私权政策和服务条款。

同一仓库的技能

Find active Codex, Claude Code, and other AI agents, inspect their recent context, and exchange messages with them. Use it to locate an agent, share information, or send a request and wait for a reply through ai-devkit commands.

中文简介正在准备中。当前显示英语简介。

  • Finding an active agent by name or status
  • Checking an agent’s recent context before contacting it
  • Sending information or requesting a reply from another agent
codeaholicguy/ai-devkit16542026年10月25日 更新

Manage running AI agents with ai-devkit commands: identify sessions, list and inspect agents, start workers, assign or group tasks, resume sessions, and stop agents. The skill helps track assignments and verify completed work before reporting it.

中文简介正在准备中。当前显示英语简介。

  • List agents and identify the current session
  • Inspect an agent before assigning work
  • Start a worker and delegate a task
codeaholicguy/ai-devkit16542026年10月25日 更新

Coordinate ongoing work across multiple agents by checking progress, resolving dependencies, unblocking agents, relaying relevant results, and verifying completion. Use it to supervise a shared workflow across repeated check-ins.

中文简介正在准备中。当前显示英语简介。

  • Coordinating agents with dependent tasks
  • Unblocking an agent waiting for input
  • Relaying results between agents
codeaholicguy/ai-devkit16542026年10月25日 更新

Check whether AI DevKit is ready on the local machine, identify setup gaps it can address, and run the narrowest relevant setup for supported agent harnesses. Recheck status afterward and report remaining manual actions.

中文简介正在准备中。当前显示英语简介。

  • Check whether local AI DevKit setup is ready
  • Set up missing supported agent integrations
  • Review remaining setup steps after onboarding
codeaholicguy/ai-devkit16542026年10月25日 更新

Explore ideas for products, content, names, strategies, technical approaches, or decisions. It frames the goal and constraints, generates distinct options, challenges assumptions and tradeoffs, then narrows the result to three strong choices with reasons and a next step.

中文简介正在准备中。当前显示英语简介。

  • Generating and comparing product or project ideas
  • Exploring names, content angles, or campaign concepts
  • Pressure-testing technical approaches or important decisions
codeaholicguy/ai-devkit16542026年10月25日 更新

changelog

免费

Update the top Unreleased section of CHANGELOG.md using commits since the latest release. Add one concise linked line per commit, using a pull request link when evidence is clear and a commit link otherwise, while preserving the file’s existing style.

中文简介正在准备中。当前显示英语简介。

  • Adding recent commits to an Unreleased changelog
  • Creating release notes from commits since the last release
  • Linking changelog entries to their commits or pull requests
codeaholicguy/ai-devkit16542026年10月25日 更新

查看 codeaholicguy 的全部技能

报告此技能的问题