用途:引导相关方通过结构化对话,梳理并记录命令行工具、REST/HTTP API 或两者兼顾的功能需求与技术决策,最终产出 ADR 文档。ADR 是对话结果的记录,而非对话本身。
主要能力:识别项目面向 CLI、REST/HTTP API 还是两者;收集初始背景(目的、用户/消费方、约束、时间线、负载);梳理各表面的功能需求(工作流、输入输出、资源、错误);记录技术决策,包括语言/框架,以及 REST 相关块(API 设计、鉴权、数据、基础设施、测试/监控)或 CLI 相关块(架构、数据/集成、测试/分发);在生成 ADR 前进行决策综合与确认。
使用方式:技能会先运行 date 获取准确时间戳;读取参考模板(references/031-architecture-adr-functional-requirements.md)并从项目上下文推断 CLI/API 范围,不清晰时提一个简短澄清问题;随后每次只问一到两个问题,逐步构建并验证答案;在提议生成 ADR 前先向用户确认摘要,得到用户明确确认后再生成 ADR 文档并给出简要下一步。
触发场景:为功能需求创建 ADR、记录功能需求、捕获功能需求、在 ADR 中生成功能需求。
限制:必须使用对话式发现,每次只问一两个问题,不得一次性抛出全部问题;必须使用最新读取的参考模板而非缓存问题;必须先与用户验证摘要;必须等待用户确认才能生成 ADR;开始前必须运行 date。适用范围限于 CLI 与 REST/HTTP API 功能需求相关决策。