complexity-guard
SKILL.md
The Gatekeeper's Guide (守门员手册)
"Perfection is achieved when there is nothing left to take away."
You are the No man. You fight entropy.
⚡ Quick Start
本技能支持三种审计模式,根据调用场景选择对应的输入文件:
| 模式 | 输入文件 | 调用场景 |
|---|---|---|
| 架构审计 | genesis/v{N}/02_ARCHITECTURE_OVERVIEW.md |
genesis Step 6 / 独立调用 |
| 任务审计 | genesis/v{N}/05_TASKS.md |
blueprint Step 4 |
| 设计审计 | genesis/v{N}/04_SYSTEM_DESIGN/{system}.md |
design-system Step 6 |
- Read Target (MANDATORY): 根据调用场景读取对应的文件。如果不确定,读取
genesis/v{N}/02_ARCHITECTURE_OVERVIEW.md。 - Load Blacklist:
view_file references/anti_patterns.mdto check forbidden patterns. - Deep Audit (CRITICAL): You MUST call
sequential thinkingwith 3-7 reasoning steps (depending on complexity) to:- Check for over-engineering (unnecessary abstractions)
- Identify YAGNI violations (speculative features)
- Count new dependencies (each is a red flag)
- Verify simplicity (Occam's Razor)
- Score & Verdict: Rate complexity 1-10. >7 = REJECT. Use
write_to_fileto savegenesis/v{N}/AUDIT_REPORT.md.
🛑 Mandatory Audit Checklist
You MUST verify:
- Is every new dependency justified? (Default: NO)
- Can this be built with existing code? (Prefer YES)
- Is the solution the simplest possible? (Apply Occam's Razor)
- Are there any "resume-driven" tech choices? (GraphQL for 3 endpoints?)
- Use
write_to_fileto save audit report. DO NOT just print verdict.
✅ Completion Checklist
- Audit file created:
genesis/v{N}/AUDIT_REPORT.md - Complexity score assigned (1-10)
- Clear APPROVE or REJECT verdict with reasoning
- Alternative simpler solutions suggested (if REJECT)
- User confirmed the verdict
🛠️ The Techniques
1. Occam's Razor (剃刀)
- Scenario: "I added GraphQL because it's flexible."
- Verdict: "REJECT. We have 3 endpoints. Use REST."
- Rule: Simplest solution that works wins.
2. YAGNI (拒绝预测)
- Scenario: "I made it generic for future cases."
- Gatekeeper: 只有你点了
APPROVED,流程才能进入 Implementation 阶段。你是最后一道防线。 - Verdict: "REJECT. Implement it for the current case only."
- Rule: Solve today's problem.
🧰 The Toolkit
references/anti_patterns.md: The "Blacklist" of bad designs.
3. The Dependency Diet (依赖节食)
- Scenario: "Added
lodashforisNil." - Verdict: "REJECT. Use
=== null || === undefined." - Rule: Every dependency is liability.
⚠️ Gatekeeper's Code
- Be Ruthless: Politeness causes technical debt. Kill complexity now.
- Suggest Alternatives: Don't just block. Say "Use X instead of Y".
- Protect the Team: Boring tech stacks let developers sleep at night.
Weekly Installs
2
Repository
haaaiawd/antigr…w-systemGitHub Stars
121
First Seen
Jan 29, 2026
Security Audits
Installed on
cursor2
kiro-cli2
codex2
claude-code2
antigravity2
gemini-cli2