SuperAPI AI 工具集

slice

通用与其它

查看项目

更新于 10-16 00:20

技能介绍

用途:当出现改代码意图、且尚无治理切片时,Slice 用于把意图转化为具体、有范围的变更单元。切片是一个连贯的变更,不等同于项目全局决策(ADR),也不等同于长期规格材料(.doctrine/spec/)。

主要能力:先确认前提并拉取约束,包括用 /canon 获取 ADR、.doctrine/spec/tech/ 与约定,用 /retrieve-memory 获取将触及子系统的注意事项。随后创建切片:doctrine slice new "<title>" [--slug <slug>],分配下一个 id,并生成 slice-nnn.toml(元数据、关系、生命周期状态,初始为 proposed)与 slice-nnn.md(范围文档)。

范围文档需写明:改什么与为什么;范围内与范围外(明确边界);受影响表面(具体路径/模块);风险、假设、未决问题;验证与关闭意图,即如何判定“完成”。同时可粗粒度登记范围相关选择器,例如 doctrine slice selector add <id> "src/foo/**" "src/bar.rs" --intent scope-relevant,这些选择器故意宽松,精确触及集合由 /design 负责,并用于审计时的切片一致性差异比对。

使用方式:在 slice-nnn.toml 中记录结构与生命周期状态;结构化数据写入 TOML,叙述性内容写入 MD。关系应通过 doctrine link 写入,而非手写行,以依据 RELATION_RULES 验证,例如 governed_by、specs、supersedes。若实际是项目全局决策,应使用 doctrine adr new;若是长期规格,应写技术规格(doctrine spec new tech)或产品规格(doctrine spec new product)。

限制与后续:切片应保持为一次可交付的变更,过大则拆分。必须先设计再规划:记录状态变更 doctrine slice status <id> design,并交给 /design;/route 的门禁禁止从裸切片直接跳到 /plan 或 /execute。存在真实权衡或未知时使用 /consult;设计前按 /research 做研究轮,使设计基于有引用的产物。