Improve Architecture 是一个用于发现并塑造架构改进或简化机会的技能,主要面向难以理解、难以测试、浅层、分散或过度耦合的代码。它的目标是找到具体的架构摩擦,并只塑造仍然需要的决策。
用途 该技能用于发现机会,或澄清尚未解决的模块、接口、接缝选择。它适合在代码库出现架构层面的困扰时使用,例如知识分散、浅层透传层、细节泄漏、可避免的分支或可变状态、难以测试的行为、变更放大、归属不清,或数据模型允许非法状态。
主要能力 技能从调用方可见的使用方式出发,绘制最小可用的调用、组件、数据或控制流草图,以厘清模块、归属、接口与接缝。它会识别有证据支撑的架构摩擦,并在用户尚未选定区域时,给出少量排序后的候选。候选摘要会列出区域、观察到的摩擦、机会、收益、风险与证据。对已选候选,技能只澄清关键约束、迁移、验证与调用方影响。当接口或接缝的放置确实未解决时,技能会比较两到三个实质不同的选项,依据调用方影响、隐藏复杂度、迁移成本、可测试性、波动性与归属进行权衡,并推荐其中一个。
使用方式 技能会使用 architecture-language.md、engineering-discipline.md,以及仓库中存在的 Glossary/ADRs。它返回最小可用的下一步产物:推荐、接口选择、有边界的 simplify-work 或 implement-work 范围、Plan 请求或交接。默认不创建 Plan 或交接。它不强制候选选择、访谈、Plan 或交接。
边界与限制 该技能用于发现机会或澄清未解决的模块/接口/接缝选择。若要判断具体变更、PR 或阶段中的架构,应使用 review-work。已选定的保持行为的简化应交给 simplify-work;其他已决定的实现应交给 implement-work。Review 可以推荐此技能,但不应自动启动它。技能将架构词汇视为启发式;当单个适配器能隔离波动性、归属或测试时,可以证明接缝合理,此时应询问它保护的是什么边界。优先使用公开或有意稳定的接口作为行为测试面,而不是仅为测试暴露内部。技能不提议大范围重写,不在没有新摩擦的情况下重新争论 ADR,也不让普通功能工作不必要地使用架构术语。
适用场景 适用于需要发现架构改进或简化机会、澄清模块/接口/接缝选择、评估接口放置方案,以及为后续简化或实现工作界定范围的场景。
限制 资料未提供关于收费、价格、平台、具体安装命令或效果保证的信息。