name: python-business-context description: python 项目的业务上下文 skill。用于让 AI 基于 Business Context Layer 理解该 Java/Spring 后端项目,并在新需求开发、缺陷排查、接口变更、数据库字段变更、MQ/Job 改造、业务流程调整时快速定位业务域、核心入口、数据模型、集成依赖和风险点。候选业务域包括:order、user、tasks、refunds、refund。
python Business Context Skill
使用目标
使用本 skill 时,先通过业务语义定位需求,再阅读精确代码。不要直接全局搜索后开始改代码;必须先建立"需求 -> 业务域 -> 流程 -> 入口 -> 数据 -> 风险 -> 测试"的链路。
需求定位快速通道
收到需求后,用需求中的关键词在下表中快速匹配业务域:
| 需求关键词 | 定位域 | 首先阅读 |
|---|---|---|
| order, {order_id}, create, status, and | order | OrderService |
| user, register, {user_id}, business, service. | user | UserService |
| tasks, celery, async, for, order | tasks | - |
| refunds, int:pk, approve, django, url | refunds | - |
| refund, class-based, views, (django, rest | refund | RefundListView |
新需求处理流程
- 读取
00_project_overview.md,了解系统定位、模块、候选业务域和核心风险。 - 用上面的"需求定位快速通道"或
05_indexes/business_domain_map.md定位候选业务域。 - 读取候选业务域的
01_business_domains/<domain>/skill.md(每个域最重要的入口文件)。 - 读取
call_chains.md了解调用关系,再按需深入workflows.md、concepts.md等。 - 根据映射中的文件路径回到源码阅读。
- 修改代码前检查权限、事务、幂等、并发、缓存、状态机、外部接口、历史数据兼容和测试影响。
- 完成需求后更新对应领域文档和相关索引。
快速入口
- 项目总览:
00_project_overview.md - 业务域地图:
05_indexes/business_domain_map.md - 域间调用图:
05_indexes/call_graph.md - API 索引:
05_indexes/api_index.md - 代码入口索引:
05_indexes/code_entrypoint_index.md - Git 活跃度:
05_indexes/git_activity.md(热点文件、域活跃度、贡献者) - 可选辅助知识:
06_auxiliary_knowledge/auxiliary_knowledge.md
上下文加载策略(L0/L1/L2)
- L0:先加载项目总览、需求定位快速通道、术语表。
- L1:只加载命中的业务域
skill.md+call_chains.md。 - L2:再加载该业务域的 workflows/concepts/API/DB/integration/risk/examples。
- Source:最后阅读 L2 指向的源码文件。