python-plan-optimization

python-plan-optimization 技能提供了一套严谨的 6 阶段只读分析工作流程，专门用于评估嵌入在 Markdown 设计文件中的 Python 代码块。此工具适合软件工程师、架构师和技术主管，协助他们在实施前确保设计文件符合行业最佳实践（如 SOLID、DRY、KISS 和 YAGNI）。通过处理一份或多份文件，该代理程序能生成详细报告，指出设计原则违规、代码异味 (code smells)，以及采用现代 Python 功能（如类型提示和 dataclasses）的改进机会。

• 多阶段分析管线：在 6 个不同阶段进行系统性的发现、评估与验证。
• 情境感知阈值：根据项目成熟度等级（POC、MVP、Private、Enterprise 和 Open Source）调整敏感度和分析深度。
• 严格的只读执行：在不修改原始文件的前提下运作，确保文件的完整性，同时提供可行的建议。
• 架构合规性检查：根据明确的项目决策、选定的工具和架构理由，对拟议的代码进行验证。
• 实证验证：要求针对第三方 API 声明进行 WebSearch，并通过周围情境检查验证逻辑，有效减少误报。

使用注意事项与限制包括：

• 请确保提供项目类型情境（例如通过前置的判定技能），以便配置正确的报告严重程度与深度。
• 工具要求所有发现都必须附带精确的代码引用；若无法验证代码逻辑或引用不足，分析将会失败。
• 工具会刻意忽略 # TODO 或存根实现，专注于结构和模式导向的分析。
• 输出结构为专业分析报告而非代码修改，旨在作为设计阶段的咨询层。
• 开发人员应注意，在开源模式下，代理程序会强制进行额外的公开 API 文档检查与类型标注覆盖率验证。
• 该代理程序作为分析护栏，可防止推荐尚未发布的 Python 特性或可能导致架构负债的过时数据缓存模式。