SuperAPI AI 工具集

roadmap

智能体与模型

查看项目

更新于 11-03 20:58

技能介绍

Roadmap 是 agentic-engineering-patterns 技能集中的一个技能,主要用于维护产品方向、用户旅程、协作容器与决策记录,或依据已记录的证据说明当前进展。

用途与记录结构 该技能区分“期望的产品方向”与“实际的实现和交付历史”:主干(backbone)与用户旅程保存在 project-roadmap/,架构决策记录(ADR)保存在 project-roadmap/decisions/,工作记录保存在 project-ledger/,并遵循已配置的存储路径。

主要命令 记录使用 aep roadmap、aep decision、aep story、aep layer、aep wave、aep release;每个命令的输入参数需查看其帮助信息。其中,layer 封装一个概念,包括可观察结果、设计来源与成员 story;wave 与 release 用于组织协调与交付。当一个设计或决策拆分为多个 story 时,应先创建 layer,再创建其变更与 story。显式的依赖关系与关口用于确定工作就绪状态。

决策与调研 在推荐产品优先级、技术方向或基准之前,先识别可能改变选择的证据缺口。若缺口需要调查,可参考 Purpose-driven research(aep --skill roadmap --ref purpose-research)。调研深度取决于决策的不确定性,并应复用充分的现有证据。给出建议时需同时呈现取舍,并邀请用户表达对拟议方向的看法;方向确定后,可在同一任务中用 product-context 参考完成已授权的产品上下文更新。未解决的选择以草稿形式保留,已确定的工作继续推进;仅讨论性质的请求保持其既定边界。

决策记录 在决策中记录取舍与被否决的备选方案,并在任务授权范围内带归属地接受或取代它们。需要时,可继续使用 aep --skill design 解决所选方向的设计与行为契约。维护或调研工作可以独立于产品旅程存在。

进展摘要 生成进展摘要时参考 Status from evidence(aep --skill roadmap --ref status);用 aep check 校验引用,用 aep timeline 检查时序。未知的历史日期保持未知;记录时间表示 AEP 记录该事件的时间。

适用场景 适用于需要持续维护产品路线图、拆分工作项、记录架构决策、追踪交付进展并以证据支撑建议的工程协作场景。

限制 资料未提供具体安装步骤、运行环境要求、定价或平台支持信息,暂未提供。