guide-updater

1
0
Source

将对话中新产生的可复用写作洞见实时沉淀到项目指南文件,保持术语口径一致、结构稳定、可检验与可复现。调用时必须指定指南文件路径。用于用户要求"更新项目指南/同步指南/沉淀洞见到指南"等场景。

Install

mkdir -p .claude/skills/guide-updater && curl -L -o skill.zip "https://mcp.directory/api/skills/download/7156" && unzip -o skill.zip -d .claude/skills/guide-updater && rm skill.zip

Installs to .claude/skills/guide-updater

About this skill

项目指南更新器

与 bensz-collect-bugs 的协作约定

  • 当用户环境中出现因本 skill 设计缺陷导致的 bug 时,优先使用 bensz-collect-bugs 按规范记录到 ~/.bensz-skills/bugs/,严禁直接修改用户本地 Claude Code / Codex 中已安装的 skill 源码。
  • 若 AI 仍可通过 workaround 继续完成用户任务,应先记录 bug,再继续完成当前任务。
  • 当用户明确要求“report bensz skills bugs”等公开上报动作时,调用本地 ghbensz-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/记录结构映射与落点规则,避免反复判断放置位置

complete-example

huangwb8

AI 增强版 LaTeX 示例智能生成器,实现 AI 与硬编码的有机融合。AI 做"语义理解"(分析章节主题、推理资源相关性、生成连贯叙述),硬编码做"结构保护"(格式验证、哈希校验、访问控制)。用于用户要求"填充示例内容/生成示例/补充 LaTeX 示例"等场景。

00

nsfc-bib-manager

huangwb8

NSFC 标书引用与 Bib 管理:新增/核验论文信息(题目/作者/年份/期刊/DOI)并写入 `references/ccs.bib` 或 `references/mypaper.bib`,保证不出现幻觉引用;用于用户要求"加引用/补参考文献/核对论文信息/写bibtex/更新.bib"。

10

nsfc-justification-writer

huangwb8

为科研申请书"立项依据"章节写作/重构 LaTeX 正文内容,基于最小信息表输出价值与必要性、现状不足、科学问题/假说与项目切入点,并保持模板结构不被破坏。适用于 NSFC 及各类科研基金申请书的立项依据写作场景。

20

check-review-alignment

huangwb8

当用户明确要求“核查/优化综述 `{主题}_review.tex` 的正文引用”或“运行 check-review-alignment”时使用。 通过宿主 AI 的语义理解逐条核查引用是否与文献内容吻合,**只在发现致命性引用错误时**对“包含引用的句子”做最小化改写,并复用 `systematic-literature-review` 的渲染脚本输出 PDF/Word(脚本不在本地直接调用 LLM API)。 核心原则:**不为了改而改**。无法确定是否为致命性错误时,保留原样并在报告中警告。 ⚠️ 以下情况不适用: - 用户只是想生成系统综述正文(应使用 systematic-literature-review) - 用户只是想新增/核对 BibTeX 条目(应使用专门的 bib 管理流程)

00

make-latex-model

huangwb8

LaTeX 模板高保真优化器,支持任意 LaTeX 模板的样式参数对齐、标题文字对齐、标题格式对比(加粗)、HTML 可视化报告、LaTeX 自动修复建议和像素级 PDF 对比验证

00

systematic-literature-review

huangwb8

当用户需要做系统综述/文献综述/related work/相关工作/文献调研时使用:AI 自定检索词,多源检索→去重→AI 逐篇阅读并评分(1–10分语义相关性与子主题分组)→按高分优先比例选文→自动生成"综/述"字数预算(70% 引用段 + 30% 无引用段,三次采样取均值)→资深领域专家自由写作(固定摘要/引言/子主题/讨论/展望/结论),保留正文字数与参考文献数硬校验,强制导出 PDF 与 Word。支持多语言翻译与智能编译(en/zh/ja/de/fr/es)。

60

You might also like

flutter-development

aj-geddes

Build beautiful cross-platform mobile apps with Flutter and Dart. Covers widgets, state management with Provider/BLoC, navigation, API integration, and material design.

9521,094

drawio-diagrams-enhanced

jgtolentino

Create professional draw.io (diagrams.net) diagrams in XML format (.drawio files) with integrated PMP/PMBOK methodologies, extensive visual asset libraries, and industry-standard professional templates. Use this skill when users ask to create flowcharts, swimlane diagrams, cross-functional flowcharts, org charts, network diagrams, UML diagrams, BPMN, project management diagrams (WBS, Gantt, PERT, RACI), risk matrices, stakeholder maps, or any other visual diagram in draw.io format. This skill includes access to custom shape libraries for icons, clipart, and professional symbols.

846846

ui-ux-pro-max

nextlevelbuilder

"UI/UX design intelligence. 50 styles, 21 palettes, 50 font pairings, 20 charts, 8 stacks (React, Next.js, Vue, Svelte, SwiftUI, React Native, Flutter, Tailwind). Actions: plan, build, create, design, implement, review, fix, improve, optimize, enhance, refactor, check UI/UX code. Projects: website, landing page, dashboard, admin panel, e-commerce, SaaS, portfolio, blog, mobile app, .html, .tsx, .vue, .svelte. Elements: button, modal, navbar, sidebar, card, table, form, chart. Styles: glassmorphism, claymorphism, minimalism, brutalism, neumorphism, bento grid, dark mode, responsive, skeuomorphism, flat design. Topics: color palette, accessibility, animation, layout, typography, font pairing, spacing, hover, shadow, gradient."

571699

godot

bfollington

This skill should be used when working on Godot Engine projects. It provides specialized knowledge of Godot's file formats (.gd, .tscn, .tres), architecture patterns (component-based, signal-driven, resource-based), common pitfalls, validation tools, code templates, and CLI workflows. The `godot` command is available for running the game, validating scripts, importing resources, and exporting builds. Use this skill for tasks involving Godot game development, debugging scene/resource files, implementing game systems, or creating new Godot components.

548492

nano-banana-pro

garg-aayush

Generate and edit images using Google's Nano Banana Pro (Gemini 3 Pro Image) API. Use when the user asks to generate, create, edit, modify, change, alter, or update images. Also use when user references an existing image file and asks to modify it in any way (e.g., "modify this image", "change the background", "replace X with Y"). Supports both text-to-image generation and image-to-image editing with configurable resolution (1K default, 2K, or 4K for high resolution). DO NOT read the image file first - use this skill directly with the --input-image parameter.

673466

fastapi-templates

wshobson

Create production-ready FastAPI projects with async patterns, dependency injection, and comprehensive error handling. Use when building new FastAPI applications or setting up backend API projects.

514280

Stay ahead of the MCP ecosystem

Get weekly updates on new skills and servers.