guide-updater
将对话中新产生的可复用写作洞见实时沉淀到项目指南文件,保持术语口径一致、结构稳定、可检验与可复现。调用时必须指定指南文件路径。用于用户要求"更新项目指南/同步指南/沉淀洞见到指南"等场景。
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.zipInstalls 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”等公开上报动作时,调用本地
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/ | 记录结构映射与落点规则,避免反复判断放置位置 |
More by huangwb8
View all skills by huangwb8 →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.
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.
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."
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.
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.
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.
Stay ahead of the MCP ecosystem
Get weekly updates on new skills and servers.