name: f2s-kb-rm description: 删除某 stock-docs 文档对应的知识主题与索引映射;触发:删除项目上下文、f2s-kb-rm
执行口径:仅维护
.Knowledge,不改配置根rules/skills。
编排(主 / 子 agent)
- 两字段(
subAgent/switchAgentVerification)语义以统一入口为唯一事实源:Cursor/Claude 读配置根rules/f2s-flow2spec-unified-entry.*;Codex 读.codex/topics/f2s-flow2spec-unified-entry.md(与上同源,flow2spec init镜像)。不在此复述。 - 默认主 agent 全流程执行(单点删除拆子收益低)。
- 拆子阈值:仅当
subAgent=true且批量删除一次 ≥ 5 主题时,才拆子执行删除与清引用。 - 主必控:范围确认、
fallbackTopic重指。 - 写权硬约束:
manifest-routing.json与.Knowledge/index.md恒由主 agent 落盘。 - 验证:默认落盘侧自验;本 SKILL 不绑定交叉校验。
删除文档对应的项目上下文
输入
- 一个参数:
.Knowledge/stock-docs/<文件名>.md路径,或可匹配文件名片段。
执行步骤
- 读取
.Knowledge/index.md,匹配目标文档相关主题。 - 删除对应
.Knowledge/topics/<topic>.md文件。 - 从
.Knowledge/index.md移除匹配项并写回。 - 更新路由清单:
.Knowledge/manifest-routing.json:移除失效topicPaths、taskToTopicRules、topicDependencies、topicMetadata引用- 对应
matchers/<matcherId>.json:移除失效规则或includeAny词条(与已删task/matcherId对齐) - 若删除了
fallbackTopic,必须指定新的兜底主题 - 创作侧准则:本步会调整
topicDependencies(删除被依赖主题或孤儿边),须先 Readrules/f2s-topic-authoring.*全文(Cursor/Claude:rules/f2s-topic-authoring.mdc;Codex:.codex/topics/f2s-topic-authoring.md),核对 DAG 与最小化约束后再落盘。
输出摘要(必须)
- 已删除的 topic 文件列表
.Knowledge/index.md删除的条目- 路由清单调整的字段
- 未执行项(若有)
复杂场景示例
用户输入文件名片段「回调」,匹配到 2 个主题文档。
- 先列出两个候选并要求用户确认删除范围,避免误删。
- 删除后同步清理路由清单失效引用;若删到了
fallbackTopic,必须先指定新的兜底主题再落盘。 - 最终摘要中写清:删除了哪些 topic、保留了哪些 topic、为什么。
约束
- 匹配多义时先询问用户确认。
- 仅删除命中主题,不影响其它主题。
manifest-routing.json与.Knowledge/index.md恒由主 agent 落盘(写权硬约束);范围确认与fallbackTopic重指不可下放给子 agent。
完成后自检
- 被删 topic 是否仍被
manifest引用(必须为否)。 index是否仍存在失效主题路径(必须为否)。topicMetadata是否仍引用已删除 topic(必须为否)。fallbackTopic是否仍有效。- 未在低于拆子阈值(< 5 主题)时强行拆子;manifest / index 由主单点落盘。