架构优先的 AI 编码治理方案

来自 openclaw/skills 的架构优先开发工作流指南，强制要求代码编写前完成架构分析、依赖梳理与冲突检查，确保生产级代码质量与系统一致性。

基本信息

• 技能名称?delegation
• 中文名称?架构优先的 AI 编码治理方案
• 作者?michaelmonetized
• 分类?其他
• 版本?未标注
• 标签?development-engineering, product-management, project-program-management, backend, frontend, devops, automation

使用方法

使用说明
核心用法
delegation 是一个面向 AI 编码 Agent 的架构优先工作流技能，核心目标是在代码编写前建立严格的架构约束。使用时，Agent 必须遵循以下流程：首先阅读架构文档并分析新代码在系统中的定位；其次声明目标文件路径、列出依赖项与消费者；最后检查功能冲突。输出格式强制包含架构分析、文件路径声明、完整代码实现、测试要求及架构影响评估五个部分，确保每一行代码都有明确的系统归属。
显著优点
该技能的最大价值在于 预防性架构治理 。通过强制性的前置分析步骤，从根本上避免技术债务累积——代码在编写前就必须回答"为什么存在"和"如何融入系统"两个核心问题。其合规检查清单涵盖输入验证、环境变量管理、错误处理、类型安全等 10 项生产级要求，显著降低安全漏洞和运行时故障风险。此外，技能明确倡导关注点分离、命名规范、模式复用等工程最佳实践，适合作为团队编码规范的自动化执行层。
潜在缺点与局限性
作为纯文档型技能，， delegation 本身不具备强制执行力，其效果完全依赖 Agent 的遵循程度。对于缺乏成熟架构文档的遗留项目，前置的"阅读架构文档"步骤可能形成阻塞。此外，严格的流程可能降低快速原型开发效率，在小规模实验性项目中显得过重。技能未提供架构文档的具体格式标准，不同团队可能需要额外适配。
适合的目标群体
该技能最适合 中大型生产系统的开发团队 ，尤其是采用微服务或分层架构、有明确技术负责人和代码审查流程的组织。对于需要维护长期代码库、对稳定性和可维护性要求高于开发速度的场景（如金融、医疗、企业级 SaaS），该技能的价值最为突出。技术负责人也可将其作为新人 onboarding 的标准化工具。
使用风险
主要风险在于 流程摩擦成本 ：严格的前置分析可能延长单次编码任务的交付时间，若团队缺乏配套的架构文档基础设施，反而导致效率下降。此外，技能要求 Agent 具备较强的架构理解能力，低质量的分析可能比无分析更危险——错误的架构定位将导致系统性偏差。建议配合 /senior-dev 等代码审查技能形成完整闭环，避免单一技能的局限性。