Delegation

🏗️ 架构优先的AI代码委托规范

架构优先的AI代码委托工作流,强制代码编写前验证架构适配性,确保系统一致性与可维护性

收藏
10.2k
安装
2.4k
版本
0.1.0
CLS 安全扫描中
预计需要 3 分钟...

使用说明

核心用法

delegation 是一种面向生产级软件开发的架构优先工作流技能,专门设计用于将复杂项目委托给AI编码代理时维持代码质量与系统一致性。其核心机制要求AI在编写任何代码之前,必须先深度理解并声明代码在架构中的位置。

使用流程分为五个强制步骤:
1. 读取架构文档 — 确定新代码的归属位置

2. 声明目标文件路径 — 明确代码存放位置

3. 列出依赖项 — 识别所有导入和依赖关系

4. 列出消费者 — 明确代码的使用方

5. 检查冲突 — 验证是否重复现有功能

响应格式采用结构化模板,包含架构分析、文件路径声明、完整代码实现、测试要求、架构影响评估,以及12项合规检查清单。

显著优点

  • 预防架构漂移:强制前置架构分析,从源头阻止技术债务积累
  • 提升代码可维护性:依赖关系和消费方显式声明,降低认知负荷
  • 确保生产就绪:包含类型安全、错误处理、输入验证等完整工程实践
  • 标准化团队协作:统一响应格式减少沟通摩擦
  • 冲突早期发现:在编码前识别功能重复和架构冲突

潜在缺点与局限性

  • 前置成本高:小型项目或快速原型场景可能显得繁琐
  • 架构文档依赖:若架构文档缺失或过时,技能效果大打折扣
  • 灵活性受限:严格遵循现有模式可能抑制创新解决方案
  • 学习曲线:需要开发者理解并执行完整的合规检查清单
  • AI代理适配性:部分AI编码工具可能无法完全遵循复杂的响应格式

适合人群

  • 维护大型、长期运行的生产代码库的资深开发团队
  • 采用严格分层架构(如Clean Architecture、Hexagonal Architecture)的项目
  • 多人协作、需要防止"意大利面条代码"的企业级开发场景
  • 技术负责人需要确保AI生成代码符合既定规范的场景

常规风险

  • 架构文档与实现脱节:若架构文档未及时更新,技能可能强化错误结构
  • 过度工程化风险:简单功能可能因流程冗长而开发效率下降
  • AI幻觉传播:若架构分析阶段产生错误理解,后续所有输出将基于错误前提
  • 合规清单流于形式:开发者可能机械勾选而未真实执行检查

Delegation 内容

手动下载zip · 2.6 kB
skill-card.mdtext/markdown
请选择文件