Communityコーディング&開発github.com

安全リファクタリング

動作を維持しながらコード構造を再編成します。抽出、統合、所有権移動、クリーンアップに使用し、構造的編集の前後で検証を行います。

安全リファクタリング とは?

このスキルは、コードの動作を変更せずに構造を安全に再編成するためのリファクタリング手法を提供します。具体的には、機能変更とリファクタリングを分離し、一度に一つの所有権境界のみを移動し、公開インターフェースや障害動作、順序、互換性を明示的にスコープ外としない限り維持します。中間状態は常にビルド可能かつテスト可能に保つ必要があります。また、依存関係や構成を不必要に増やさないように注意します。このスキルは、Claude Code、Cursor、CodexなどのAIエージェントプラットフォーム向けに設計されており、リファクタリング前後で同じ証明(テストなど)を実行し、動作が一致し、要求された構造が達成されるまで停止しないという明確なガイドラインを提供します。開発者はこれを利用して、安全かつ確実にコードベースを整理・改善できます。

対応~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/JuliusBrussee/caveman/tree/main/skills/safe-refactor

Installed? Explore more コーディング&開発 skills: steipete/bluebubbles, steipete/eightctl, steipete/blucli · View all 6 →

お気に入りのAIに質問する

このエージェントスキルを事前に読み込んだ状態で新しいチャットを開きます。

ドキュメント

安全リファクタリング は何をしますか?

動作保存の境界を定義し、構造的編集の前に検証を確立します。

  • 機能変更はリファクタリングの範囲外に保ちます。
  • 一度に一つの所有権境界のみを移動します。
  • 公開インターフェース、障害動作、順序、および互換性は、明示的にスコープ外としない限り維持します。
  • 中間状態はビルド可能かつテスト可能に保ちます。
  • 正当性の必要性なく依存関係や設定を増やさないようにします。

変更後に同じ証明を実行します。動作が一致し、要求された構造が達成されるまで停止しません。

Individual skills in this repo

This repo contains 12 individual skills — each has its own dedicated page.

JuliusBrussee/caveman-discover

Find and label every LLM workflow in the repository so Caveman Cloud groups spend by workflow instead of one bucket. Use for "discover workflows" or breaking LLM spend down by workflow.

JuliusBrussee/caveman-evidence-review

Read-only review of Caveman Cloud evidence: cost, Cave Score, workflows, traces, latency, errors, routing, savings. Use when asked what Caveman found or where LLM spend goes.

JuliusBrussee/caveman-explore

Read-only repository explorer for cold-start orientation, broad cross-file localization, or when a direct search failed. Skip it when the exact file or symbol is already named. Returns path:line citations only; its reads stay out of main context.

JuliusBrussee/caveman-learn

Act on a Caveman learn report - review the ranked token sinks, apply cost-lowering fixes with per-edit consent, and report what those fixes returned. Use when asked to lower an agent's token cost, what caveman has saved, to trim a heavy CLAUDE.md, or to offload re-pasted context into cavemem.

JuliusBrussee/caveman-manage

Inspect Caveman Cloud's experiment lifecycle and block unsafe execution. Use when asked to start, approve, cancel, promote or roll back a Caveman experiment.

JuliusBrussee/caveman-optimize

Turn a Caveman optimization observation into an operator-chosen candidate with a paired baseline evaluation. Use when asked to inspect or evaluate a Caveman optimization report. Needs explicit approval.

JuliusBrussee/caveman-setup

Wire a repository through the Caveman Cloud gateway so every LLM request is measured, with no behavior change. Use for "set up caveman" or adding LLM spend observability.

JuliusBrussee/investigate-first

Diagnose ambiguous failures before editing. Use for unknown causes, intermittent behavior, performance regressions, or investigations needing evidence-ranked hypotheses.

JuliusBrussee/lean-build

Build feature work with high overbuilding risk. Use for new behavior, product slices, or integrations where repository reuse, strict scope, and an explicit stop condition matter.

JuliusBrussee/migration

Implement reversible compatibility-safe transitions. Use for schema, data, API, protocol, configuration, or dependency migrations requiring rollback and preservation proof.

JuliusBrussee/surgical-patch

Fix bugs and small behavior changes at the narrowest responsible layer. Use when regression proof, preserved surrounding behavior, and task-relevant tests matter.

JuliusBrussee/verify-and-stop

Prove existing work meets acceptance conditions without expanding scope. Use for validation-only tasks, completion checks, focused gate runs, and last-mile proof.

関連スキル