前言¶
接手或维护一个 Python 仓库时，常见情况是目录扁平、命名不统一、import 杂乱、缺少类型与文档，重构往往只能局部改几处。若希望 Agent 在用户提出「整理项目结构」「统一命名规范」等请求时，按一套可复用的规范做系统性整理，而不是零散改文件，可以把 Code Organizer 作为 dev-programming 类 Skill 接入工作流。
这是什么¶
Code Organizer 是 SkillHub 上的社区 Skill，坐标为 @user_8f9cac4a/code-organizer，当前版本 1.1.0，发布者为 user_8f9cac4a，分类为 dev-programming，标签标明 requires_api_key=false（无需额外 API Key）。
官方定位为：代码整理与项目重构技能。当用户要求「帮我整理一下这个项目让代码结构更清晰」「统一命名规范」或类似表述时，Agent 应主动使用该 Skill，对 Python 项目 做系统性整理与重构；默认遵循通用 Python 风格，并可根据项目类型（如深度学习、Web、API、CLI）自动调整侧重点。
核心功能¶
以下能力均来自 SkillHub 官方简介，按整理链路归纳，便于对照预期产出。
结构与架构¶
- 目录结构重组
- 分层架构 / DDD 结构设计
__init__.py公共 API 梳理
代码风格与可读性¶
- 代码格式规范
- 命名规范统一
- import 排序与导入组织规则
- 类型标注
- 规范注释与 Google-style docstring
设计与质量¶
- OOP SOLID 原则检查
- 函数设计规范
- 错误处理规范
- 冗余代码清理
- 配置参数化
测试与文档¶
- 单元测试补充
- 生成项目文档
安装与启用¶
SkillHub 页面给出的安装方式是：让 AI 根据官方安装文档安装该 Skill。下面介绍在本地用 skillhub CLI 安装的常见步骤；若尚未安装 CLI，需先按 SkillHub 安装说明完成环境准备。
1、检查或安装 skillhub CLI¶
command -v skillhub && skillhub --version
若未安装，可使用 SkillHub 文档中的完整安装命令（CLI + 默认 Skill）：
curl -fsSL https://skillhub-1388575217.cos.ap-guangzhou.myqcloud.com/install/install.sh | bash
仅安装 CLI 时：
curl -fsSL https://skillhub-1388575217.cos.ap-guangzhou.myqcloud.com/install/install.sh | bash -s -- --cli-only
（完整 URL 以 SkillHub 安装文档 为准。）
2、安装 Code Organizer 到当前 Agent 的 skills 目录¶
安装时必须用 --dir 指向当前 Agent 识别的 skills 目录，否则默认装到 ./skills/ 可能不会被加载。
skillhub install @user_8f9cac4a/code-organizer --dir <skills 目录>
常用路径示例（来自 SkillHub 安装文档）：
- Cursor：
~/.cursor/skills/ - Claude Code：
~/.claude/skills/ - Codex：
~/.codex/skills/或项目下的.agents/skills/
也可直接向 Agent 发送 SkillHub 页面提供的提示词大意：
请根据 https://skillhub.cn/install/skillhub.md，安装 `@user_8f9cac4a/code-organizer`。
安装后按你所用客户端要求重启或刷新 Skill 列表，使新 Skill 生效。
典型用法¶
本 Skill 的触发条件在官方简介中写得很明确：用户提出整理结构、统一命名等类似请求时，请主动使用此技能。
可复现的对话示例：
- 在已安装 Skill 的 Agent 中打开目标 Python 项目工作区。
- 用自然语言说明目标，例如：
- 「帮我整理一下这个项目，让代码结构更清晰。」
- 「统一这个仓库的命名规范和 import 顺序。」
- 「按分层架构梳理模块，并补 Google-style docstring 和基础单元测试。」 - Agent 在 Skill 指引下，按项目类型（深度学习 / Web / API / CLI 等）调整整理策略，依次处理目录、命名、格式、类型、注释、设计检查、测试与文档等项。
官方未提供固定 CLI 子命令；实际执行方式依赖 Agent 读取 Skill 定义（通用 SKILL.md 格式）后在对话中改代码与生成文件。
适用场景与注意¶
适合谁
- 维护或接手 Python 代码库，希望一次对话内覆盖「结构 + 风格 + 设计检查 + 测试/文档」的整理需求。
- 已在 Cursor、Claude Code、Codex 等支持 Skill 的环境中使用 SkillHub 安装流程的团队或个人。
限制与注意
- 面向 Python；其他语言需另选 Skill 或人工规范。
- 大规模重构前建议用版本控制做好备份或分支，再让 Agent 分步提交变更。
- SkillHub 元数据显示评分为 100000、下载 6985（以抓取资料为准）；整理结果仍依赖模型与项目上下文，宜在关键模块上人工复核。
- 无需 API Key（
requires_api_key=false），不引入额外密钥配置。
结尾¶
Code Organizer 把「整理 Python 项目」从零散改文件，收敛为可重复的 Skill 工作流：结构重组、规范统一、设计检查、测试与文档生成在一套说明里对齐。需要查阅详情或安装时，可使用官方页面：
- SkillHub 展示页：https://www.skillhub.cn/skills/user_8f9cac4a/code-organizer
- API 元数据：https://api.skillhub.cn/user_8f9cac4a/code-organizer
