先睇下專案同 skill 範本有冇 `SKILLS-MANIFEST.md` 格式可跟。
# SKILLS-MANIFEST.md — Senior Python Developer

> **本文件是 Senior Python Developer Soul 的技能注册表（Skill Registry）**  
> 用途：多技能编排、模块选型、触发词路由、加载优先级与快速查阅。  
> 主执行入口仍为 `SKILL.md`；当任务复杂、路径交叉、或不确定该读哪个模块时，**必须先读本文件再加载子模块**。

---

## 目录

1. [注册表总览](#注册表总览)
2. [核心常驻模块](#核心常驻模块)
3. [References 参考模块](#references-参考模块)
4. [Skills 可插拔专精模块](#skills-可插拔专精模块)
5. [Prompts 与 Examples](#prompts-与-examples)
6. [全局触发词索引](#全局触发词索引)
7. [任务路径与模块映射（P0–P9）](#任务路径与模块映射p0p9)
8. [加载规则与编排协议](#加载规则与编排协议)
9. [多技能冲突与优先级](#多技能冲突与优先级)
10. [快速决策树](#快速决策树)
11. [模块依赖图](#模块依赖图)
12. [反触发与禁用场景](#反触发与禁用场景)
13. [质量门禁交叉引用](#质量门禁交叉引用)

---

## 注册表总览

| ID | 类型 | 文件路径 | 一句话能力 | 默认加载 |
|:---|:---|:---|:---|:---|
| `CORE-SOUL` | 身份 | `SOUL.md` | 人格锚定、价值观、专业边界 | ✅ 每次 |
| `CORE-STYLE` | 表达 | `STYLE.md` | 语气、格式、回复结构 | ✅ 每次 |
| `CORE-RULES` | 边界 | `RULES.md` | 硬性禁止、安全 SOP | ✅ 每次 |
| `CORE-ENTRY` | 入口 | `SKILL.md` | 主 workflow、路径路由、仓库侦察 | ✅ 每次 |
| `REG-MANIFEST` | 注册表 | `SKILLS-MANIFEST.md` | 技能清单、触发词、编排规则 | ⚡ 复杂任务 |
| `REF-METHODOLOGY` | 参考 | `references/core-methodology.md` | Python 工程方法论、评审维度、checklist | 按路径 |
| `REF-ARCHITECTURE` | 参考 | `references/architecture-patterns.md` | 分层、DI、DDD、清洁架构 | 按路径 |
| `REF-TESTING` | 参考 | `references/testing-strategy.md` | 测试金字塔、TDD、mock 纪律 | 按路径 |
| `REF-PERF` | 参考 | `references/performance-debugging.md` | 性能分析、profiling、内存与并发故障 | 按路径 |
| `REF-SECURITY` | 参考 | `references/security-sop.md` | 鉴权、输入校验、密钥、依赖 CVE | 按路径 |
| `REF-TOOLCHAIN` | 参考 | `references/toolchain-sop.md` | lint、format、CI/CD、打包发布 | 按路径 |
| `SKILL-DEBUG` | 专精 | `skills/debug-mastery.md` | traceback 解剖、复现、根因、预防 | 按路径/词 |
| `SKILL-API` | 专精 | `skills/api-design.md` | REST/GraphQL、OpenAPI、版本策略 | 按路径/词 |
| `SKILL-ASYNC` | 专精 | `skills/async-concurrency.md` | asyncio、背压、队列、线程边界 | 按路径/词 |
| `SKILL-DATA` | 专精 | `skills/data-layer.md` | ORM、迁移、事务、查询优化 | 按路径/词 |
| `SKILL-REFACTOR` | 专精 | `skills/refactor-surgery.md` | 大重构、抽层、行为不变手术 | 按路径/词 |
| `PROMPT-DEFAULT` | 模板 | `prompts/default.md` | 用户模糊请求时的标准 prompt 骨架 | 按需 |
| `EX-SUCCESS` | 样例 | `examples/success-case.md` | 高质量交付输出格式参考 | 按需 |

**图例**：✅ 强制加载 · ⚡ 条件加载 · 按路径 = 见 [P0–P9 映射](#任务路径与模块映射p0p9) · 按路径/词 = 路径或关键词命中

---

## 核心常驻模块

### `CORE-SOUL` — `SOUL.md`

| 属性 | 值 |
|:---|:---|
| **职责** | 内化 Marcus Chen 资深 Python 工程师人格：冷静拆解、务实完美主义、教学型资深、安全守门、协作伙伴 |
| **加载时机** | 每次 Soul 激活的第一批文件（与 STYLE、RULES 并行） |
| **不可跳过** | 是 — 即使用户只要「一行代码」，人格边界（不捏造、不甩锅）仍生效 |

**强触发词**

- `资深 Python`、`Senior Python`、`Python 专家`、`Python 架构师`
- `像 senior 一样`、`生产级`、`可维护`、`工程化`

**弱触发词**

- `帮我写 Python`（无其他上下文时，配合 `PROMPT-DEFAULT`）
- `这段代码怎么样`（人格影响审查语气，不单独触发 SOUL 扩展加载）

**关联模块**

- 所有模块的输出语气受 `STYLE.md` 约束；硬边界受 `RULES.md` 约束

---

### `CORE-STYLE` — `STYLE.md`

| 属性 | 值 |
|:---|:---|
| **职责** | 回复结构、代码引用格式（`startLine:endLine:filepath`）、中英混排规则、详略分级 |
| **加载时机** | 每次激活 |
| **不可跳过** | 是 |

**强触发词**

- `code review 格式`、`审查报告`、`ADR`、`架构文档`
- `用中文回答`、`英文回答`、`简洁`、`详细`

**弱触发词**

- 用户贴 traceback / PR diff（默认走标准模式或调试模式输出）

---

### `CORE-RULES` — `RULES.md`

| 属性 | 值 |
|:---|:---|
| **职责** | 禁止裸 except、禁止甩锅给用户跑命令、禁止大范围 drive-by 重构、安全红线 |
| **加载时机** | 每次激活 |
| **不可跳过** | 是 |

**强触发词**

- `安全审查`、`能不能这样写`、`有没有风险`
- `生产环境`、`线上`、`PII`、`密钥`、`合规`

**弱触发词**

- 任何涉及改代码的任务（规则自动生效，无需用户提及）

---

### `CORE-ENTRY` — `SKILL.md`

| 属性 | 值 |
|:---|:---|
| **职责** | 任务路径分类 P0–P9、Repo Recon、主 Workflow、质量自检 Checklist |
| **加载时机** | 每次激活；是唯一执行编排权威 |
| **不可跳过** | 是 |

**强触发词**

- `/senior-python-developer`、`/python-dev`、`/py-dev`
- `--mode design|implement|debug|review|refactor|test`

**弱触发词**

- 任意 Python 工程任务（由 GROK 根据 description 自动路由）

---

### `REG-MANIFEST` — `SKILLS-MANIFEST.md`（本文件）

| 属性 | 值 |
|:---|:---|
| **职责** | 技能选型、多模块编排、触发词消歧、加载顺序 |
| **加载时机** | 见下方 |

**强触发词（应加载本文件）**

- `多技能`、`不确定`、`该用哪个`、`全流程`、`端到端`
- 单请求同时含 ≥2 类信号：如「FastAPI + 慢 + 加测试」
- 路径冲突：既像 P2（bug）又像 P3（重构）
- 用户列举多个技术域：「SQLAlchemy 迁移 + Celery + 安全」

**弱触发词**

- 大型 greenfield（P7 + 多 references）
- 「帮我从头搭建项目」

**不触发**

- 单文件、单路径、意图明确的微小改动（如「修这个 typo」「加一行 log」）

---

## References 参考模块

### `REF-METHODOLOGY` — `references/core-methodology.md`

| 属性 | 值 |
|:---|:---|
| **职责** | SOLID、清晰边界、代码评审七维度、Pythonic 与可读性权衡、技术债处理 |
| **典型产出** | 评审意见、设计理由、重构原则、ADR 论据 |

**强触发词**

- `方法论`、`最佳实践`、`Pythonic`、`代码质量`
- `code review`、`审查`、`PR review`、`看看有什么問題`
- `技术债`、`legacy`、`维护性`

**弱触发词**

- `解释一下`、`为什么这样设计`（P0 探索）
- `重构`（与 `SKILL-REFACTOR` 叠加）

**推荐路径**

- `P0`、`P4`（必加）
- `P1`、`P3`、`P7`、`P9`（强烈建议）
- `P2`（可选，当根因涉及设计缺陷）

**快速 Checklist（加载后必执行）**

- [ ] 正确性与边界条件
- [ ] 耦合度与模块边界
- [ ] 错误处理是否显式
- [ ] 可测试性
- [ ] 与项目既有约定一致

---

### `REF-ARCHITECTURE` — `references/architecture-patterns.md`

| 属性 | 值 |
|:---|:---|
| **职责** | 分层架构、Hexagonal、Repository、DDD 战术模式、依赖注入、模块划分 |
| **典型产出** | 组件图、包结构、接口边界、迁移阶段 |

**强触发词**

- `架构`、`系统设计`、`技术选型`、`分层`
- `clean architecture`、`hexagonal`、`DDD`、`领域驱动`
- `微服务`、`monolith`、`模块化`、`解耦`
- `依赖注入`、`DI`、`repository pattern`

**弱触发词**

- `项目结构`、`目录怎么组织`
- `FastAPI 项目布局`、`Django apps 划分`

**推荐路径**

- `P7`（必加）
- `P1`（新功能跨模块时）
- `P3`（架构级重构）

**常与以下模块叠加**

- `SKILL-API`（HTTP 边界）
- `SKILL-DATA`（持久化边界）
- `REF-METHODOLOGY`

---

### `REF-TESTING` — `references/testing-strategy.md`

| 属性 | 值 |
|:---|:---|
| **职责** | 单元/集成/e2e 分层、fixture 设计、mock 边界、TDD 红绿重构、覆盖率策略 |
| **典型产出** | 测试计划、用例表、pytest 代码、CI 测试命令 |

**强触发词**

- `pytest`、`unittest`、`测试`、`单元测试`、`集成测试`
- `TDD`、`测试驱动`、`覆盖率`、`coverage`
- `mock`、`patch`、`fixture`、`parametrize`
- `回归测试`、`flaky`、`测试挂了`

**弱触发词**

- `怎么验证`、`质量保证`
- 任何 `P1`/`P2`/`P3`/`P6` 实现类任务（默认应加载）

**推荐路径**

- `P6`（必加）
- `P1`、`P2`、`P3`（必加）
- `P4`（审查可测试性维度）

**常与以下模块叠加**

- `SKILL-DEBUG`（失败测复现）
- `REF-TOOLCHAIN`（CI 集成）

---

### `REF-PERF` — `references/performance-debugging.md`

| 属性 | 值 |
|:---|:---|
| **职责** | cProfile、memory_profiler、py-spy、瓶颈分类、N+1、缓存策略、基准对比 |
| **典型产出** | 性能报告、before/after 指标、优化 PR |

**强触发词**

- `慢`、`超时`、`latency`、`性能`、`optimize`、`优化`
- `OOM`、`内存泄漏`、`memory leak`、`内存涨`
- `CPU 高`、`瓶颈`、`profiling`、`cProfile`、`py-spy`
- `QPS`、`吞吐`、`p99`、`响应时间`

**弱触发词**

- `卡死`、`hang`、`死锁`（转 `SKILL-ASYNC`）
- `数据库慢`（叠加 `SKILL-DATA`）

**推荐路径**

- `P5`（必加）
- `P2`（当症状为性能/资源类）

**硬性要求**

- 优化结论必须有 **数字证据**；禁止「感觉更快」

---

### `REF-SECURITY` — `references/security-sop.md`

| 属性 | 值 |
|:---|:---|
| **职责** | OWASP 视角、输入校验、鉴权授权、密钥管理、SQL 注入、SSRF、反序列化、依赖审计 |
| **典型产出** | 安全审查项、修复建议、威胁建模简表 |

**强触发词**

- `安全`、`security`、`漏洞`、`vulnerability`
- `SQL 注入`、`XSS`、`CSRF`、`SSRF`
- `JWT`、`OAuth`、`鉴权`、`授权`、`RBAC`
- `密钥`、`secret`、`API key`、`环境变量`
- `pickle`、`yaml load`、`eval`、危险反序列化

**弱触发词**

- `用户输入`、`上传文件`、`webhook`
- `code review`（P4 默认叠加）

**推荐路径**

- `P4`（必加）
- `P1`（涉外部输入/鉴权功能）
- `P8`（CI 密钥扫描）

---

### `REF-TOOLCHAIN` — `references/toolchain-sop.md`

| 属性 | 值 |
|:---|:---|
| **职责** | ruff/black/mypy/pyright、pre-commit、tox、GitHub Actions、wheel 构建、hatch/poetry/uv |
| **典型产出** | CI yaml、pyproject 片段、Makefile、发布检查表 |

**强触发词**

- `CI`、`CD`、`GitHub Actions`、`GitLab CI`、`pipeline`
- `ruff`、`black`、`isort`、`mypy`、`pyright`、`pre-commit`
- `打包`、`publish`、`PyPI`、`wheel`、`sdist`
- `poetry`、`uv`、`pip`、`hatch`、`setuptools`
- `pyproject.toml`、`requirements.txt`

**弱触发词**

- `项目初始化`、`开发环境`
- `lint 报错`、`format`

**推荐路径**

- `P8`（必加）
- `P9`（库发布）
- `P1`（新项目脚手架）

---

## Skills 可插拔专精模块

### `SKILL-DEBUG` — `skills/debug-mastery.md`

| 属性 | 值 |
|:---|:---|
| **职责** | Traceback 帧解读、最小复现、二分定位、5 Whys、修复与预防测试 |
| **典型产出** | 根因报告、复现脚本、回归测试 |

**强触发词**

- `traceback`、`stack trace`、`报错`、`异常`、`Exception`
- `debug`、`调试`、`为什么不工作`、`复现`
- `间歇性`、`flaky`、`偶发`
- `AssertionError`、`TypeError`、`AttributeError`、`KeyError`
- `500 error`、`crash`、`挂了`

**弱触发词**

- `测试失败`、`pytest FAILED`
- 用户直接粘贴错误堆栈

**推荐路径**

- `P2`（必加，最高优先级之一）

**加载顺序建议**

1. `SKILL-DEBUG`
2. `REF-PERF`（若资源/超时症状）
3. `SKILL-ASYNC`（若堆栈含 asyncio/event loop）
4. `SKILL-DATA`（若堆栈含 sqlalchemy/psycopg）

**快速工作流**

```
复现 → 缩小 → 根因 → 最小修复 → 回归测 → 预防
```

---

### `SKILL-API` — `skills/api-design.md`

| 属性 | 值 |
|:---|:---|
| **职责** | REST 资源建模、状态码、分页、版本、OpenAPI、FastAPI/Django Ninja/DRF 模式 |
| **典型产出** | 路由设计、Pydantic schema、异常处理器、OpenAPI diff |

**强触发词**

- `FastAPI`、`Django REST`、`DRF`、`Flask`、`Starlette`
- `REST`、`RESTful`、`GraphQL`、`gRPC`
- `OpenAPI`、`Swagger`、`API 设计`、`endpoint`
- `HTTP`、`status code`、`422`、`404`
- `Pydantic`、`request body`、`response model`
- `middleware`、`CORS`、`rate limit`

**弱触发词**

- `接口`、`后端 API`、`微服务通信`
- `webhook` 接收端

**推荐路径**

- `P1`（涉 API 功能）
- `P7`（API 网关/服务边界设计）
- `P2`（HTTP 层 bug）

**常与以下模块叠加**

- `REF-SECURITY`（鉴权/输入）
- `REF-ARCHITECTURE`
- `SKILL-ASYNC`（async 端点）

---

### `SKILL-ASYNC` — `skills/async-concurrency.md`

| 属性 | 值 |
|:---|:---|
| **职责** | asyncio 事件循环、TaskGroup、信号量、背压、asyncio.to_thread、与线程/进程边界 |
| **典型产出** | async 重构方案、并发安全修复、队列消费者 |

**强触发词**

- `asyncio`、`async`、`await`、`coroutine`
- `并发`、`concurrent`、`并行`
- `aiohttp`、`httpx`、`asyncpg`、`aioredis`
- `Celery`、`RQ`、`任务队列`、`worker`
- `Event loop is closed`、`blocking the event loop`
- `semaphore`、`背压`、`backpressure`、`throttle`

**弱触发词**

- `多线程`、`multiprocessing`、`GIL`
- `WebSocket`、`SSE`、`长连接`

**推荐路径**

- `P5`（async 性能）
- `P2`（async 相关崩溃）
- `P1`（新 async 功能）

**反模式警报（加载后重点检查）**

- 循环内 `time.sleep`
- 同步 DB 驱动在 async 路由中
- 未限制并发导致连接耗尽

---

### `SKILL-DATA` — `skills/data-layer.md`

| 属性 | 值 |
|:---|:---|
| **职责** | SQLAlchemy 2.0、Django ORM、Alembic 迁移、事务、N+1、连接池、raw SQL 纪律 |
| **典型产出** | models、repository、migration 脚本、查询优化 |

**强触发词**

- `SQLAlchemy`、`Django ORM`、`Peewee`、`Tortoise ORM`
- `Alembic`、`migration`、`迁移`、`schema`
- `PostgreSQL`、`MySQL`、`SQLite`、`MongoDB`、`Redis`
- `事务`、`transaction`、`rollback`、`deadlock`
- `N+1`、`lazy load`、`eager load`、`selectinload`
- `索引`、`index`、`query optimization`

**弱触发词**

- `数据库`、`CRUD`、`模型`
- `连接池`、`connection pool`

**推荐路径**

- `P1`（持久化功能）
- `P2`（DB 相关异常）
- `P5`（慢查询）

**常与以下模块叠加**

- `REF-SECURITY`（SQL 注入）
- `REF-PERF`（查询性能）

---

### `SKILL-REFACTOR` — `skills/refactor-surgery.md`

| 属性 | 值 |
|:---|:---|
| **职责** | 行为不变重构、绞杀者模式、提取服务层、消除上帝类、分步 PR 策略 |
| **典型产出** | 分阶段重构计划、兼容层、deprecation 路径 |

**强触发词**

- `重构`、`refactor`、`整理代码`、`太乱了`
- `抽离`、`提取`、`解耦`、`split module`
- `上帝类`、`god object`、`spaghetti`
- `legacy 改造`、`绞杀者`、`strangler`
- `行为不变`、`no behavior change`

**弱触发词**

- `cleanup`、`技术债`
- `rename`、`move file`（小范围可能仅需 `REF-METHODOLOGY`）

**推荐路径**

- `P3`（必加）

**硬性纪律**

- 重构前后测试必须全绿；无测试则先 `REF-TESTING` 补关键路径

**常与以下模块叠加**

- `REF-ARCHITECTURE`
- `REF-TESTING`
- `REF-METHODOLOGY`

---

## Prompts 与 Examples

### `PROMPT-DEFAULT` — `prompts/default.md`

| 属性 | 值 |
|:---|:---|
| **职责** | 用户只说「帮我写 Python」时的结构化提问模板与默认交付标准 |
| **加载时机** | 用户意图模糊、缺少验收标准、无路径信号 |

**强触发词**

- `帮我写 Python`、`写个脚本`、`做个工具`（无细节）
- `你看着办`、`随便实现`

**使用方式**

- 读取模板 → 内化默认验收项 → 最多问 1–3 个高价值澄清问题 → 进入 `P1` 或 `P7`

---

### `EX-SUCCESS` — `examples/success-case.md`

| 属性 | 值 |
|:---|:---|
| **职责** | 展示「标准模式」「审查模式」「调试模式」黄金样例 |
| **加载时机** | 用户要求「按示例格式」「给我同样质量」；或复杂交付前自检对照 |

**强触发词**

- `示例`、`样例`、`参考输出`、`像上次那样`
- `标准格式`、`专业报告`

**不触发**

- 日常小改动（避免过度格式化）

---

## 全局触发词索引

### 一级：Soul 整体激活

| 类别 | 触发词 |
|:---|:---|
| **身份** | Python、资深 Python、Senior Python Developer、Python 工程师、Python 专家 |
| **命令** | `/senior-python-developer`、`/python-dev`、`/py-dev` |
| **文件信号** | `.py`、`pyproject.toml`、`requirements.txt`、`setup.cfg`、traceback 堆栈 |
| **框架** | FastAPI、Django、Flask、Starlette、Celery、Pydantic、SQLAlchemy |

### 二级：任务路径触发

| 路径 | 代号 | 核心触发词 |
|:---|:---|:---|
| 探索理解 | P0 | 解释、干什么、架构是什么、walkthrough、读懂 |
| 新功能 | P1 | 实现、添加、支持、开发、feature、build |
| 修 Bug | P2 | 报错、bug、fix、traceback、不工作、异常、failed |
| 重构 | P3 | 重构、refactor、整理、解耦、太乱、cleanup |
| 代码审查 | P4 | review、审查、PR、merge request、看看代码 |
| 性能 | P5 | 慢、优化、性能、OOM、内存、CPU、latency、timeout |
| 测试专项 | P6 | 测试、pytest、coverage、TDD、mock、fixture |
| 架构设计 | P7 | 架构、设计、选型、greenfield、从零、system design |
| 工具/DevOps | P8 | CI、CD、lint、format、Docker、deploy、pipeline |
| 库/SDK | P9 | 打包、发布、PyPI、library、SDK、semver、breaking change |

### 三级：技术域关键词（加速加载）

| 关键词簇 | 加载模块 |
|:---|:---|
| asyncio / await / 并发 / 队列 / worker | `SKILL-ASYNC` |
| FastAPI / Django / REST / OpenAPI / GraphQL | `SKILL-API` |
| SQLAlchemy / ORM / migration / Alembic / 事务 | `SKILL-DATA` |
| 安全 / JWT / OAuth / 注入 / secret / 漏洞 | `REF-SECURITY` |
| 慢 / profile / OOM / p99 / 内存泄漏 | `REF-PERF` |
| ruff / mypy / CI / pyproject / poetry / uv | `REF-TOOLCHAIN` |
| traceback / debug / 复现 / stack trace | `SKILL-DEBUG` |
| 重构 / 解耦 / god class / strangler | `SKILL-REFACTOR` |
| 最佳实践 / Pythonic / 方法论 | `REF-METHODOLOGY` |
| 分层 / DDD / DI / clean architecture | `REF-ARCHITECTURE` |

---

## 任务路径与模块映射（P0–P9）

### 全局基线（所有路径）

```
SOUL.md + STYLE.md + RULES.md + SKILL.md
```

### 分路径追加表

| 路径 | 必加载 | 强烈建议 | 条件加载 |
|:---|:---|:---|:---|
| **P0** | `REF-METHODOLOGY` | — | 涉架构概览 → `REF-ARCHITECTURE` |
| **P1** | `REF-METHODOLOGY`, `REF-TESTING` | `REF-ARCHITECTURE` | API → `SKILL-API`；DB → `SKILL-DATA`；async → `SKILL-ASYNC`；安全功能 → `REF-SECURITY` |
| **P2** | `SKILL-DEBUG`, `REF-TESTING` | `REF-PERF` | async 堆栈 → `SKILL-ASYNC`；DB 堆栈 → `SKILL-DATA`；HTTP → `SKILL-API` |
| **P3** | `SKILL-REFACTOR`, `REF-TESTING` | `REF-METHODOLOGY`, `REF-ARCHITECTURE` | 大模块拆分 → `SKILL-API` / `SKILL-DATA` |
| **P4** | `REF-METHODOLOGY`, `REF-SECURITY` | `REF-TESTING` | API 面 → `SKILL-API`；性能疑点 → `REF-PERF` |
| **P5** | `REF-PERF` | `REF-TESTING` | 并发 → `SKILL-ASYNC`；慢查询 → `SKILL-DATA` |
| **P6** | `REF-TESTING` | `REF-METHODOLOGY` | 涉 API 契约 → `SKILL-API` |
| **P7** | `REF-ARCHITECTURE`, `REF-METHODOLOGY` | `REF-SECURITY`, `REF-TESTING` | 含 API → `SKILL-API`；含数据 → `SKILL-DATA`；含部署 → `REF-TOOLCHAIN` |
| **P8** | `REF-TOOLCHAIN` | `REF-TESTING` | 容器 → 叠加 Docker 相关实践（在 TOOLCHAIN 内） |
| **P9** | `REF-METHODOLOGY`, `REF-TOOLCHAIN` | `REF-TESTING`, `REF-ARCHITECTURE` | 公共 API 文档 → `SKILL-API` |

### 路径优先级（多信号并存）

```
P2（阻塞 bug）> P5（生产性能）> P1 > P3 > P6 > P4 > P7 > P8 > P9 > P0
```

**示例消歧**

| 用户原话 | 主路径 | 加载包 |
|:---|:---|:---|
| 「FastAPI 返回 500，帮我查」 | P2 | 基线 + DEBUG + API + TESTING |
| 「给 UserService 加 Redis 缓存」 | P1 | 基线 + METHODOLOGY + TESTING + DATA |
| 「review 这个 PR，顺便看 SQL 注入」 | P4 | 基线 + METHODOLOGY + SECURITY + DATA |
| 「pytest 太慢」 | P5 + P6 | 基线 + PERF + TESTING |
| 「解释这个项目结构」 | P0 | 基线 + METHODOLOGY |
| 「把单体拆成模块，行为不变」 | P3 | 基线 + REFACTOR + TESTING + ARCHITECTURE |

---

## 加载规则与编排协议

### 规则 L1：先加载后动手

- 不得在未 Read 相关模块前修改代码或给出最终架构结论。
- 已加载模块内的 **Checklist 必须执行**，不可「读过但跳过」。

### 规则 L2：最小充分集（Minimum Sufficient Set）

- 只加载完成任务所需的模块，避免 token 浪费。
- 但若 `RULES.md` 与 `SKILL.md` 冲突，以 **更保守** 者为准。

### 规则 L3：加载顺序

```
1. 核心四件套（SOUL / STYLE / RULES / SKILL）
2. SKILLS-MANIFEST（仅复杂/模糊任务）
3. 路径必加载模块（按 P0–P9 表）
4. 关键词加速模块
5. 示例/模板（PROMPT-DEFAULT / EX-SUCCESS，按需）
```

### 规则 L4：并行与批量

- 同一批次内无依赖的 references 可并行 Read。
- 建议单次任务 **不超过 6 个** 非核心模块；超出时先读 MANIFEST 决策树裁剪。

### 规则 L5：模块失效与降级

| 情况 | 降级策略 |
|:---|:---|
| 子模块文件不存在 | 回退到 `SKILL.md` 内嵌 workflow；在交付中注明假设 |
| 用户禁止读文件 | 仅用已加载上下文；明确置信度下降 |
| 用户只要概念讲解 | 仅核心四件套；路径降为 P0；不加载 skills |

### 规则 L6：多技能编排模式

当 ≥3 个专精模块同时命中：

1. 读 `SKILLS-MANIFEST.md`（本文件）
2. 确定 **单一主路径**（P0–P9）
3. 按主路径必加载表加载
4. 将其余命中模块标为 **secondary**，在 workflow 中按需引用（不重复劳动）

### 规则 L7：与 Grok 工具联动

| 阶段 | 工具 | 关联模块 |
|:---|:---|:---|
| 侦察 | Shell、Glob、Read | `SKILL.md` Repo Recon |
| 定位 | Grep、Read | `SKILL-DEBUG`、`SKILL-DATA` |
| 验证 | Shell（pytest/ruff/mypy） | `REF-TESTING`、`REF-TOOLCHAIN` |
| 交付 | — | `STYLE.md`、`EX-SUCCESS` |

---

## 多技能冲突与优先级

### 冲突 C1：修 Bug vs 重构

- **用户明确要重构** → P3，即使代码 currently broken，也先写失败测再重构
- **用户明确要紧急修复** → P2，禁止借机大重构（Boy Scout Rule 仅允许局部清理）

### 冲突 C2：性能 vs 功能

- 生产阻塞 → P2
- 性能回归但功能可用 → P5
- 新功能附带性能要求 → P1 + `REF-PERF` 验收指标

### 冲突 C3：安全 vs 交付速度

- `REF-SECURITY` 发现的 **blocker** 问题优先于功能交付
- 须明示风险与临时缓解（feature flag、WAF 规则），不得静默忽略

### 冲突 C4：同步 vs 异步

- 未要求 async 时 **默认同步**（简单优先）
- 已有 async 代码库中 **禁止** 无审查地混用阻塞 I/O → 加载 `SKILL-ASYNC`

### 冲突 C5：审查 vs 实现

- 用户说「review 并顺便改」→ 先 P4 输出审查结论，再经用户确认或 blocker 项进入 P1/P2
- 除非 blocker 有明确修复授权，否则审查模式不直接大改代码

---

## 快速决策树

```
用户请求
    │
    ├─ 是否 Python 工程任务？
    │       └─ 否 → 不加载本 Soul（或仅概念模式 P0）
    │
    ├─ 激活核心四件套
    │
    ├─ 意图是否模糊？
    │       └─ 是 → 加载 PROMPT-DEFAULT + MANIFEST
    │
    ├─ 判定主路径 P0–P9
    │
    ├─ 按路径表加载 references
    │
    ├─ 扫描三级关键词 → 追加 skills
    │
    ├─ 命中 ≥3 技术域？
    │       └─ 是 → 读 MANIFEST 编排，裁剪模块
    │
    └─ 执行 SKILL.md Workflow → 交付前对照 Checklist
```

### 30 秒选型表（急救）

| 用户第一句话 | 主模块 |
|:---|:---|
| 贴 traceback | `SKILL-DEBUG` |
| 「这个接口怎么设计」 | `SKILL-API` + `REF-ARCHITECTURE` |
| 「迁移数据库字段」 | `SKILL-DATA` + `REF-TESTING` |
| 「加 GitHub Actions」 | `REF-TOOLCHAIN` |
| 「代码太乱帮我整理」 | `SKILL-REFACTOR` + `REF-TESTING` |
| 「有没有安全漏洞」 | `REF-SECURITY` |
| 「用 asyncio 重写」 | `SKILL-ASYNC` + `REF-PERF` |
| 「补测试覆盖率」 | `REF-TESTING` |
| 「从零设计系统」 | `REF-ARCHITECTURE` + `SKILL-API` + `SKILL-DATA` |

---

## 模块依赖图

```mermaid
flowchart TD
    ENTRY[SKILL.md 入口]
    MANIFEST[SKILLS-MANIFEST.md]
    SOUL[SOUL.md]
    STYLE[STYLE.md]
    RULES[RULES.md]

    METH[REF-METHODOLOGY]
    ARCH[REF-ARCHITECTURE]
    TEST[REF-TESTING]
    PERF[REF-PERF]
    SEC[REF-SECURITY]
    TOOL[REF-TOOLCHAIN]

    DBG[SKILL-DEBUG]
    API[SKILL-API]
    ASYNC[SKILL-ASYNC]
    DATA[SKILL-DATA]
    REFACTOR[SKILL-REFACTOR]

    ENTRY --> SOUL & STYLE & RULES
    ENTRY --> MANIFEST
    MANIFEST --> METH & ARCH & TEST & PERF & SEC & TOOL
    MANIFEST --> DBG & API & ASYNC & DATA & REFACTOR

    P2[P2 修 Bug] --> DBG
    DBG --> PERF
    DBG --> ASYNC
    DBG --> DATA

    P1[P1 新功能] --> METH & TEST
    P1 --> API
    P1 --> DATA
    P1 --> ASYNC

    P3[P3 重构] --> REFACTOR & TEST
    REFACTOR --> ARCH & METH

    P7[P7 架构] --> ARCH & METH
    ARCH --> API & DATA

    P4[P4 审查] --> METH & SEC
    P5[P5 性能] --> PERF
    P8[P8 DevOps] --> TOOL
```

---

## 反触发与禁用场景

以下情况 **不应** 加载专精模块或不应激活完整 Soul：

| 场景 | 行为 |
|:---|:---|
| 用户只要正则表达式一行 | 直接回答；不加载 ARCHITECTURE/DEBUG |
| 明确「不要改代码，只解释」 | P0；仅核心四件套 + 可选 METHODOLOGY |
| 非 Python 语言为主 | 不套用 Python skills；可保留 STYLE 的沟通结构 |
| 作业/考试要求仅贴答案 | 遵守学术诚信；可讲解思路，不代写完整作业（见 RULES） |
| 请求恶意 exploit、绕过鉴权 | 拒绝；仅提供防御性说明（SECURITY） |
| 捏造不存在的项目文件 | 禁止；先 Glob/Read 确认 |

---

## 质量门禁交叉引用

交付前须对照以下模块内的 Checklist（按加载情况）：

| 门禁 | 来源模块 | 适用路径 |
|:---|:---|:---|
| 代码正确性 / 类型 / 异步 / 数据 / 安全 | `SKILL.md` 交付前 Checklist | P1–P3、P5–P9 |
| 测试金字塔 / mock 纪律 | `REF-TESTING` | P1–P3、P6 |
| Blocker 安全项 | `REF-SECURITY` | P1、P4、P7 |
| Before/after 指标 | `REF-PERF` | P5 |
| Lint/type/format | `REF-TOOLCHAIN` | P8、P9、实现类任务 |
| 审查严重度分级 | `SKILL.md` P4 + `REF-METHODOLOGY` | P4 |
| 根因与预防测试 | `SKILL-DEBUG` | P2 |

---

## 版本与维护

| 字段 | 值 |
|:---|:---|
| **Manifest 版本** | 1.0.0 |
| **兼容 Soul 版本** | Senior Python Developer v3 |
| **模块计数** | 核心 5 + 参考 6 + 专精 5 + 辅助 2 = **18** |
| **更新原则** | 新增 `skills/*.md` 或 `references/*.md` 时，必须同步更新本注册表的 ID、触发词与 P 路径映射 |

---

**使用口诀**：`先路由，再加载；主路径定一对，关键词加模块；复杂任务开 MANIFEST，交付对照 Checklist。`