用途:implementation-discovery 是 agentic-workflow 中一个内部契约型技能,是受约束的、只读的“写入前实现发现”步骤的唯一权威负责者,供 execute-phase 使用。在完成只读的依赖/状态/验收/阶段/feature-28 凭据检查之后、进行任何分支、规划或源码写入之前运行。它只走预写路径,不是通用定位步骤,也不替代规划。
输入:仅接收当前阶段的 SPEC/修复义务、当前 feature-28 的 SPEC 与 Plan 凭据摘要、冻结规划证据中与阶段相关的行(含来源修订、受影响的决策/义务、新鲜度与已声明未知项)、阶段指纹、有序任务、验收/义务 id 与上次进度凭据、源码 HEAD 及干净源码/允许规划路径证据、适用的 NRS/决策/不变量证据,以及环境中的仓库发现工具。语义/符号导航与记忆工具只是可选适配器,仅为加速定位,永不构成权威;直接使用仓库/Git/搜索/读取/测试的兜底路径必须满足同一证据契约。
主要能力:每次执行必须回答七个证据问题——哪些入口与接口拥有当前行为;本阶段可影响哪些调用方、适配器、角色、兼容面与失败路径;哪些辅助、模式、决策与不变量约束改动;哪些测试、夹具、探针与类生产场景确立当前行为;预期哪些写入及各自服务哪项已审义务;携带的规划证据与 Plan 假设被证实、细化、过期、缺失还是被源码反驳;仍有哪些未知项、由谁负责、用什么证据解决。产出固定结构的 IMPLEMENTATION MAP,包含映射修订号、来源身份、权威、规划证据、义务、入口、受影响面、当前行为、复用与约束、预期写入、验证、Plan 假设、矛盾、未知项与决定。
使用方式与裁定:结论只有四种。READY 要求所有字段、问题与所辖义务覆盖完整,无实质矛盾或未知,观察到证伪探针,预期写入在阶段权威内,且每条携带的规划证据行均被确认或狭窄细化。REPLAN 表示源码反驳工程假设但产品稳定,或 Plan 层拓扑/架构/义务/验证器证据缺失。NEEDS-DESIGN 表示产品、验收、权威或架构意图缺失或冲突。BLOCKED 指明当前无法获得的证据。裁定只负责路由,不负责修复:Plan 层缺陷回 plan-feature/plan-fix 加新的 review-plan;产品/验收/权威/架构缺口回 design-feature 再 review-spec。
内联与全新路由:仅当行为局部且熟悉、定向证据可回答全部问题、不触及公共/持久化/安全/恢复/兼容边界,且执行者能在写入前完成映射时才允许内联。跨模块/跨层、不熟悉工作、影响公共/持久化/安全/恢复/兼容、存在竞争性项目模式、未证实的重大 Plan 假设、先前失败尝试或评审偏见,以及编辑会在映射关闭前开始的情形,都需要全新的只读映射器。不存在文件数量阈值参与路由或裁定。
限制:映射器只读,不得写入,不创建 forge 问题、已提交映射、规划单元、模式、源码或测试编辑;不判断代码正确性。READY 为一次性消费,首次实现写入即消耗它。再次读取或搜索需要新问题、来源变化或引用证据不足,否则以 BLOCKED 停止。缺失的当前单元行为若由已评审范围蕴含,则加入义务映射并路由上游,不作为跟进问题、也不调用 forge。可移植回退使用顺序的全新对话并精确绑定工件/来源,不得声称其无法产生的机器凭据或持久保证。有关具体命令、配置和更多细节,资料暂未提供。