用途:在用户明确要求“更新项目指南”“同步指南”“沉淀洞见到指南”时,把对话中新产生的可复用写作洞见写入项目指南文件,保持术语口径一致、结构稳定、可检验与可复现。必须指定指南文件路径。
使用方式:命令形式 /guide-updater --guide-path <路径>,或自然语言如“更新项目指南(路径:projects/MyProject/项目指南.md)”。
主要流程:先自检,不新增 ## 级标题,不改动既有标题文本、编号与顺序;把用户表述拆成只含一个主张的“原子洞见”,每条附一句写进指南的目的;按内容选择落点(写作哲学、命名与术语、基本原理、文献综述与创新性、落点清单、评审问答、研究风险、附录),不确定时先问用户;以最小补丁写入,只新增 1—3 条 bullet 或在既有条目末尾补充;更新后运行 python skills/guide-updater/scripts/validate_guide.py <指南文件路径> 校验,并确认未意外新增 ## 级标题。需要更细落点规则时读 skills/guide-updater/references/guide-structure-map.md。
限制:涉及事实或文献只写可核验信息,无法核验标注“待核验”,不编造细节。若本 skill 缺陷导致 bug,应按约定用 bensz-collect-bugs 记录到 ~/.bensz-skills/bugs/,不直接改已安装的 skill 源码;如可绕过,先记录再继续任务。公开上报仅上传新增 bug,不 clone 整个仓库。其他收费、平台或效果信息暂未提供。