用途:通过结构化对话引导相关方梳理并记录命令行工具、REST/HTTP API 或两者组合的技术决策与功能需求,最终产出架构决策记录(ADR)。ADR 是对话的文档化结果,而非对话本身。
主要能力:发现并确认接口范围(CLI、REST/HTTP API 或两者);收集初始上下文(目的、用户/消费者、约束、时间线,API 场景下的负载);梳理功能需求(各接口的工作流、输入输出、资源、错误);记录技术决策,包括语言/框架,REST 相关块(API 设计、认证、数据、基础设施、测试/监控)和/或 CLI 相关块(架构、数据/集成、测试/分发);在生成 ADR 前进行决策综合与验证;生成 ADR 文档并给出后续步骤。
使用方式:先运行本地 shell 的 date 命令获取准确时间戳;加载本技能捆绑的 references/031-architecture-adr-functional-requirements.md 参考模板;从当前工作区推断 CLI 或 API 范围,不明确时提一个简短澄清问题;以小批量方式每次提一两个发现性问题,基于回答逐步推进;在提议生成 ADR 前,用“这是否准确反映了你的需求?”向用户验证摘要;等待用户明确确认后再生成 ADR。
适用场景:为功能需求创建 ADR、记录或捕获功能需求、在 ADR 中生成功能需求、决定 ADR 中 CLI 与 REST 的功能需求范围。
限制:仅使用当前对话和当前会话中明确可用的仓库文件;忽略先前会话内容,除非用户再次提供;必须使用对话式发现,不得一次性提出所有问题;必须验证摘要并等待用户确认后才能生成 ADR;必须加载捆绑参考模板。资料未提供具体安装命令、收费或平台信息。