# Bad Smell

> 你觉得代码写得好吗？当你觉得代码难于理解、设计混乱或不易维护时主动使用本技能。

- Skill: `john-walks-slow/bad-smell` (Agent Skill)
- Install (CLI): `npx skillmds@latest add john-walks-slow/bad-smell`
- Raw SKILL.md: https://api.skillmd.com/api/skills/john-walks-slow/bad-smell/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: john-walks-slow (https://skillmd.com/u/john-walks-slow)
- Updated: 2026-09-22
- Page: https://skillmd.com/skills/john-walks-slow/bad-smell

---


# bad-smell

当你觉得代码有坏味道的时候，意味着代码可能需要重构。

项目当前处于早期开发阶段。**架构债务越早处理越好。**

若你能“嗅到”明显更优的设计，且范围可控无风险，请立刻随手优化。

如果重构范围较大、风险较高或需要进一步规划，请在 `{project_root}/docs/freeform/yymmdd-{summary}.smell.md` 简单记录你发现的坏味道，然后回到原有任务。