refactoring-team
Iterative code refactoring through progressive lenses via a worker-reviewer agent team.
- License 许可
- Unlicense
- 所属仓库
- saski/arnesto
- 最近更新
- 2026-11-12
- Stars
- ★ 6
- Forks
- 0
01 前言 Front Matter
- name
- refactoring-team
- hooks
- { "TeammateIdle": [ { "hooks": [ { "type": "command", "command": "${CLAUDE_SKILL_DIR}/references/guard-idle-worker.sh" } ] } ] }
- description
- Iterative code refactoring through progressive lenses via a worker-reviewer agent team.
- argument-hint
- [target-path]
- disable-model-invocation
- true
02 资源文件 50
- 脚本references/guard-idle-worker.sh393 B
- 参考文档references/lenses/01-formatting.md524 B
- 参考文档references/lenses/02-naming.md2.0 KB
- 参考文档references/lenses/03-method-length.md1.8 KB
- 参考文档references/lenses/04-abstraction-consistency.md2.2 KB
- 参考文档references/lenses/05-primitive-obsession.md1.6 KB
- 参考文档references/lenses/06-domain-alignment.md2.0 KB
- 参考文档references/lenses/07-patterns.md878 B
- 参考文档references/lenses/08-duplication.md1.9 KB
- 参考文档references/lenses/09-structural-storytelling.md1021 B
- 参考文档references/lenses/10-semantic-clarity.md1.4 KB
- 参考文档references/lenses/11-conditionals.md1.8 KB
- 参考文档references/lenses/12-magic-values.md1.0 KB
- 参考文档references/lenses/13-comments.md1.2 KB
- 参考文档references/lenses/14-cohesion.md2.3 KB
- 参考文档references/lenses/15-responsibility.md1.6 KB
- 参考文档references/lenses/16-coupling.md1.3 KB
- 参考文档references/lenses/17-api-interface.md1.2 KB
- 参考文档references/lenses/18-mutable-state.md1.2 KB
- 参考文档references/lenses/19-error-handling.md1.9 KB
- 参考文档references/lenses/20-wrong-abstraction.md1.4 KB
- 参考文档references/lenses/21-emergent-design.md1.3 KB
- 参考文档references/lenses/22-outside-box.md751 B
- 参考文档references/lenses/23-final-review.md1.4 KB
- 参考文档references/reviewer-guides/01-formatting.reviewer.md612 B
- 参考文档references/reviewer-guides/02-naming.reviewer.md1.8 KB
- 参考文档references/reviewer-guides/03-method-length.reviewer.md1.7 KB
- 参考文档references/reviewer-guides/04-abstraction-consistency.reviewer.md1.9 KB
- 参考文档references/reviewer-guides/05-primitive-obsession.reviewer.md2.0 KB
- 参考文档references/reviewer-guides/06-domain-alignment.reviewer.md2.0 KB
- 参考文档references/reviewer-guides/07-patterns.reviewer.md941 B
- 参考文档references/reviewer-guides/08-duplication.reviewer.md2.2 KB
- 参考文档references/reviewer-guides/09-structural-storytelling.reviewer.md889 B
- 参考文档references/reviewer-guides/10-semantic-clarity.reviewer.md1.2 KB
- 参考文档references/reviewer-guides/11-conditionals.reviewer.md1.9 KB
- 参考文档references/reviewer-guides/12-magic-values.reviewer.md1.0 KB
- 参考文档references/reviewer-guides/13-comments.reviewer.md1.1 KB
- 参考文档references/reviewer-guides/14-cohesion.reviewer.md2.3 KB
- 参考文档references/reviewer-guides/15-responsibility.reviewer.md1.6 KB
- 参考文档references/reviewer-guides/16-coupling.reviewer.md1.5 KB
- 参考文档references/reviewer-guides/17-api-interface.reviewer.md1.0 KB
- 参考文档references/reviewer-guides/18-mutable-state.reviewer.md1.1 KB
- 参考文档references/reviewer-guides/19-error-handling.reviewer.md1.9 KB
- 参考文档references/reviewer-guides/20-wrong-abstraction.reviewer.md1.6 KB
- 参考文档references/reviewer-guides/21-emergent-design.reviewer.md1.4 KB
- 参考文档references/reviewer-guides/22-outside-box.reviewer.md796 B
- 参考文档references/reviewer-guides/23-final-review.reviewer.md2.5 KB
- 参考文档references/reviewer-prompt.md1.8 KB
- 参考文档references/worker-prompt.md1.1 KB
- 参考文档refine-lens-process.md4.6 KB
03 SKILL.md 正文
STARTER_CHARACTER = 💎
Prerequisites
Agent teams must be enabled in settings:
{
"env": {
"CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS": "1"
}
}
If not set, offer to add it before proceeding.
Setup
If $ARGUMENTS provided, use as target path. Otherwise ask for:
- Target path (files or folder to refactor)
- Test command to verify changes
Verify the target path exists and tests pass before proceeding.
Launch the Team
Generate a short random ID: head -c 3 /dev/urandom | xxd -p | head -c 3
Use it to name the teammates:
- Worker:
worker-ID(e.g.worker-a3f) - Reviewer:
reviewer-ID(e.g.reviewer-a3f)
Read the spawn prompts:
- Worker: references/worker-prompt.md
- Reviewer: references/reviewer-prompt.md
Before spawning, replace these placeholders in both prompts:
TARGET_PATH→ actual target pathTEST_COMMAND→ actual test commandLENSES_DIR→${CLAUDE_SKILL_DIR}/references/lensesGUIDES_DIR→${CLAUDE_SKILL_DIR}/references/reviewer-guidesWORKER_NAME→ the worker's name (e.g.worker-a3f)REVIEWER_NAME→ the reviewer's name (e.g.reviewer-a3f)
After Launch
Tell the user:
- Shift+Down cycles between worker and reviewer
- For split panes: set
teammateMode: "tmux"in settings
Monitor Progress
When a worker goes idle, read .refactoring-state to check the lens number. If it skipped a value, message the reviewer to go back and complete the skipped lens first.
04 同仓库更多 Skills
visualize
Use /visualize for creating compact charts, diagrams, or other visuals inline as part of the conversation itself. It chooses among Markdown tables, Mermaid, inline HTML, and other supported in-transcript forms. Use Canvas for durable artifacts outside the transcript that users may revisit, refine, or share.
update-cursor-settings
Modify Cursor/VSCode user settings in settings.json. Use when you want to change editor settings, preferences, configuration, themes, font size, tab size, format on save, auto save, keybindings, or any settings.json values.
update-cli-config
View and modify Cursor CLI configuration settings in ~/.cursor/cli-config.json. Use when the user wants to change CLI settings, configure permissions, switch approval mode, enable vim mode, toggle display options, configure sandbox, or manage any CLI preferences.
statusline
Configure a custom status line in the CLI. Use when the user mentions status line, statusline, statusLine, CLI status bar, prompt footer customization, or wants to add session context above the prompt.
split-to-prs
Split current work into small reviewable PRs. Use when the user asks to split a chat, set of changes, branch, or PR.
shell
Runs the rest of a /shell request as a literal shell command. Use only when the user explicitly invokes /shell and wants the following text executed directly in the terminal.