适用于 Openclaw 的 Python Architecture Optimizer

一个专门用于分析和重构 Python 项目结构的工具,使其符合现代行业最佳实践。

jjflydudu
v1.0.2
2026年3月15日
0
806
0

安装与下载

1. ClawHub CLI

从源直接安装技能的最快方式。

npx clawhub@latest install python-arch-optimizer

2. 手动安装

将技能文件夹复制到以下位置之一

全局模式
~/.openclaw/skills/
工作区
<project>/skills/

优先级:工作区 > 本地 > 内置

3. 提示词安装

将此提示词复制到 OpenClaw 即可自动安装。

请帮我使用 Clawhub 安装 python-arch-optimizer。如果尚未安装 Clawhub,请先安装(npm i -g clawhub)。

更倾向于下载?

获取包含原生技能文件的ZIP压缩包。

什么是 Python Architecture Optimizer?

Python Architecture Optimizer 是 Openclaw Skills 生态系统中的一款高级工具,旨在评估和转换 Python 代码库。它专注于通过根据 PEP 8 和社区标准审计目录结构、依赖管理和代码组织来提高项目的可维护性。

通过利用自动化分析和迁移脚本,它帮助开发人员摆脱单体或杂乱的布局,转向模块化、可测试且生产就绪的架构。它确保业务逻辑、配置和测试等关注点被妥善解耦,使项目更易于扩展并集成到现代 CI/CD 流水中。

Python Architecture Optimizer 应用场景

  • 评估现有项目架构的技术债。
  • 将杂乱的目录结构重构为功能模块。
  • 使用 pyproject.toml 或 Poetry 优化依赖管理。
  • 建立健壮的测试框架和覆盖率报告。
  • 配置专业级的工程工具,如 ruff、black 和 pre-commit 钩子。

Python Architecture Optimizer 工作原理

  1. 架构分析:运行分析脚本以识别循环依赖、深层嵌套、缺失的 __init__.py 文件和硬编码配置。
  2. 生成建议:将当前项目状态与最佳实践库进行对比,生成量身定制的优化报告。
  3. 用户确认:向用户展示迁移计划,在进行任何文件操作前需要获得明确同意。
  4. 执行与备份:在执行重构的同时创建带有时间戳的备份,并支持 dry-run 预览。
  5. 验证:执行 linting 和测试套件,以验证重构后应用程序的功能完整性是否保持不变。

Python Architecture Optimizer 配置指南

要开始从 Openclaw Skills 集合中使用此工具,请确保您的 Python 环境已激活并导航到项目根目录:

# 分析当前项目结构
python scripts/analyze_project.py <project-path>

# 查看最佳实践参考
cat references/best-practices.md

Python Architecture Optimizer 数据架构与分类体系

该技能通过一组特定的脚本和参考文件来组织其操作:

组件 描述
scripts/analyze_project.py 审计当前目录和代码健康状况。
scripts/generate_structure.py 提议一个新的、优化的目录布局。
scripts/migrate_project.py 处理文件移动、备份和回滚。
references/best-practices.md Python 架构标准的核心逻辑源。
migration-plan.json 生成的中间文件,用于在执行前供用户评审。

Python Architecture Optimizer 高级特性

  • 安全第一回滚:如果迁移在中途失败,自动从备份文件夹恢复项目。
  • Dry-Run 预览:使用 --dry-run 标志查看哪些文件将被移动或修改,而不会更改磁盘。
  • 自动化工程套件:配置高级 linting 工具,包括 ruff、black 和 mypy 用于静态类型检查。
  • CI/CD 集成:生成现成的自动化工作流模板和 pre-commit 钩子,以维护架构质量。

SKILL.md


加载中

Openclaw 相关技能

METADATA

Github Stars: 0
forks: 0

精选*