Before calling any skill in this module: if you are about to call a skill with parameters guessed from its name or description, STOP — read this file (or fetch its schema via GET /skills/recommend?includeSchema=true) first. If you already have the parameter definitions from recommend/schema, you may proceed straight to dryRun.

Triggers

• Writing or reviewing QFramework architecture code (Controller/System/Model/Utility)
• Registering Systems/Models/Utilities, sending Commands/Queries/Events
• Binding BindableProperty / BindableList / BindableDictionary in views
• Choosing between the core IOCContainer and the Toolkits IOCKit, or between architecture events and EasyEvent
• 编写或审查 QFramework 架构代码、四层职责划分、Command/Query/Event/BindableProperty 使用、核心容器与 Toolkits 容器选型

QFramework - Design Rules（v1.0.257）

Advisory 模块。全部规则提炼自 QFramework 官方源码与教程：

• QFramework.cs（核心架构单文件源码，仓库根目录 QFramework.cs，内部注释标注 Latest Update: 2026.8.12 return module instance after register）
• Doc.md（官方教程全文，8820 行，仓库根目录 Doc.md）
• QFramework API.md（核心层签名索引；Toolkits 无覆盖，且截至本次抓取仍未同步 2026-08-12 的返回值变更）

每条规则都标注具体文件/行号（行号对应上游 liangxiegame/QFramework 主仓库 v1.0.257 快照；Toolkits 源码位于 QFramework.Unity2018+/Assets/QFramework/），遇到分歧以 QFramework.cs 源码为准，Doc.md/API.md 仅供交叉印证——教程本身可能滞后于源码。正文中文，API 名/代码保持英文。

Mode: Documentation only — no REST skills to gate; load freely under any operating mode (Approval / Auto / Bypass).