SuperAPI AI 工具集

design-doc

写作与研究

查看项目

更新于 10-16 08:47

技能介绍

用途:把已选定的概念收敛为一份同事可评审的模块或系统设计文档,并随结果持续更新;文档说明提议内容、哪些接口固定、哪些实现是可替换适配器、哪些部分由测试验证、哪些由评估验证、每个决策依赖什么证据、什么条件会推翻它,以及还有哪些赌注等待测量。适合核心行为来自训练模型、判定器或智能体循环的模块。

主要能力:拥有文档的语义结构(有哪些章节、各写什么、如何联动);提供状态(WIP/In Review/Approved/Obsolete)、摘要、上下文与范围、目标与非目标、设计、接口与接缝、威胁模型、验证划分、备选方案、开放问题、实验队列、决策日志、参考等结构。接口与接缝要求把学习或判定组件放在固定接口后,用适配器比较候选;数据流、失败行为、生命周期都要写明。验证划分把组件分为测试侧(规则可判)与评估侧(基于分布的判断)。决策日志记录状态、证据种类、证据位置和可检视的推翻条件。

必要用法:起草前确认概念已选定;先收集早期材料(探索笔记、批评、访谈简报、测量与文献)再提问。文档路径按用户指定,否则按项目惯例,否则 docs/design/<slug>.md,并说明路径。可先用 interview 结算开放问题,再用实验队列交给 ml-experiment 或 evaluation-design 安排测量。更新请求只授权编辑文档,不授权新运行或代接受决策。

限制:产品需求规格、用户故事、任务拆解属于别的类型;实现任务与排期交给 work-plan。不规定测试先行或覆盖率目标。威胁模型仅在对抗性场景下存在,且不写攻击流程或具体对抗输入。缺失事实:具体模板内容、示例命令等本资料未提供。