delegation

核心用法

delegation 是一个面向 AI 编码 Agent 的架构优先工作流技能，核心目标是在代码编写前建立严格的架构约束。使用时，Agent 必须遵循以下流程：首先阅读架构文档并分析新代码在系统中的定位；其次声明目标文件路径、列出依赖项与消费者；最后检查功能冲突。输出格式强制包含架构分析、文件路径声明、完整代码实现、测试要求及架构影响评估五个部分，确保每一行代码都有明确的系统归属。

显著优点

该技能的最大价值在于预防性架构治理。通过强制性的前置分析步骤，从根本上避免技术债务累积——代码在编写前就必须回答"为什么存在"和"如何融入系统"两个核心问题。其合规检查清单涵盖输入验证、环境变量管理、错误处理、类型安全等 10 项生产级要求，显著降低安全漏洞和运行时故障风险。此外，技能明确倡导关注点分离、命名规范、模式复用等工程最佳实践，适合作为团队编码规范的自动化执行层。

潜在缺点与局限性

作为纯文档型技能，，delegation 本身不具备强制执行力，其效果完全依赖 Agent 的遵循程度。对于缺乏成熟架构文档的遗留项目，前置的"阅读架构文档"步骤可能形成阻塞。此外，严格的流程可能降低快速原型开发效率，在小规模实验性项目中显得过重。技能未提供架构文档的具体格式标准，不同团队可能需要额外适配。

适合的目标群体

该技能最适合中大型生产系统的开发团队，尤其是采用微服务或分层架构、有明确技术负责人和代码审查流程的组织。对于需要维护长期代码库、对稳定性和可维护性要求高于开发速度的场景（如金融、医疗、企业级 SaaS），该技能的价值最为突出。技术负责人也可将其作为新人 onboarding 的标准化工具。

使用风险

主要风险在于流程摩擦成本：严格的前置分析可能延长单次编码任务的交付时间，若团队缺乏配套的架构文档基础设施，反而导致效率下降。此外，技能要求 Agent 具备较强的架构理解能力，低质量的分析可能比无分析更危险——错误的架构定位将导致系统性偏差。建议配合 /senior-dev 等代码审查技能形成完整闭环，避免单一技能的局限性。