AGENT SKILL

book--refactoring-guru--nano

Refactoring Guru (Refactoring.Guru) — Minimal rules — essential one-liners only. Use when asked to apply Refactoring Guru principles or review code against Refactoring Guru standards.

License 许可
MIT
最近更新
2026-11-14
Stars
★ 13
Forks
2

01 前言 Front Matter

name
book--refactoring-guru--nano
origin
github.com/ciembor/agent-rules-books (MIT)
license
MIT
version
1.0.0
description
Refactoring Guru (Refactoring.Guru) — Minimal rules — essential one-liners only. Use when asked to apply Refactoring Guru principles or review code against Refactoring Guru standards.
compatibility
yana-ai >= 0.14.0

03 SKILL.md 正文

OBEY Refactoring.Guru

When to use

Use as a compact always-on bias for safe, smell-driven refactoring during existing-code changes.

Primary bias to correct

Refactoring is not cleanup for its own sake: diagnose one smell, treat it with the smallest behavior-preserving move, verify, then stop.

Decision rules

  • Separate structural refactoring from feature and bug behavior; if behavior changes, name and isolate it.
  • Diagnose the smell before choosing a technique: symptom, cost, smallest treatment, verification, and stop condition.
  • Prefer small named transformations over broad redesign.
  • Keep the program runnable and run relevant checks after risky movement, state-flow changes, public API changes, or algorithm replacement.
  • Stop when the diagnosed smell is reduced; do not chase new smells unless they block the current change.
  • Prefer extraction, naming, movement, inlining, and encapsulation before adding hierarchy, polymorphism, wrappers, or method objects.
  • Do not create abstractions from coincidental similarity, random parameter bags, simple conditionals, or speculative future needs.
  • Keep behavior with the data it changes unless separation intentionally supports interchangeable behavior.
  • Preserve public compatibility when changing signatures, constructors, visibility, hierarchy, or externally reachable code.
  • Delete or inline dispensable code only after checking public, generated, reflected, serialized, plugin-facing, framework, and test-only uses.

Trigger rules

  • When a method needs comments or local-state reconstruction, extract a named method after checking inputs, outputs, and mutated variables.
  • When a class changes for unrelated reasons, extract the responsibility; use subclass/interface only for stable variants or real client subsets.
  • When conditionals repeat by type or state, isolate the decision before using polymorphism; leave simple honest conditionals alone.
  • When duplicate code appears the third time, refactor unless the similarity is likely to diverge.
  • When parameter lists or primitive clumps carry one concept, model the concept; do not pass a huge object to hide dependency.
  • When clients navigate chains or internals, hide the delegate or move behavior; remove pass-through middle men that add no policy.
  • When null, error code, assertion, value/reference, or association changes are considered, verify semantics before changing structure.

Final checklist

  • Smell named?
  • Smallest treatment?
  • Behavior verified?
  • Stop condition reached?
  • No hidden feature change?
  • No speculative abstraction?

04 同仓库更多 Skills

Horonomos-laps
Horonomos-laps/Yana-AI

openai--sentry--sentry

Use when the user asks to inspect Sentry issues or events, summarize recent production errors, or pull basic Sentry health data via the Sentry API; perform read-only queries with the bundled script and require `SENTRY_AUTH_TOKEN`.

★ 13
Horonomos-laps
Horonomos-laps/Yana-AI

ito-basket-compare

Compare Itô prediction-market baskets against a user's knowledge base, portfolio notes, financial context, watchlist, or research thesis. Use for read-only basket comparison and gap analysis without investment advice or live trading.

★ 13
Horonomos-laps
Horonomos-laps/Yana-AI

implementing-network-traffic-baselining

Build network traffic baselines from NetFlow/IPFIX data using Python pandas for statistical analysis, z-score anomaly detection, and hourly/daily traffic pattern profiling

★ 13
Horonomos-laps
Horonomos-laps/Yana-AI

detecting-evasion-techniques-in-endpoint-logs

Detects defense evasion techniques used by adversaries in endpoint logs including log tampering, timestomping, process injection, and security tool disabling. Use when investigating suspicious endpoint behavior, building detection rules for evasion tactics, or conducting threat hunting for stealthy adversary activity. Activates for requests involving evasion detection, defense evasion analysis, log tampering detection, or MITRE ATT&CK TA0005.

★ 13
Horonomos-laps
Horonomos-laps/Yana-AI

implementing-microsegmentation-with-guardicore

Implementing microsegmentation using Akamai Guardicore Segmentation to map application dependencies, create granular network policies, visualize east-west traffic flows, and enforce least-privilege communication between workloads across data centers and cloud.

★ 13
Horonomos-laps
Horonomos-laps/Yana-AI

ramdisk-tmpfs-patterns

暂无简介

★ 13