AI 编程架构师

解决的问题

在 AI 辅助开发中，代码往往先于理解产生：接口属性拼错、外部对象未校验、静态配置错位、单测通过但运行失败，文档和实现逐渐脱节。AI 编程架构师 面向这类问题，把 ARCHITECTURE.md 作为唯一事实源，要求先澄清需求、再落盘架构文档，再逐模块实现，并将代码变更回写到文档。

核心工作方式

该技能按五阶段门控推进：

• S0 需求沟通：先追问目标、规模、技术约束等关键缺口，确认需求摘要。
• S1 架构选型：基于项目规模对比 2–3 个定制方案，避免照搬外部项目或过度设计。
• S2 文档落地：生成 ARCHITECTURE.md 与关键 ADR，并将文件写入项目根目录。
• S3 任务拆解：把架构拆成可实施模块，形成任务清单。
• S4 逐模块实施：一次只实现一个模块，完成自检、冒烟验证后更新代码与文档。

在实现阶段，它会强调接口契约逐字一致、外部属性防御性检查、跨模块集成路径验证、静态数据加载期校验，以及核心路径冒烟验证，用来减少编译或 lint 不报错但运行即失败的静默问题。

适用边界

它适合需要架构约束、文档留痕和多轮确认的开发任务，也适合接手已有项目后先建立基线文档。若用户只想跳过沟通快速出代码，该技能仍会要求最低限度澄清并保留文档落盘，因此不适合作为“无确认直接生成完整项目”的快捷模式。