sus-inventory 是一个以“绘制现实、不发明、不规定”为原则的技能,用于把陌生或变更关键的代码区域整理成持久的当前状态地图。其触发条件为显式请求 inventory,或人工选择 Suspec inventory 工作流并获得持久现状地图的需求。
用途与适用范围:当大范围变更缺乏经过验证的地图时使用;不用于直接实现、窄范围任务或其他不适用场景。
使用方式:通过原生选择器或编号选项加 Other 提出必需问题,建议优先给出推荐项,提供三个真实选项(二元时两个),每个选项说明理由和成本。锁定与即将到来的变更相关的范围和排除项。
主要能力:列出当前模块(路径、观察到的职责、证据);列出当前接口(签名或表面、直接和动态调用方、观察到的契约、证据);用测试、file:line 或决定性命令输出记录外部可见行为;映射数据、状态、副作用、持久化、生成表面、配置和外部消费者;列出已有测试及每个测试实际控制的行为;暴露未知项并给出精确搜索边界和缺失证据,若无则声明 None found 及已检查边界;搜索调用方和字符串注册,对动态断言运行安全检查,零调用方和无匹配结论必须附命令与结果;每句话须满足“存在、如此行为、证据在此”;对陌生或危险代码路径追踪至闭合后再声明其行为。
产物与交接:将 ~/.agents/artifacts/<workspace>/ 解析为绝对路径,<workspace> 取自仓库或工作目录基名;写入 type: inventory、唯一 INV- ID 及相邻旁车文件;冲突或工作区不明确时提供人类可读名称选项;写入受阻时提供授权重试、另一个代理中立的用户目录或取消。禁止覆盖或回退到仓库、vendor 目录或临时路径。本地源引用相对产物,仅运行时交接使用绝对路径。交接前删减重复、软化、仪式和结构膨胀,不改变契约、标识符、逐字源文本、证据或行为,重跑适用检查,仅返回可点击 Markdown 链接及紧凑 ~/.agents/... 标签和完整绝对目标。仅解释阻塞、创建失败、验证不完整或不可逆操作确认。
限制与边界:材料性范围歧义必须强制进入人工选择,选择前阻止映射;剥离严重性、处方、目标架构和实施步骤;完成且无下游步骤需要时,要求人工对产物及旁车做一次处置:Delete、Leave 或 Promote,Promote 将临时材料移入项目自有永久位置,Delete 需删除每个选定路径并验证不存在,幸存者阻止关闭。