Agent Skills › codeaholicguy/ai-devkit › simplify-implementation

simplify-implementation

GitHub

分析并简化现有代码实现，降低复杂度、提升可维护性与可扩展性。在用户请求简化代码、重构以提高可读性或减少技术债务时使用。遵循先分析后修改的原则，确保方案经批准后再执行，优先复用标准库和现有依赖，避免过度抽象。

skills/simplify-implementation/SKILL.md codeaholicguy/ai-devkit

Trigger Scenarios

用户要求简化代码需要降低代码复杂度请求重构以提高可读性清理实现细节提升代码可维护性减少技术债务使代码更易于理解

Install

npx skills add codeaholicguy/ai-devkit --skill simplify-implementation -g -y

More Options

Use without installing

npx skills use codeaholicguy/ai-devkit@simplify-implementation

指定 Agent (Claude Code)

npx skills add codeaholicguy/ai-devkit --skill simplify-implementation -a claude-code -g -y

安装 repo 全部 skill

npx skills add codeaholicguy/ai-devkit --all -g -y

预览 repo 内 skill

npx skills add codeaholicguy/ai-devkit --list

SKILL.md

Frontmatter

{
    "name": "simplify-implementation",
    "description": "AI DevKit · Analyze and simplify existing implementations to reduce complexity, improve maintainability, and enhance scalability. Use when users ask to simplify code, reduce complexity, refactor for readability, clean up implementations, improve maintainability, reduce technical debt, or make code easier to understand."
}

Simplify Implementation Assistant

Reduce complexity with an analysis-first approach before changing code.

Hard Rules

Do not modify code until the user approves a simplification plan.
Readability over brevity. Some duplication beats the wrong abstraction.
Prefer reusing an existing function over introducing a new one — but only if it fits cleanly. Do not force-fit a near-match.
Before improving code, ask whether the function, abstraction, dependency, or custom logic needs to exist at all.
Prefer platform and standard-library features over custom code or dependencies. Use already-installed dependencies when they cleanly solve the problem; do not add a dependency for logic that is only a few clear lines.
For breaking changes: modify in place only when all callers are in-repo and updated in the same change. For public/external APIs, add a new function and deprecate the old one (parallel change).

Workflow

Gather Context

Confirm targets, pain points, and constraints (compatibility, API stability, deadlines).
Search for past simplification decisions or known constraints: npx ai-devkit@latest memory search --query "<target area>" --tags "simplify"

Analyze Complexity

Identify sources (nesting, duplication, coupling, over-engineering, magic values).
Run an existence check: can this code be deleted, delegated to the standard library, handled by a native platform feature, enforced by the database, or covered by an existing dependency?
Assess impact (LOC, dependencies, cognitive load, scalability blockers).

Apply Readability Principles

Apply the readability guide and its "Reading Test".

Propose Simplifications For each issue, apply a pattern:

Extract: Long functions → smaller, focused functions.
Consolidate: Duplicate code → shared utilities.
Flatten: Deep nesting → early returns, guard clauses.
Decouple: Tight coupling → dependency injection, interfaces.
Remove: Dead code, unused features, excessive abstractions.
Replace: Custom logic → standard-library, native platform, database, or already-installed dependency features.
Defer: Premature optimization → measure-first approach.

Prioritize and Plan

Rank by impact/risk. Present plan with before/after snippets. Request approval.

Red Flags and Rationalizations

Rationalization	Why It's Wrong	Do Instead
"While I'm here, let me refactor this too"	Scope creep breaks things	Only simplify what was requested
"This abstraction will help later"	Predicted reuse rarely materializes	Remove it unless used twice today
"Shorter is simpler"	Brevity can hide complexity	Optimize for readability, not line count
"I'll add a v2 instead of updating callers"	Accumulates dead code and forks the API	Modify in place when callers are in-repo; parallel-change only for external/public APIs
"Existing fn is close enough — I'll bend it to fit"	Wrong abstraction is costlier than duplication	Reuse only on clean fit; otherwise keep the small duplicate