用途:当用户问“这个仓库接下来该做什么”“什么值得做”时,在单个仓库内做审计式的高级判断,发现值得规划的工作,而不是只给用户已列出的想法排序。标准产品/发布路线图应使用普通 roadmap 技能。
主要能力:挖掘仓库文档(AGENTS.md、README.md、CONTEXT.md、架构文档、ADR、旧计划、路线图文件)、活跃分支/书签与相关 issue 笔记;按正确性、安全、性能、测试覆盖、技术债与架构、依赖与迁移、DX 与工具、文档、方向等类别审计;扩展用户种子想法并生成非显而易见的改进机会;对机会做证据核验、价值筛选与杠杆排序;记录被拒绝与暂不做的项;区分“值得修的问题”与“值得考虑的方向选项”;按风险校准自主性边界。
使用方式:先确定仓库范围与“更好”的成功标准,若目标不清则先提一个简短问题;只读侦察,不修改源码,只写路线图产物;对每个排序项亲自打开所引用的代码、计划或产物核验,子代理输出与旧计划只作线索;按 references/roadmap-template.md 写入 .agents/ROADMAP.md(目录不存在则创建),优先用 Now/Next/Later 而非虚构日期;每项须指明下一步产物(roadmap-to-improve-plans、feature-planning-artifacts、研究/spike、用户决策、推迟或放弃);架构项需给出推荐强度(Strong、Worth exploring、Speculative)。
适用场景:仓库级机会发现、技术债优先级、架构优先级、旧计划打捞、退役过时工作、建立常设策略/ADR/评估/计划模板等能改善未来工作循环的系统升级。
限制:不产出实现步骤,不估算工作量(除非用户明确要求),不在路线图阶段设计最终接口;不编造兼容层;若出现凭据或密钥,只引用文件路径、行号与凭据类型,绝不复制密钥值;须说明未审查范围,不暗示全仓覆盖;若仓库过大,先提一个收窄问题或建议有界首轮;若用户给出多个仓库,则每仓一份路线图或先问从哪个开始。