SuperAPI AI 工具集

design

设计与创作

查看项目

更新于 11-03 20:58

技能介绍

用途

design 技能用于代理式工程流程中的设计阶段,目标是把变更意图、产品标准和技术不确定性,落实为契约、BDD 场景、决策和有用的原型,并让这些产物保持可追溯的关联。

主要能力

  • 读取与当前任务相关的故事、已接受的契约、规则和 ADR(通过 aep context <id> 及任务选定的来源),建立结果、边界、接口、失败情形和可观测的成功标准。
  • 在重要上下文缺失时,使用 aep --skill project --ref context-sources 补充。
  • 当产品目的、建议依据或基准适配可能改变设计时,通过 aep --skill roadmap --ref purpose-research 处理;并把用户已确定的方向通过 aep --skill roadmap --ref product-context 带入规范上下文。
  • 在领域结构、可用性或用户质量期望需要澄清时,阅读设计准则(aep --skill design --ref design-criteria);对可由实验回答的具体不确定性,阅读原型决策(aep --skill design --ref prototype),并按实际未知程度选择探索深度。
  • 行为与工作范围明确后,撰写变更契约并关联其故事;若设计产出多个故事,先创建它们的层,使故事、变更、设计和决策保持为同一概念的整体。
  • 未解决的探索保留为草稿,并记录下一步决策或实验。

使用方式

  • 草稿放在 docs/design/,已接受的权衡放在 project-roadmap/decisions/,场景差异放在变更下,并遵循所配置的存储位置。
  • 使用 aep change new --file <file> 和 aep decision new --file <file> 创建记录,具体操作语法可查看命令帮助。
  • 编写场景时阅读 BDD 契约(aep --skill design --ref bdd),创建初始记录时阅读记录输入(aep --skill design --ref records)。
  • 运行 aep spec check --change <id> 和 aep check 做结构校验;结构通过仍需针对任务做语义验证。
  • 在当前授权支持该决定时,通过 aep change accept <id> --by <actor> 接受;未解决的意图保留为显式未知项。
  • 交接内容包括接受来源、观察到的设计证据、相关约束和验证路径。

适用场景

适用于需要把变更意图、产品标准和技术不确定性系统化落为设计产物,并与故事、变更、决策保持关联的代理式工程任务。也适用于仅做设计交付、或设计后继续进入实现与验证交付的请求。

限制

该技能以 aep 命令行工作流为基础,具体命令语法需查阅命令帮助。结构校验不替代针对任务的语义验证。资料未提供该技能的具体版本、依赖环境、收费或价格信息。