| 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(删除被依赖主题或孤儿边),须先 Read rules/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 由主单点落盘。