القائمة
AI 辅助开发中遇到“代码改不好”时的诊断思路与决策树
التثبيت باستخدام Codex أو Claude انسخ هذا Prompt والصقه في Codex أو Claude أو مساعد آخر ليراجع صفحة Skill ويثبّتها لك.
استنادا إلى تصنيف SOC المهني
| name | bestpractice-ai-debugging-diagnosis |
| description | AI 辅助开发中遇到“代码改不好”时的诊断思路与决策树 |
绝大多数"AI 改不好代码"的情况，根因是人类用户问题，而非系统架构问题。
常见误解：
AI 改不好代码
│
├─→ 是否给了足够的上下文？
│ │
│ └─→ 否 → 补充上下文（相关文件、错误日志、预期行为）
│ │
│ └─→ 是 → 继续
│
├─→ 是否定义了清晰的成功标准？
│ │
│ └─→ 否 → 明确"什么是好"（不只是"能跑"）
│ │
│ └─→ 是 → 继续
│
├─→ 是否提供了反馈通道？
│ │
│ └─→ 否 → 让 AI 能看到结果（测试输出、截图、日志）
│ │
│ └─→ 是 → 继续
│
└─→ 可能是真正的架构问题
│
└─→ 考虑局部重构或拆分问题
症状：
解决：
症状：
解决：
症状：
解决：
真正需要重构的信号：
即使如此，也先尝试：
bestpractice-ai-programming-mindset 的"70% 问题"诊断bestpractice-staged-approach 的验证机制| 日期 | 变更 |
|---|---|
| 2026-02-21 | 初始版本，来自 2026-01-19 观察记录 |
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 系统设计的核心方法论和判断原则
文档分析、调研任务、复杂信息整合