Agent Skills › tzachbon/smart-ralph › ralph-specum-refactor

ralph-specum-refactor

GitHub

用于在实现后根据新发现修订规格文档。作为协调者，不直接修改文件，而是将进度、现有规格及实现反馈委托给重构专家子代理进行更新，确保需求、设计和任务的一致性，并引导用户审批或继续。

plugins/ralph-specum-codex/skills/ralph-specum-refactor/SKILL.md tzachbon/smart-ralph

Trigger Scenarios

用户明确要求使用 $ralph-specum-refactor 用户要求 Ralph Specum 在 Codex 中基于实现学习修订规格工件

Install

npx skills add tzachbon/smart-ralph --skill ralph-specum-refactor -g -y

More Options

Non-standard path

npx skills add https://github.com/tzachbon/smart-ralph/tree/main/plugins/ralph-specum-codex/skills/ralph-specum-refactor -g -y

Use without installing

npx skills use tzachbon/smart-ralph@ralph-specum-refactor

指定 Agent (Claude Code)

npx skills add tzachbon/smart-ralph --skill ralph-specum-refactor -a claude-code -g -y

安装 repo 全部 skill

npx skills add tzachbon/smart-ralph --all -g -y

预览 repo 内 skill

npx skills add tzachbon/smart-ralph --list

SKILL.md

Frontmatter

{
    "name": "ralph-specum-refactor",
    "metadata": {
        "action": "refactor",
        "surface": "helper"
    },
    "description": "This skill should be used only when the user explicitly asks to use `$ralph-specum-refactor`, or explicitly asks Ralph Specum in Codex to revise spec artifacts after implementation learnings."
}

Ralph Specum Refactor

You are a coordinator, not a refactor specialist -- delegate spec revision to a refactor-specialist sub-agent.

Contract

Resolve the active spec by explicit path, exact name, or .current-spec
Review files in order: requirements.md, design.md, tasks.md
Cascade downstream updates when upstream content changes

Action

Resolve the target spec.
Read .progress.md and existing spec files.
Delegate spec revision to a refactor-specialist sub-agent. Pass .progress.md, existing spec files, and implementation learnings. The sub-agent identifies what changed, what stayed accurate, and what is obsolete. Do NOT revise spec files yourself.
The sub-agent preserves newer Ralph concepts already expressed in the spec, including approval checkpoints, granularity choices, [P] tasks, [VERIFY] tasks, VE tasks, and epic constraints when relevant.
The sub-agent updates files in order:
- requirements.md
- design.md
- tasks.md
If requirements changed, revisit design and tasks.
If design changed, revisit tasks.
Record the rationale and cascade decisions in .progress.md.

Response Handoff

After revising spec files, name the files that changed and summarize the updates briefly.
End with exactly one explicit choice prompt:
- approve current artifact
- request changes
- continue to implementation
Treat continue to implementation as approval of the updated spec files.