Sus Inventory 是 Suspec 技能集中的一个技能,定位为对代码库现状进行持久化映射,其口号是「Map reality. Invent nothing. Prescribe nothing.」(映射现实,不臆造,不开处方)。
用途
该技能用于把一个不熟悉或变更敏感的代码区域映射为持久的当前状态(durable current state)。当大范围变更缺乏经过验证的图谱时使用。它明确不用于直接实现(direct implementation)、范围狭窄的任务等。进入方式为显式的 inventory 请求,或由人选择 Suspec inventory 工作流以获得持久的当前状态映射。
交互方式
通过原生选择器(native picker)提出必需问题,或使用编号选项加 Other。推荐项放在最前;提供三个真实选项,二选一时给两个;每个选项给出一个朴素理由和成本。
方法
- 将范围与排除项锁定到即将进行的变更。
- 列出当前模块:路径、观察到的职责、证据。
- 列出当前接口:签名或表面、直接和动态调用方、观察到的契约、证据。
- 用测试、file:line 或决定性命令输出记录外部可见行为。
- 映射数据、状态、副作用、持久化、生成表面、配置和外部消费者。
- 列出既有测试以及每个测试实际控制的行为。
- 暴露未知项,给出精确的搜索边界和缺失证据;若没有发现,写明 None found 以及检查过的边界。
- 搜索调用方和字符串注册;对动态断言运行安全的检查;零调用方和无匹配的结论必须给出命令和结果。每句话都必须满足:这存在;它这样表现;这是证据。任何不熟悉或危险的代码路径,在断言其行为之前都要追踪到闭合。
产物
将 ~/.agents/artifacts/<workspace>/ 解析为绝对路径;<workspace> 从仓库或工作目录的 basename 派生。在那里写入,带 type: inventory、唯一的 INV- ID,并在旁边写链接的 sidecar。发生碰撞或工作区有歧义时,提供人类可读的名称选项。写入受阻时,提供授权并重试、另选一个 agent 中立用户目录,或取消。绝不覆盖,也不回退到仓库、vendor 目录或临时路径。
写入的本地源引用相对于产物;仅运行时交接使用绝对路径。
起始内容为:
type: inventory id: INV-{{slug}}
输出
在交接前,削减重复、软化、仪式感和结构性膨胀,但不改变契约、标识符、逐字源文本、证据或行为。重新运行适用的检查。仅返回 inventory 及每个 sidecar 的可点击 Markdown 链接,使用紧凑的 ~/.agents/... 标签和完全展开的绝对目标。仅解释阻塞、创建失败、验证不完整或不可逆操作的确认。
边界
将范围上的实质性歧义强制转为显式的人工选择,选择前阻塞映射。剥离严重性、处方、目标架构和实现步骤。
关闭
一旦完全落实且没有下游步骤需要它,需要一个人工处置决定,针对产物及其 sidecar:Delete、Leave 或 Promote。Promote 把临时材料移动到项目自有的永久位置。删除每个选中的路径并验证不存在;有残留则阻塞关闭。