Agent skill

Request Refactor Plan

by ProgrammerAnthony in ProgrammerAnthony/Anything-Extract

通过用户访谈创建一个详细的重构计划,并将其拆分成很小的提交(tiny commits),最后以 GitHub issue 的形式归档。适用于用户希望规划一次重构、创建重构 RFC,或把重构拆成安全的渐进步骤。

MITAuto-check passedDevelopment

Install Request Refactor Plan

skills CLI
$ npx skills add ProgrammerAnthony/Anything-Extract --skill request-refactor-plan -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install ProgrammerAnthony/Anything-Extract request-refactor-plan --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/ProgrammerAnthony/Anything-Extract.git skills-src && mkdir -p .claude/skills && cp -r skills-src/.agents/skills/request-refactor-plan .claude/skills/request-refactor-plan && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
request-refactor-plan
GitHub stars
139
Token cost
~292 tokens
SKILL.md length
60 words
Files
1
Skills in repo
13
Repo updated
First seen
Licence
MIT

At a glance

通过用户访谈创建一个详细的重构计划,并将其拆分成很小的提交(tiny commits),最后以 GitHub issue 的形式归档。适用于用户希望规划一次重构、创建重构 RFC,或把重构拆成安全的渐进步骤。

  • Works in 8 steps: 向用户索要一份长篇、细节充分的问题描述:他们想解决的是什么问题;以及任何可能的解决… → 探索仓库:用于验证用户的判断,并理解当前代码库状态。 → 询问用户是否考虑过其他方案,并把这些备选方案一并呈现给用户。 → …
  • Tasks that involve Refactoring
  • SKILL.md covers 问题陈述(Problem Statement), 解决方案(Solution), 提交(Commits) and 决策文档(Decision Document), plus 3 more sections
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md

What it does

Request Refactor Plan is an agent skill from ProgrammerAnthony/Anything-Extract. 通过用户访谈创建一个详细的重构计划,并将其拆分成很小的提交(tiny commits),最后以 GitHub issue 的形式归档。适用于用户希望规划一次重构、创建重构 RFC,或把重构拆成安全的渐进步骤。

Its SKILL.md is about 290 tokens, which your agent loads only when the skill is triggered. It is a single SKILL.md file with no bundled scripts.

It sits in Development, covering Refactoring. It works with GitHub. The repository describes itself as: 高效文档识别&知识库&本地启动,前后端;整合QAnything、dify等思想和源码,快速批量可靠提取文档关键信息并导出. The licence is MIT.

When your agent uses it

  • Tasks that involve Refactoring

Example prompts

  • “/request-refactor-plan”

Workflow steps

8 steps, taken from the first numbered list in SKILL.md.

  1. 向用户索要一份长篇、细节充分的问题描述:他们想解决的是什么问题;以及任何可能的解决想法。
  2. 探索仓库:用于验证用户的判断,并理解当前代码库状态。
  3. 询问用户是否考虑过其他方案,并把这些备选方案一并呈现给用户。
  4. 围绕实现方案对用户进行访谈:要尽可能详细、透彻。
  5. 明确重构实现的准确范围:梳理你计划改什么、以及你计划不改什么。
  6. 查看代码库中该区域的测试覆盖情况:如果测试覆盖不足,询问用户他们打算如何安排测试。
  7. 把实现拆解成“由一串微小提交组成”的计划。记住 Martin Fowler 的建议:让每一步重构都尽可能小,以便你随时能看到程序仍然在工作。
  8. 使用该重构计划创建 GitHub issue。issue 描述使用如下模板

What it can do on your machine

Read from SKILL.md and the folder at commit f1ed557. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    No scripts in the folder and no shell commands in SKILL.md.

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Request Refactor Plan loads about 292 tokens when it runs. Until then it costs about 32 tokens; SKILL.md has 60 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~32
When it runs · the whole SKILL.md, loaded when a task matches
~292

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from ProgrammerAnthony/Anything-Extract at commit f1ed557, republished under its MIT licence (© ProgrammerAnthony). 60 words, ~292 tokens.

Download SKILL.mdSave it as .claude/skills/request-refactor-plan/SKILL.md (or your agent's skills folder).
name
request-refactor-plan
description
通过用户访谈创建一个详细的重构计划,并将其拆分成很小的提交(tiny commits),最后以 GitHub issue 的形式归档。适用于用户希望规划一次重构、创建重构 RFC,或把重构拆成安全的渐进步骤。

当用户希望创建“重构请求(refactor request)”时会调用本技能。你需要按下方步骤执行;如果你认为某些步骤不必要,可以跳过。

  1. 向用户索要一份长篇、细节充分的问题描述:他们想解决的是什么问题;以及任何可能的解决想法。

  2. 探索仓库:用于验证用户的判断,并理解当前代码库状态。

  3. 询问用户是否考虑过其他方案,并把这些备选方案一并呈现给用户。

  4. 围绕实现方案对用户进行访谈:要尽可能详细、透彻。

  5. 明确重构实现的准确范围:梳理你计划改什么、以及你计划不改什么。

  6. 查看代码库中该区域的测试覆盖情况:如果测试覆盖不足,询问用户他们打算如何安排测试。

  7. 把实现拆解成“由一串微小提交组成”的计划。记住 Martin Fowler 的建议:让每一步重构都尽可能小,以便你随时能看到程序仍然在工作。

  8. 使用该重构计划创建 GitHub issue。issue 描述使用如下模板:

<refactor-plan-template>

问题陈述(Problem Statement)

从开发者视角来看,开发者正在面临的问题。

解决方案(Solution)

从开发者视角来看,针对该问题的解决方案。

提交(Commits)

一份很长、很详细的实现计划。请用通俗英文(plain English)来写,尽可能把实现拆分成“最小粒度”的提交。每一次提交都应保证代码库处于可工作的状态。

决策文档(Decision Document)

实现决策列表。可能包括:

  • 将要构建/修改的模块
  • 将要修改的这些模块的接口
  • 开发者提供的技术澄清
  • 架构层面的决策
  • schema 变更
  • API 合约
  • 具体交互方式

不要包含具体文件路径或代码片段。这些内容很可能会在很快之后变得过时。

测试决策(Testing Decisions)

测试决策列表。需要包含:

  • 什么才算是“好测试”(只测外部行为,不测实现细节)
  • 将要被测试的模块
  • 测试的先例/参考(即仓库中类似类型测试的对照)

不在范围内(Out of Scope)

描述本次重构明确不包含哪些内容。

进一步备注(Further Notes,可选)

关于该次重构的其他补充说明。

</refactor-plan-template>

© ProgrammerAnthony, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

Just SKILL.md in .agents/skills/request-refactor-plan of ProgrammerAnthony/Anything-Extract.

Open the folder on GitHubat commit f1ed557

Compare with similar skills

Request Refactor Plan next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Request Refactor Plan compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Request Refactor Plan this skillProgrammerAnthony/Anything-Extract139—~292Automated safety check: PassMIT
Valgocohesivestack/valgo508—~2.4kAutomated safety check: PassMIT
Rust Hygiene Audittsz-org/tsz577—~1.5kAutomated safety check: PassApache-2.0
iOS FixMacMagazine/app-iOS171—~957Automated safety check: PassNone
External Contributor Issuesaxelixlabs/axelix148—~2.2kAutomated safety check: PassLGPL-3.0
Request Refactor Planfossasia/eventyay-interpretation1.6k10 repos~678Automated safety check: PassApache-2.0

Similar skills

  • Valgo

    cohesivestack/valgo

    Add, refactor, debug, review, explain, or migrate type-safe validation in consumer Go applications using github.com/cohesivestack/valgo.

    508 GitHub stars~2.4k tokensUpdated 1 mo ago
    DevelopmentAuto-check passed
  • Run a deep DRY + code-hygiene audit of the Rust workspace and turn the findings into verified, deduplicated, hierarchical GitHub tech-debt issues.

    577 GitHub stars~1.5k tokensUpdated 28 days ago
    DevelopmentAuto-check passed
  • iOS Fix

    MacMagazine/app-iOS

    Bug-fix and refactoring workflow for MacMagazine — root cause analysis, pattern-matching fix, regression verification.

    171 GitHub stars~957 tokensUpdated today
    DevelopmentAuto-check passed
  • Pick open GitHub issues in the Axelix monorepo that are suitable for unpaid volunteer contributors working in their spare time.

    148 GitHub stars~2.2k tokensUpdated today
    DevelopmentAuto-check passed
  • Request Refactor Plan

    fossasia/eventyay-interpretation

    Create a detailed refactor plan with tiny commits via user interview, then file it as a GitHub issue.

    1.6k GitHub starsUsed in 10 repos~678 tokens
    DevelopmentAuto-check passed
  • Refactor Analysis

    Samsung/TizenFX

    Automatically scans the TizenFX codebase on a rotating schedule to discover .NET 8 / C 12+ refactoring targets and register them as GitHub Issues.

    214 GitHub stars~2.6k tokensUpdated today
    DevelopmentAuto-check passed

More from ProgrammerAnthony/Anything-Extract

All 13 skills in this repo
  • Backend Code Review

    ProgrammerAnthony/Anything-Extract

    指导在项目(python项目)中队后端代码进行质量、安全、可维护性与最佳实践审查,基于既定规则清单。适用于用户请求对 backend/ 下后端文件(如 .py)进行审查、分析或改进。不用于前端文件(如 .tsx、.ts、.js)。支持待提交变更审查、代码片段审查、按文件审查。

    139 GitHub stars~791 tokensUpdated 4 mo ago
    Auto-check passed
  • Frontend Code Review

    ProgrammerAnthony/Anything-Extract

    指导在项目中对前端代码(Next.js/React/TypeScript/Tailwind 等)进行结构、可维护性、性能与一致性审查,基于既定规则清单。适用于用户请求审查 .tsx/.ts/.js/.jsx 等前端文件或前端目录下的页面与组件。不用于后端代码(如 .py)。

    139 GitHub stars~957 tokensUpdated 4 mo ago
    Auto-check passed
  • Design An Interface

    ProgrammerAnthony/Anything-Extract

    使用并行子 agent 为某个模块生成多个根本不同的接口设计。适用于用户希望设计某个 API、探索接口选项、对比模块形状(module shapes),或提到“design it twice(把它设计两遍)”。

    139 GitHub stars~448 tokensUpdated 4 mo ago
    Auto-check passed
  • TDD

    ProgrammerAnthony/Anything-Extract

    使用 RED-GREEN-重构(red-green-refactor)循环进行测试驱动开发。适用于用户希望用 TDD 构建新功能或修复 bug,提到 “red-green-refactor”,希望使用集成测试,或询问“test-first development(先写测试)”。

    139 GitHub stars~572 tokensUpdated 4 mo ago
    Auto-check passed
  • Ubiquitous Language

    ProgrammerAnthony/Anything-Extract

    从当前对话中抽取 DDD 风格的“统一语言”术语表(ubiquitous language glossary),标记歧义,并提出规范的术语选择。保存为 UBIQUITOUSLANGUAGE.md。适用于用户希望定义领域术语、构建术语表、固化用词并强化术语一致性,或提到 “domain model” / “DDD”(领域模型与 DDD)。

    139 GitHub stars~647 tokensUpdated 4 mo ago
    Auto-check passed
  • Write A Skill

    ProgrammerAnthony/Anything-Extract

    以正确的技能结构、渐进式披露与打包资源来创建新的 agent 技能。适用于用户希望创建、编写或构建新的技能. An agent skill from ProgrammerAnthony/Anything-Extract.

    139 GitHub stars~407 tokensUpdated 4 mo ago
    Auto-check passed

Works with

Categories

Questions about Request Refactor Plan

What does Request Refactor Plan do?

通过用户访谈创建一个详细的重构计划,并将其拆分成很小的提交(tiny commits),最后以 GitHub issue 的形式归档。适用于用户希望规划一次重构、创建重构 RFC,或把重构拆成安全的渐进步骤。. Request Refactor Plan is an agent skill from ProgrammerAnthony/Anything-Extract.

When should I use Request Refactor Plan?

Request Refactor Plan fits situations like: tasks that involve Refactoring.

How do I install Request Refactor Plan in Claude Code?

Run `npx skills add ProgrammerAnthony/Anything-Extract --skill request-refactor-plan -a claude-code`. Or copy the skill folder (.agents/skills/request-refactor-plan in ProgrammerAnthony/Anything-Extract) into .claude/skills/request-refactor-plan in your project. Claude Code loads it when a task matches its description.

How do I install Request Refactor Plan in Codex?

Run `npx skills add ProgrammerAnthony/Anything-Extract --skill request-refactor-plan -a codex`. Or copy the skill folder (.agents/skills/request-refactor-plan in ProgrammerAnthony/Anything-Extract) into .agents/skills/request-refactor-plan in your project. Codex loads it when a task matches its description.

Can I use Request Refactor Plan in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add ProgrammerAnthony/Anything-Extract --skill request-refactor-plan -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/request-refactor-plan, .gemini/skills/request-refactor-plan, .github/skills/request-refactor-plan and .opencode/skills/request-refactor-plan in your project.

What does Request Refactor Plan need to run?

SKILL.md names no scripts, command-line tools or credentials: Request Refactor Plan is instructions for the agent only.

Does Request Refactor Plan access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is Request Refactor Plan safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Request Refactor Plan use?

Request Refactor Plan is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Request Refactor Plan use?

About 292 tokens (SKILL.md is roughly 1.2k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Request Refactor Plan?

Skills that share tags, products or a category with Request Refactor Plan: Valgo (cohesivestack/valgo, 508 stars), Rust Hygiene Audit (tsz-org/tsz, 577 stars), iOS Fix (MacMagazine/app-iOS, 171 stars) and External Contributor Issues (axelixlabs/axelix, 148 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Request Refactor Plan?

ProgrammerAnthony (a GitHub user) maintains it in ProgrammerAnthony/Anything-Extract, which has 139 GitHub stars. The repository holds 13 skills in this directory. The repository was last updated on May 13, 2026.

Source: ProgrammerAnthony/Anything-Extract on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.