SuperAPI AI 工具集

core-design-principles

编程与开发

查看项目

更新于 10-15 07:54

技能介绍

用途

Core Design Principles(核心设计原则)是一份操作清单,用于把 Black-Tortoise 的设计原则应用到一次具体的代码改动中。它帮助你在动手前明确边界与归属,避免过度设计。

何时使用

  • 任务感觉“很容易被过度构建”(新增辅助函数、新增层级、新增抽象)。
  • 你不确定代码应该放在哪里。
  • 你需要在“快速修复”与“正确边界”之间做选择。

输入(需询问/确认)

  • 这次改动由哪个能力/限界上下文(bounded context)拥有?
  • 下一层所需的最小稳定接口是什么?
  • 副作用(如果有)在哪里?

工作流(工具优先 → 组装)

  1. 识别工具:最小的可复用单元(纯函数、端口、适配器、store 方法)。
  2. 放入拥有者(能力 / 工作区 / 事件 / 集成),不进行跨上下文导入。
  3. 添加组装:用 facade/effect/component 将其接线,保持单向数据流。
  4. 验证删除路径:移除该功能应主要是删除代码,而不是解开纠缠。

硬性检查(快速失败)

  • 不新增违反 Presentation → Application → Domain 的跨层导入。
  • 领域侧不引入框架导入或副作用。
  • 不使用“上帝”工具;优先小而意图明确的 API。
  • 状态保持集中化;UI 绑定到信号(signals)。

参考

  • .github/instructions/05-design-principles-copilot-instructions.md
  • AGENTS.md 与 src/app/**/AGENTS.md

限制

资料未提供该技能的具体安装命令、支持的平台、收费方式或效果数据,这些信息暂未提供。