菜单
Python COLA 架构指南 - 将阿里巴巴 COLA 整洁分层架构适配到 Python/Flask/FastAPI 项目。用于 Python 后端的 DDD 分层架构设计、代码结构规范、应用架构重构。触发条件：Python DDD、Flask 架构、FastAPI 架构、Python 分层架构、整洁架构、六边形架构、洋葱圈架构、COLA、代码分层、模块划分、Gateway 模式、Repository 模式、CQRS、架构重构、职责分离。创建 Python 文件时自动应用 COLA 目录结构和命名规范。
用 Codex 或 Claude 帮你安装 复制这段 Prompt，粘贴到 Codex、Claude 或其他助手里，让它检查 Skill 页面并帮你完成安装。
基于 SOC 职业分类
Fetch, categorize, and summarize GitHub Trending projects across daily, weekly, and monthly spans. Use when a user asks for "trending projects", "latest hot repos", or a "summary of GitHub trends" to provide a structured, categorised report with full hyperlinking. Supports Markdown, HTML (Pinterest design), or both output formats, with optional Obsidian vault storage.
Turn a local folder or GitHub repository into an interactive browser-based course that explains how the codebase works for non-expert programmers and AI-assisted builders. Use when a user asks to make a course, tutorial, walkthrough, learning guide, codebase explanation, or interactive lesson from a project.
Converts a PRD or broad technical requirement into an AI-executable agile workflow with cards, checklists, branch-diff mapping, review gates, and a final comparison report. Use when the user wants PRD review, agile card decomposition, AI execution tracking, implementation branch review, or PRD-to-code traceability.
Two complementary Bezos heuristics in one skill. (A) Two-Way Door — classify decisions by reversibility; reversible = decide fast with 70% info, irreversible = decide slow with 90% info. (B) Regret Minimization — for life-defining choices, project to age 80 and pick what minimizes regret. Use Two-Way Door triggers on Chinese 决策瘫痪 / 反复纠结小事 / 开了三次会还没定 / 大事小事一样慢; Regret Min triggers on 离职 / 创业 / 移民 / 结婚 / 生育 / 转行 / 重大决定 / 这辈子. Especially when team applies identical heavy process to all decisions (need Two-Way), or when user faces once-in-a-decade pivot where rational analysis ties (need Regret Min). Do NOT misclassify One-Way as Two-Way (most expensive mistake), use Regret Min for daily decisions (age-80 view on "what to eat" is meaningless), or run Regret Min in heated emotion (cool 24-48h first to avoid romanticizing risk).
Use BEFORE selecting any other decision framework — Cynefin (kuh-NEV-in) classifies WHICH framework fits the current situation across 5 domains (Clear / Complicated / Complex / Chaotic / Confused). Triggers when user is about to apply a method and the fit feels off, asks meta-questions like "should we follow SOP or explore?", or when same approach that worked last time seems wrong now. Also use after failure when "the method was right but the situation didn't match", or when team argues over deterministic-plan-vs-experimentation. Especially valuable at the start of major decisions to avoid using the wrong hammer for the nail. Do NOT use for trivial classified decisions (don't run Cynefin for "what to eat for lunch"), true Chaotic situations needing immediate stabilizing action (act first, classify later), or teams unfamiliar with the model (use simpler known/unknown binary).
Use when user reports overwhelm from too many tasks, asks for week/sprint/OKR planning help, or describes spending 'all day firefighting' while long-term projects stall. Triggers on Chinese phrases 太多事 / 不知道先做哪个 / 排不过来 / 周计划 / sprint planning / 救火 / 优先级 / overwhelm / 焦虑 / 做不完 / todo 列表炸了, and explicit task triage requests. Especially valuable when waiting list has 15+ pending items, or when user says "重要的事一直推不动 / 都在做紧急的事". Do NOT use for small lists (<5 items just sort by deadline), team-level responsibility assignment (use RAPID/DACI from backlog), or when importance needs quantitative weighting (use weighted decision matrix).
| name | python-cola-skill |
| description | Python COLA 架构指南 - 将阿里巴巴 COLA 整洁分层架构适配到 Python/Flask/FastAPI 项目。用于 Python 后端的 DDD 分层架构设计、代码结构规范、应用架构重构。触发条件：Python DDD、Flask 架构、FastAPI 架构、Python 分层架构、整洁架构、六边形架构、洋葱圈架构、COLA、代码分层、模块划分、Gateway 模式、Repository 模式、CQRS、架构重构、职责分离。创建 Python 文件时自动应用 COLA 目录结构和命名规范。 |
COLA = Clean Object-Oriented and Layered Architecture（整洁面向对象分层架构）
Adapter → Application → Domain ← Infrastructure
↘ ↙
Client
| 层 | 职责 | Python 实现 |
|---|---|---|
| Adapter | 接收外部请求 | Flask Blueprint / FastAPI Router |
| Application | 用例编排 | Service, CmdExe, QryExe |
| Domain | 核心业务逻辑 | Entity, ValueObject, Gateway 接口 |
| Infrastructure | 技术实现 | Gateway 实现, SQLAlchemy |
| Client | DTO 定义 | Command, Query, CO |
project/
├── adapter/routes/ # Flask Blueprint
├── application/
│ ├── command/ # *_cmd_exe.py
│ ├── query/ # *_qry_exe.py
│ └── service/ # *_service.py
├── client/
│ ├── api/ # *_service_i.py (Protocol)
│ └── dto/
│ ├── command/ # *_cmd.py
│ ├── query/ # *_qry.py
│ └── co/ # *_co.py
├── domain/
│ ├── {aggregate}/ # entity.py, value_object.py
│ └── gateway/ # *_gateway.py (ABC)
├── infrastructure/
│ ├── gateway_impl/ # *_gateway_impl.py
│ ├── convertor/ # *_convertor.py
│ └── repository/ # models.py
└── app.py
| 类型 | 后缀 | 位置 |
|---|---|---|
| 命令 | _cmd | client/dto/command |
| 查询 | _qry | client/dto/query |
| 命令执行器 | _cmd_exe | application/command |
| 查询执行器 | _qry_exe | application/query |
| 客户端对象 | _co | client/dto/co |
| 服务接口 | _service_i | client/api |
| 服务实现 | _service | application/service |
| 网关接口 | _gateway | domain/gateway |
| 网关实现 | _gateway_impl | infrastructure/gateway_impl |
| 转换器 | _convertor | infrastructure/convertor |
详细代码示例请参考：
| Java | Python |
|---|---|
interface | Protocol 或 ABC |
@Autowired | 构造函数注入 |
@CatchAndLog | @catch_and_log 装饰器 |
@Data | @dataclass |
@RestController | Flask Blueprint |