用途
aif-architecture 用于为项目生成架构指南文档。它根据项目上下文推荐架构模式，并生成对应的架构决策文档（默认写入 .ai-factory/ARCHITECTURE.md）。
主要能力
- 读取配置与项目上下文：读取 .ai-factory/config.yaml（若存在）以解析 description 与 architecture 的路径，以及 UI 语言和产物语言；若不存在则使用默认值（DESCRIPTION.md 为 .ai-factory/DESCRIPTION.md，ARCHITECTURE.md 为 .ai-factory/ARCHITECTURE.md，语言为 en）。
- 读取项目描述：从 DESCRIPTION.md 了解技术栈（语言、框架、数据库、ORM）、项目规模与复杂度、核心功能与需求、非功能需求。
- 读取项目级技能上下文：若存在 .ai-factory/skill-context/aif-architecture/SKILL.md，其中的项目专属规则视为对本技能通用指令的项目级覆盖；与通用规则冲突时以 skill-context 规则优先，无冲突时两者同时应用。所有输出（含 ARCHITECTURE.md 模板）都必须遵守这些规则。
- 推荐架构：基于决策矩阵评估团队规模、领域复杂度、规模要求与技术栈，给出推荐并通过 AskUserQuestion 呈现。可选架构模式包括：Structured Modules（Technical Layer）、Structured Modules（Vertical Slices By Entity）、Explicit Architecture（Technical Layer）、Explicit Architecture（Vertical Slice By Entity）、Explicit Architecture（Flat Vertical Slice - Simplified）、Microservices、Layered Architecture。
- 支持显式指定架构：如 /aif-architecture explicit。映射规则包括 layers→Layered Architecture、microservices→Microservices、structured→Structured Modules（需询问变体）、explicit→Explicit Architecture（需询问变体）；旧别名 clean、ddd→Explicit Architecture，monolith→Structured Modules，vertical→Explicit Architecture（Vertical Slice By Entity）；带后缀（structured-layers、structured-vertical、explicit-layers、explicit-vertical、explicit-flat）时变体已确定，无需询问。
- 生成架构产物：在解析出的架构路径创建文档，结构包含 Overview、Decision Rationale、Folder Structure、Dependency Rules、Layer/Module Communication、Key Principles、Code Examples、Anti-Patterns，并根据项目语言与框架调整示例与约定。
- 代码库对齐检查（Step 1.5）：将所选架构的理想目录结构与现有代码结构比较；若差异显著，须停止并询问用户：一是按现有结构适配（记录现实），二是生成纯严格架构指南（需后续重构）。不得在未获用户同意的情况下自动合并两者。
- 更新 DESCRIPTION.md：若存在，则按解析出的 artifacts 语言添加或更新架构指针段落（含架构路径与所选模式）。
- 更新 AGENTS.md：若项目根目录存在 AGENTS.md，则按解析出的 artifacts 语言在本地化的 “AI Context Files” 表中添加架构产物路径条目（仅当尚未存在时添加）。
- 确认输出：按解析出的 ui 语言报告所选模式、架构文件路径与关键规则。
使用方式
- 可通过 /aif-architecture 调用；当由 /aif 调用时，假定 .ai-factory/config.yaml 已写入当前设置运行所需的 language.ui / language.artifacts 值。
- 若 .ai-factory/DESCRIPTION.md 不存在，会提示先运行 /aif 设置项目上下文，或手动描述项目（要构建什么、技术栈、团队规模、预期规模）；允许独立使用，用户手动输入即采用该输入。
- 指定架构模式时可带后缀明确变体，或不带后缀由技能询问用户选择变体。
- 生成后按 skill-context 规则校验输出，若违反则在呈现给用户前修正。
适用场景
- 需要为已有或新建项目输出架构决策文档、并希望文档与项目技术栈匹配时。
- 需要在多个架构模式之间获得推荐或按指定模式生成规范时。
- 需要将架构指针同步到项目描述文件与 AI 上下文清单时。
限制与边界
- 主要所有权：解析出的架构产物路径（默认 .ai-factory/ARCHITECTURE.md）；尊重 config.yaml 的路径覆盖。
- 允许的伴生更新：config.yaml 中解析出的 DESCRIPTION 路径的架构指针、AGENTS.md 上下文表中的架构行。
- 只读上下文：roadmap、rules、research 与 plan 产物，除非用户明确另行要求。
- 缺少 DESCRIPTION.md 时需要用户提供信息或先运行 /aif。
- 关于收费、价格、平台、具体效果等资料未提供，暂未提供。
产品信息
- 名称：aif-architecture
- 来源：lee-to/ai-factory
- URL：https://www.skills.sh/lee-to/ai-factory/aif-architecture