用途
Core Design Principles(核心设计原则)是一份操作清单,用于把 Black-Tortoise 的设计原则应用到一次具体的代码改动中。它帮助你在动手前明确边界与归属,避免过度设计。
何时使用
- 任务感觉“很容易被过度构建”(新增辅助函数、新增层级、新增抽象)。
- 你不确定代码应该放在哪里。
- 你需要在“快速修复”与“正确边界”之间做选择。
输入(需询问/确认)
- 这次改动由哪个能力/限界上下文(bounded context)拥有?
- 下一层所需的最小稳定接口是什么?
- 副作用(如果有)在哪里?
工作流(工具优先 → 组装)
- 识别工具:最小的可复用单元(纯函数、端口、适配器、store 方法)。
- 放入拥有者(能力 / 工作区 / 事件 / 集成),不进行跨上下文导入。
- 添加组装:用 facade/effect/component 将其接线,保持单向数据流。
- 验证删除路径:移除该功能应主要是删除代码,而不是解开纠缠。
硬性检查(快速失败)
- 不新增违反 Presentation → Application → Domain 的跨层导入。
- 领域侧不引入框架导入或副作用。
- 不使用“上帝”工具;优先小而意图明确的 API。
- 状态保持集中化;UI 绑定到信号(signals)。
参考
- .github/instructions/05-design-principles-copilot-instructions.md
- AGENTS.md 与 src/app/**/AGENTS.md
限制
资料未提供该技能的具体安装命令、支持的平台、收费方式或效果数据,这些信息暂未提供。