delegation

核心用法

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

显著优点

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

潜在缺点与局限性

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

适合的目标群体

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

使用风险

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

核心用法

delegation Skill 是一种架构优先的开发工作流指导工具，核心目标是让 AI 编码代理在编写每一行代码之前，先证明这段代码在系统中的正当位置。

使用流程：
1. 前置强制：必须阅读架构文档，声明目标文件路径、依赖关系、消费者模块
2. 结构化输出：按固定格式响应——架构分析 → 文件声明 → 代码实现 → 测试要求 → 架构影响评估
3. 合规检查：10项强制清单（输入验证、错误处理、类型安全、认证模式等）
4. 冲突检测：自动识别功能重复或架构偏离，要求澄清而非假设

显著优点

• 防止技术债务：通过前置架构约束，从源头避免"先写再重构"
• 标准化协作：固定响应格式降低团队沟通成本
• 生产级质量：强制要求完全类型化、带错误处理的代码，而非草稿级实现
• 架构可演化：内置ARCHITECTURE UPDATE机制，结构化记录架构变更
• 零依赖风险：纯 Markdown 文档，无可执行代码

潜在局限

• overhead 较高：简单任务（如单行修复）可能显得繁琐
• 架构文档依赖：若项目缺乏清晰的架构文档，技能无法发挥核心作用
• 静态约束：无法动态验证实际代码是否真正遵循声明的依赖关系
• 适用范围：更适合复杂项目，简单脚本项目可能过度工程化

适合人群

• 大型项目团队：多人协作、模块边界模糊、技术债务累积风险高的场景
• 架构守护者：技术负责人需要将架构约束"硬化"到开发流程中
• AI辅助开发用户：希望AI生成代码具备"系统思维"而非局部优化

常规风险

• 形式主义风险：团队可能机械执行检查清单而非真正理解架构
• 架构文档过时：若架构文档本身未同步更新，技能将强化错误结构
• 与快速迭代冲突：初创公司 MVP 阶段可能因流程负担降低迭代速度

综合评估

这是一个设计精良的元技能（meta-skill），其价值不在于生成代码本身，而在于塑造 AI 编码代理的行为模式。对于已具备清晰架构的中大型项目，它能显著提升代码一致性；对于架构模糊或追求极致速度的场景，建议配合 /senior-dev 等后期审查技能使用，而非全程强制执行。