Python 项目结构与边界
原名：python-project-structure
明确源码、测试、公共接口和模块职责，让小项目也能逐步扩展。
中文 Skills 技能说明
OPC 的 Python 工具准备从单个脚本变成可维护项目时，可让开发岗位数字员工规划。提供目录、入口、依赖、使用方式和测试，技能检查包布局、模块边界、导入与公共接口，交付目录建议和迁移步骤。不为了形式一次搬动全部文件，保留调用脚本和发布兼容性。分析可本地进行，桌面端重构需授权并查看逐项差异；先跑测试、说明入口变化和回退方案，正式打包或发布仍需人工确认。
上游能力依据
上游原始适用说明：Python project organization, module architecture, and public API design. Use when setting up new projects, organizing modules, defining public interfaces with all, or planning directory layouts.
上游 SKILL.md 主要章节（保留原文标题）：
- When to Use This Skill
- Core Concepts
- 1. Module Cohesion
- 2. Explicit Interfaces
- 3. Flat Hierarchies
- 4. Consistent Conventions
- Quick Start
- Fundamental Patterns
- Pattern 1: One Concept Per File
- Pattern 2: Explicit Public APIs with all
使用边界
先读取项目约定、依赖版本和现有测试，再提出最小改动。写文件、运行脚本、提交代码或发布前应检查差异并保留回退路径。
作者、翻译与许可证
- 原作者
- Seth Hobson（wshobson）与 agents contributors
- 中文翻译
- CEOFans翻译
- 许可证
- MIT
- 上游来源
- https://github.com/wshobson/agents/tree/46891e7e60da0e52baf1050b7b6391b64e84c6d9/plugins/python-development/skills/python-project-structure
适用范围
平台：linux、macos、windows；标签：软件开发、Python 项目结构与边界、开源技能
安全提示
基础静态扫描不等于绝对安全。技能可能调用命令、浏览器、云服务或本地文件，请在最小权限环境中使用，高风险操作必须人工确认。
如发现侵权、许可证或安全问题，可在本页前台提交投诉，管理员复核后可立即下架。