跳到正文
cccskills
免费在 GitHub 公开

research-guide-updater

Capture reusable writing decisions from a conversation in an existing project guide. The skill turns insights into a few focused rules, places them in appropriate sections, and preserves established headings, terminology, numbering, and order.

中文简介正在准备中。当前显示英语简介。

原文查看原文说明

当用户明确要求"更新项目指南""同步指南""沉淀洞见到指南",或要求使用旧名 guide-updater skill 时使用。将对话中新产生的可复用写作洞见实时沉淀到项目指南文件,保持术语口径一致、结构稳定、可检验与可复现。调用时必须指定指南文件路径。

实测评分 未实测

查看安装方法

适用场景

  • Record writing decisions agreed during a conversation
  • Add terminology and abbreviation rules to a project guide
  • Document reviewer responses and research risk measures

包含的文件(6)

  • SKILL.md5.9 KB
  • CHANGELOG.md363 B
  • config.yaml761 B
  • README.md10.8 KB
  • references/guide-structure-map.md1.5 KB
  • scripts/validate_guide.py1.8 KB

SKILL.md(原文)

安装前可以查看交给 AI 代理的指令内容。

项目指南更新器

先决条件

每次更新前快速自检:

  • 不新增新的 ## 级标题;只在既有小节/列表中"融入"新增要点。
  • 不改动既有标题文本、编号、顺序;不为"整理美观"重排大量内容。
  • 新增内容默认写成 1 条或少量 bullet,紧贴相邻条目的写法与语气。
  • 涉及事实/文献:只写可核验信息;无法核验则标注"待核验",不要编造详细信息。

流程

输入

按用户请求和配置文件提供必要输入;缺失信息应明确列出并停止依赖该输入的步骤。

执行步骤

  • 当用户环境中出现因本 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 仅作为 prompt 兼容别名保留;安装新版本时系统级旧目录会被清理。

调用此技能时,必须在参数中指定指南文件路径:

/research-guide-updater --guide-path <路径>

或自然语言形式:

  • "更新项目指南(路径:projects/MyProject/项目指南.md)"

  • "把这些内容同步到指南文件 docs/写作指南.md"

  • 将用户表达拆成若干条"可落笔"的要点,每条只包含一个主张/规则/写法。

  • 为每条要点附 1 句"写进指南的目的"(例如:统一口径/防评审质疑/可复现/风险控制)。

  • 需要更细的落点规则时,先读 skills/research-guide-updater/references/guide-structure-map.md 再动手。

  • 写作原则/禁区/句式 → ## 写作哲学

  • 术语、缩写、大小写、核心概念定义 → ## 命名与术语

  • 方法链条、验证口径、评估指标 → ## 基本原理

  • 范式定位、对照坐标系、差异化要点 → ## 文献综述与创新性

  • 具体写到哪一节(文档结构映射) → ## 落点清单

  • 评审问答口径 → ## 评审专家可能的问题及回答

  • 风险与对策 → ## 研究风险

  • "可核验事实锚点"(源码、参数、流程) → ## 附录

不确定放哪:优先放到"最能减少未来写作返工"的位置;仍不确定就先问用户"更希望作为写作哲学/技术路线/风险控制哪一类沉淀?"再改文件。

  • 只做"增量补丁":新增 1--3 条 bullet 或在既有 bullet 末尾补 1 句澄清。
  • 不新开大段长文;如果洞见很大,先拆成多个 bullet 分散落在对应小节。
  • 与已有术语保持一致(参考项目既有术语表)。
目录用途
scripts/校验 项目指南.md 是否保持关键结构与必要标题
references/记录结构映射与落点规则,避免反复判断放置位置

输出

输出 Skill description 所承诺的交付物,并明确格式、路径和失败返回形式。

输出管理

本 Skill 的新任务中间文件统一写入 ./.bensz-api/task-{yyyymmdd-hhmm}-{简短描述}/{skill名}/input|output|log/。同一任务复用一个任务根目录;多 Skill 协作才创建 shared/。正式交付物不写入该目录,历史隐藏目录只允许显式兼容读取、迁移或清理。

校验

  • 运行 python skills/research-guide-updater/scripts/validate_guide.py <指南文件路径>(或手动确认关键 ## 标题仍存在)。
  • 搜索是否意外新增 ## 级标题或引入"另起炉灶"的新结构。

失败与恢复

保留错误证据和已完成产物;仅在输入、环境或外部依赖恢复后从最近的失败步骤重试。

约束

遵守以下公共约束,并执行本 Skill 的专属边界。

公共硬约束

  • 任务需要落盘时,使用唯一的 ./.bensz-api/task-{yyyymmdd-hhmm}-{简短描述}/ 根目录;共享材料放入 shared/,Skill 专属材料放入该 Skill 的 input/、output/、log/。
  • 正式交付物、源代码和正式计划按项目约定保存,不写入任务工作区;未经授权不覆盖、删除、迁移或远程写入。
  • 项目维护变更检查 BAC 可用性并记录需求、AI 产出、工具结果、文件改动和验证摘要;BAC 只做过程审计,不替代署名、责任或合规判断。
  • 不记录 API Key、访问令牌、密码、Cookie、环境/凭据文件、私有 Prompt、身份信息、本地用户名、主机名或不必要的大体积原始数据。
  • 文件路径必须规范化并限制在授权项目范围内;外部 URL、子进程和网络访问遵循最小权限,防止路径遍历、SSRF 和命令注入。
  • Skill 版本唯一记录在自身 config.yaml:skill_info.version;公开 API、协议、目录或配置变更同步文档与 CHANGELOG.md。
  • 仅将 Skill 或 Bensz 基础设施本身的设计缺陷交给 bensz-collect-bugs;先脱敏写入 ~/.bensz-skills/bugs/,当前任务不中断,只有用户明确要求才公开上报,禁止直接修改用户已安装的 Skill 源码。
<!-- End of canonical common constraints. -->

Skill 专属约束

不得超出本 Skill description 和上方流程所声明的范围;不将未验证的信息伪装成确定结论。

评价

还没有评价。欢迎分享你的使用感受。

评论

无需登录即可发表。欢迎分享使用感受、提问,或说明在哪些环境下无法运行。

还没有评论。来写第一条吧。

提交后会立即公开。请勿填写邮箱、电话等个人信息。URL 最多 2 个。

0 / 1000 字

此表单受 reCAPTCHA 保护,适用 Google 的隐私权政策和服务条款。

同一仓库的技能

Fill existing LaTeX projects with sample sections, tables, and explanatory text based on chapter topics and available figures, code, and references. Preview or apply the content while checking formatting and protecting the template structure.

中文简介正在准备中。当前显示英语简介。

  • Adding sample chapters to a thesis template
  • Creating example text around existing figures and tables
  • Previewing sample content before applying it
huangwb8/ChineseResearchLaTeX29662026年10月18日 更新

Refine application, paper, thesis, and CV templates in ChineseResearchLaTeX. Compare layouts with reference PDFs, adjust headings and styles at the appropriate project or shared package level, and validate changes through the designated build tools.

中文简介正在准备中。当前显示英语简介。

  • Matching a template to a reference PDF
  • Adjusting heading layout and line breaks
  • Checking affected templates after shared style changes
huangwb8/ChineseResearchLaTeX29662026年10月18日 更新

Draft or refine Chinese abstracts for NSFC research funding applications and produce faithful English translations. Organize the scientific question, preliminary evidence, planned work, and significance, with character checks and bilingual title suggestions accompanied by reasons.

中文简介正在准备中。当前显示英语简介。

  • Drafting Chinese and English funding application abstracts
  • Translating a Chinese abstract faithfully into English
  • Shortening abstracts to meet character limits
huangwb8/ChineseResearchLaTeX29662026年10月18日 更新

Create an NSFC research grant budget justification from proposal materials. Connect expenses to research tasks, explain calculations and necessity, check amount consistency, and deliver an editable LaTeX project together with budget.pdf.

中文简介正在准备中。当前显示英语简介。

  • Draft an NSFC grant budget justification
  • Explain expenses in relation to research tasks
  • Check budget totals and narrative consistency
huangwb8/ChineseResearchLaTeX29662026年10月18日 更新

nsfc-code

免费

Read an NSFC research proposal and compare it with a code recommendation library to suggest five primary and secondary application code pairs. Receive a Markdown report explaining each choice without changing the proposal.

中文简介正在准备中。当前显示英语简介。

  • Choosing application codes for an NSFC proposal
  • Comparing five primary and secondary code pairs
  • Reviewing code choices against research methods
huangwb8/ChineseResearchLaTeX29662026年10月18日 更新

Draft, restructure, or polish the section explaining why a research grant project is needed. Connect existing research gaps to scientific questions and hypotheses, preserve citations and LaTeX structure, and receive proposed text with separate review notes.

中文简介正在准备中。当前显示英语简介。

  • Drafting the rationale for a research grant proposal
  • Connecting research gaps to questions and hypotheses
  • Polishing prose while preserving LaTeX structure
huangwb8/ChineseResearchLaTeX29662026年10月18日 更新

查看 huangwb8 的全部技能

报告此技能的问题