- name
SKILL.md
技能檔案保留在發布者的儲存庫中。
在終端機中貼上複製的指令。它會將這個 SKILL.md 安裝到對應的代理中。
npx skills add Doist/todoist-cli --skill fix-bug -a cursor -y在終端機中貼上複製的指令。它會將這個 SKILL.md 安裝到對應的代理中。
npx skills add Doist/todoist-cli --skill fix-bug -a claude-code -y在終端機中貼上複製的指令。它會將這個 SKILL.md 安裝到對應的代理中。
npx skills add Doist/todoist-cli --skill fix-bug -a codex -y在終端機中貼上複製的指令。它會將這個 SKILL.md 安裝到對應的代理中。
npx skills add Doist/todoist-cli --skill fix-bug -a grok -y在 Grok Bot 聊天中傳送複製的訊息。Bot 會從 GitHub 取得這個 SKILL.md,並加入你所有 Bot 共用的技能中。
Install this skill: https://github.com/Doist/todoist-cli/tree/HEAD/.agents/skills/fix-bug來自發布者
Write down what happens, what should happen, and the command that triggers it (td <command> <args>). If the report is vague, restate it to the owner and ask before going further. Done when the symptom fits in one sentence.
Write a test that fails on the exact symptom, at the lowest layer that shows it:
src/lib/ → its *.test.ts next to it;program.parseAsync(['node', 'td', ...]) with setupApiMock();src/index.integration.test.ts.Follow write-tests for helpers and the quality bar. Run the test and see it fail for the reason in step 1, not a typo or a missing mock. Done when the failure message describes the bug.
Trace from the symptom to the first place the data goes wrong. Name it with path:line. A fix at the symptom (a special case, a retry, a try/catch) is not a root cause. Done when you can say why the code does what it does.
Change only what the root cause needs. Note other bugs you find for a separate fix; don't fix them here. Restructuring goes to refactor, as its own change.
Undo the fix: the test fails. Restore it: the test passes. Then npm run verify. Done when you have seen both and verify prints Verified.
After three fixes that didn't turn the test green, stop. Your model of the bug is wrong. Re-read the failing output, question the test, and list what you have ruled out before trying again. Tell the owner if you're stuck.
Use the verify report format. Include the test name, the root cause line, and the undo/restore result.
Fixes a bug by reproducing it in a failing test first, then making the smallest change that turns it green. Use when something is "broken", "wrong", "fails", "doesn't work", throws an error, or a user
---name: fix-bugdescription: Fixes a bug by reproducing it in a failing test first, then making the smallest change that turns it green…---# .agents/skills/fix-bug/SKILL.md總覽
Fixes a bug by reproducing it in a failing test first, then making the smallest change that turns it green. Use when something is "broken", "wrong", "fails", "doesn't work", throws an error, or a user or issue reports a bug.
常見問題
從發布者下載 .agents/skills/fix-bug/SKILL.md,或複製路徑後開啟儲存庫。PlugMCP 只收錄這項技能,不代管檔案。
發布者將它存放在 https://github.com/Doist/todoist-cli。
Claude、Cursor、Codex 和 Grok Build 可以讀取你從發布者儲存庫加入的 SKILL.md。在聊天中傳送技能的 GitHub 資料夾連結,Grok Bot 就會安裝它。