用途:将混乱的高层目标转化为清晰的 Intake Brief,暴露假设、防止需求在推进中悄然偏移。该技能产出的是清晰度,而非实现方案。
主要能力与硬性要求:以只读模式运行,不修改文件;通过提问消除高影响歧义;不掩盖未知项,而是记录它们;不输出计划、不提出架构,只输出 Intake Brief。
工作流程: 1)最小上下文扫描(若在仓库中):浏览 README、docs,以及 AGENTS/ARCHITECTURE/ROADMAP/CALIBRATION(若存在);检查 REPO_PROFILE.json,若存在则将其视为技术栈与工具链的权威来源,不再重复询问相关问题;识别约束、当前架构形态与不可妥协项。 2)访谈(有界):最多提 10 个问题,优先多选,只问对设计有实质影响的内容。问题分组包括目标(成果、使用者、成功标准)、约束(时间线、技术、安全/风险、性能/可靠性)、接口(输入输出、集成、API、数据存储)、不变量(必须始终成立、绝不能发生)、范围边界(明确排除项)。避免询问 REPO_PROFILE.json 已回答的工具问题。 3)按模板输出 Intake Brief,包含:Objective、Users(Primary/Secondary/Non-users)、Success metrics、Constraints(Technical/Operational/Risk-safety)、Functional requirements (v1)、Non-functional requirements(Performance/Reliability/Observability)、Assumptions register(含 confidence 与 impact 等级)、Open questions(标注 blocking/non-blocking)、Out of scope (v1)、Recommended next step。
推荐下一步:若缺少仓库脚手架,使用 $bootstrap-repo;若仓库存在但 profile/治理需调整,使用 $personalize-repo;若需求已清晰、下一步是执行,使用 $create-plan。
适用场景:新系统或重大功能启动前的需求澄清阶段。限制:不产出计划或代码,不修改文件;具体收费、平台支持等信息暂未提供。