Agent skill
guide-updater
当用户明确要求"更新项目指南""同步指南""沉淀洞见到指南"时使用。将对话中新产生的可复用写作洞见实时沉淀到项目指南文件,保持术语口径一致、结构稳定、可检验与可复现。调用时必须指定指南文件路径。
Install this agent skill to your Project
npx add-skill https://github.com/huangwb8/ChineseResearchLaTeX/tree/main/skills/guide-updater
Metadata
Additional technical details for this skill
- author
- Bensz Conan
- keywords
-
项目指南 写作洞见 知识沉淀 术语一致 指南更新
- triggers
-
[ "\u66f4\u65b0\u9879\u76ee\u6307\u5357", "\u540c\u6b65\u6307\u5357", "\u6c89\u6dc0\u5230\u6307\u5357", "guide updater" ] - short description
- 项目指南实时更新器
SKILL.md
项目指南更新器
与 bensz-collect-bugs 的协作约定
- 当用户环境中出现因本 skill 设计缺陷导致的 bug 时,优先使用
bensz-collect-bugs按规范记录到~/.bensz-skills/bugs/,严禁直接修改用户本地 Claude Code / Codex 中已安装的 skill 源码。 - 若 AI 仍可通过 workaround 继续完成用户任务,应先记录 bug,再继续完成当前任务。
- 当用户明确要求“report bensz skills bugs”等公开上报动作时,调用本地
gh与bensz-collect-bugs,仅上传新增 bug 到huangwb8/bensz-bugs;不要 pull / clone 整个 bug 仓库。
将对话中新产生的可复用写作洞见实时沉淀到项目指南文件,保持术语口径一致、结构稳定、可检验与可复现。
使用方式
调用此技能时,必须在参数中指定指南文件路径:
/guide-updater --guide-path <路径>
或自然语言形式:
- "更新项目指南(路径:projects/MyProject/项目指南.md)"
- "把这些内容同步到指南文件 docs/写作指南.md"
先决条件
每次更新前快速自检:
- 不新增新的
##级标题;只在既有小节/列表中"融入"新增要点。 - 不改动既有标题文本、编号、顺序;不为"整理美观"重排大量内容。
- 新增内容默认写成 1 条或少量 bullet,紧贴相邻条目的写法与语气。
- 涉及事实/文献:只写可核验信息;无法核验则标注"待核验",不要编造详细信息。
抽取"原子洞见"
- 将用户表达拆成若干条"可落笔"的要点,每条只包含一个主张/规则/写法。
- 为每条要点附 1 句"写进指南的目的"(例如:统一口径/防评审质疑/可复现/风险控制)。
选择融入位置
- 需要更细的落点规则时,先读
skills/guide-updater/references/guide-structure-map.md再动手。 - 写作原则/禁区/句式 →
## 写作哲学 - 术语、缩写、大小写、核心概念定义 →
## 命名与术语 - 方法链条、验证口径、评估指标 →
## 基本原理 - 范式定位、对照坐标系、差异化要点 →
## 文献综述与创新性 - 具体写到哪一节(文档结构映射) →
## 落点清单 - 评审问答口径 →
## 评审专家可能的问题及回答 - 风险与对策 →
## 研究风险 - "可核验事实锚点"(源码、参数、流程) →
## 附录
不确定放哪:优先放到"最能减少未来写作返工"的位置;仍不确定就先问用户"更希望作为写作哲学/技术路线/风险控制哪一类沉淀?"再改文件。
以最小补丁写入
- 只做"增量补丁":新增 1--3 条 bullet 或在既有 bullet 末尾补 1 句澄清。
- 不新开大段长文;如果洞见很大,先拆成多个 bullet 分散落在对应小节。
- 与已有术语保持一致(参考项目既有术语表)。
更新后校验
- 运行
python skills/guide-updater/scripts/validate_guide.py <指南文件路径>(或手动确认关键##标题仍存在)。 - 搜索是否意外新增
##级标题或引入"另起炉灶"的新结构。
Resources
| 目录 | 用途 |
|---|---|
scripts/ |
校验 项目指南.md 是否保持关键结构与必要标题 |
references/ |
记录结构映射与落点规则,避免反复判断放置位置 |
Recommended Agent Skills
Expand your agent's capabilities with these related and highly-rated skills.
systematic-literature-review
当用户明确要求"做系统综述/文献综述/related work/相关工作/文献调研"时使用。AI 自定检索词,多源检索→去重→AI 逐篇阅读并评分(1–10分语义相关性与子主题分组)→按高分优先比例选文→自动生成"综/述"字数预算→资深领域专家自由写作(固定摘要/引言/子主题/讨论/展望/结论),保留正文字数与参考文献数硬校验,强制导出 PDF 与 Word。支持多语言翻译与智能编译(en/zh/ja/de/fr/es)。
nsfc-humanization
去除 NSFC 标书中的 AI 机器味,使文本读起来像资深领域专家亲笔撰写(不适用:非标书内容/需修改格式/需补充新内容)
nsfc-research-foundation-writer
nsfc-research-content-writer
当用户明确要求"写/改研究内容""研究内容+创新+年度计划编排"时使用。为 NSFC 正文"(二)研究内容"写作/重构,并同步编排"特色与创新"和"三年年度研究计划",输出可直接落到 LaTeX 模板的三个 extraTex 文件。
nsfc-qc
当用户明确要求"标书QC/质量控制/润色前质检/引用真伪核查/篇幅与结构检查"时使用。对 NSFC 标书进行只读质量控制:并行多线程独立检查文风生硬、引用假引/错引风险、篇幅与章节分布、逻辑清晰度等,最终输出标准化 QC 报告;中间文件默认归档到“交付目录内的隐藏工作区(.nsfc-qc/)”,并兼容 legacy `.nsfc-qc/`。
nsfc-code
根据 NSFC 标书正文内容,结合申请代码推荐库,为你给出 5 组申请代码1/2(主/次)推荐与理由;输出到 NSFC-CODE-vYYYYMMDDHHmm.md(只读,不修改标书)
Didn't find tool you were looking for?