- name
SKILL.md
技能檔案保留在發布者的儲存庫中。
在終端機中貼上複製的指令。它會將這個 SKILL.md 安裝到對應的代理中。
npx skills add Doist/todoist-cli --skill refactor -a cursor -y在終端機中貼上複製的指令。它會將這個 SKILL.md 安裝到對應的代理中。
npx skills add Doist/todoist-cli --skill refactor -a claude-code -y在終端機中貼上複製的指令。它會將這個 SKILL.md 安裝到對應的代理中。
npx skills add Doist/todoist-cli --skill refactor -a codex -y在終端機中貼上複製的指令。它會將這個 SKILL.md 安裝到對應的代理中。
npx skills add Doist/todoist-cli --skill refactor -a grok -y在 Grok Bot 聊天中傳送複製的訊息。Bot 會從 GitHub 取得這個 SKILL.md,並加入你所有 Bot 共用的技能中。
Install this skill: https://github.com/Doist/todoist-cli/tree/HEAD/.agents/skills/refactor來自發布者
A refactor changes structure, not behaviour. Bugs included: if you find one, note it for a separate fix and keep it as it is.
Find the tests that cover the code at its public interface: the command run through program.parseAsync(['node', 'td', ...]), or the exported helper. Where a behaviour has no test, add one that passes now, asserting what the code does today. Run them. Done when every behaviour you will touch has a passing test.
Remove code nothing reaches, if you can prove it: no caller (rg for every name, including the lazy command registry in src/index.ts and scripts/). Run the tests. Done when they pass.
Make one structural change, run the pinned tests, repeat. Migrate every caller and delete the old API; no shims left behind. Command names, flags, --json output shapes and error codes are what people's scripts and agents rely on, and SKILL_CONTENT documents them: keep them, or stop and ask (changing them is a breaking feat!: release). Done when the tests pass after each step and no caller uses the old shape.
Existing tests may change how they reach the code: import paths, names, call sites. They may not change their inputs or their assertions, including every expected output string. If an expected value changes, the behaviour changed: stop and say so.
Name what got easier to read or change. If you can't, revert. Done when you can say it in one sentence.
npm run verify, then report with the verify format. Say which tests pinned the behaviour, and confirm git diff shows no change to any test input or assertion.
Changes the structure of code without changing its behaviour, with the current behaviour pinned by tests first. Use when asked to "refactor", "clean up", "simplify", "extract", "rename", "move" or "de
---name: refactordescription: Changes the structure of code without changing its behaviour, with the current behaviour pinned by tests…---# .agents/skills/refactor/SKILL.md總覽
Changes the structure of code without changing its behaviour, with the current behaviour pinned by tests first. Use when asked to "refactor", "clean up", "simplify", "extract", "rename", "move" or "deduplicate" code, or when another task needs restructuring first.
常見問題
從發布者下載 .agents/skills/refactor/SKILL.md,或複製路徑後開啟儲存庫。PlugMCP 只收錄這項技能,不代管檔案。
發布者將它存放在 https://github.com/Doist/todoist-cli。
Claude、Cursor、Codex 和 Grok Build 可以讀取你從發布者儲存庫加入的 SKILL.md。在聊天中傳送技能的 GitHub 資料夾連結,Grok Bot 就會安裝它。