用途:当项目选用 custom-architecture 能力,或用户要求分析仓库架构并记录到 FRAMEWORK.local.md 时使用该技能。目标是发现仓库中实际存在的架构,并为后续智能体留下简洁、可操作的指引。
主要能力:读取 FRAMEWORK.md 与已存在的 FRAMEWORK.local.md;在编辑前检查仓库结构,包括包清单与工作区文件、源码目录与功能/模块边界、应用入口、路由、API、UI、持久化、后台任务与测试、文件夹之间的导入/依赖方向,以及揭示框架、构建系统或运行边界的配置文件。只总结有仓库文件支持的发现,不强行套用 DDD、六边形、整洁或分层架构术语。
使用方式:在 FRAMEWORK.local.md 中写入或替换受管段落,标记为 aircury-custom-architecture:start 与 aircury-custom-architecture:end。受管块内需包含:Architecture Summary(观察到的架构简述)、Directory Responsibilities(以路径列出职责)、Dependency And Boundary Rules(后续智能体需遵守的规则)、Implementation Conventions(命名、文件位置、测试、框架或集成约定)、Risks And Open Questions(风险与未决问题,无则写 None discovered.)。保留标记之外的内容原样不动;若已有未标记的人工撰写的 ## Project Architecture 段落,则保留并在其下追加受管块。
限制:要描述而非期望,记录项目实际做法;不确定处明确标注而非猜测;不要编辑生成的 FRAMEWORK.md,不要重写无关的 FRAMEWORK.local.md 内容。