Menu
AI 辅助开发中遇到“代码改不好”时的诊断思路与决策树
Install with Codex or Claude Copy this prompt, paste it into Codex, Claude, or another assistant, and let it review the skill page and install it for you.
Based on SOC occupation classification
LLM Wiki vault 操作手册。 触发条件： - /ingest <path> — 当用户说「ingest」「把这篇文章加入 wiki」「编译到 wiki」「摄取」时触发 - /query <question> — 当用户说「搜索 wiki」「wiki 中有没有」「查一下 wiki」时触发 - /lint — 当用户说「检查 wiki」「wiki 健康度」「lint」「有没有断链」时触发 - /research <topic> — 当用户说「研究一下」「深度调研」「research」时触发
Use when the user wants to brainstorm an idea or design a feature/spec. Explores intent and requirements through dialogue, then writes a spec document to contexts/thought_review/ and STOPS. Does not auto-chain to implementation planning or any other skill.
结构稳定性分析器。不判断观点对错，只判断一件事：这个结构能不能活下去。 对任意观点、系统、模型、制度、人物言论进行五维结构稳定性分析， 输出存活概率和失效路径。当用户说「分析这个结构」「这个观点稳不稳」 「帮我拆一下」「结构分析」时触发。
AI 产品设计、交互设计与系统架构中的关键原则与常见陷阱
AI 辅助编程与 Agent 系统设计的核心方法论和判断原则
文档分析、调研任务、复杂信息整合
| name | bestpractice-ai-debugging-diagnosis |
| description | AI 辅助开发中遇到“代码改不好”时的诊断思路与决策树 |
绝大多数"AI 改不好代码"的情况，根因是人类用户问题，而非系统架构问题。
常见误解：
AI 改不好代码
│
├─→ 是否给了足够的上下文？
│ │
│ └─→ 否 → 补充上下文（相关文件、错误日志、预期行为）
│ │
│ └─→ 是 → 继续
│
├─→ 是否定义了清晰的成功标准？
│ │
│ └─→ 否 → 明确"什么是好"（不只是"能跑"）
│ │
│ └─→ 是 → 继续
│
├─→ 是否提供了反馈通道？
│ │
│ └─→ 否 → 让 AI 能看到结果（测试输出、截图、日志）
│ │
│ └─→ 是 → 继续
│
└─→ 可能是真正的架构问题
│
└─→ 考虑局部重构或拆分问题
症状：
解决：
症状：
解决：
症状：
解决：
真正需要重构的信号：
即使如此，也先尝试：
bestpractice-ai-programming-mindset 的"70% 问题"诊断bestpractice-staged-approach 的验证机制| 日期 | 变更 |
|---|---|
| 2026-02-21 | 初始版本，来自 2026-01-19 观察记录 |