CCFA Skills 开发者指南：用 skill-forger 扩展、校验与发布你自己的 CCF 论文写作技能

CCFA Skills 开发者指南用 skill-forger 扩展、校验与发布你自己的 CCF 论文写作技能【免费下载链接】CCFA-SkillsA skill family for shaping the research storyline of CCF-A papers.项目地址: https://gitcode.com/gh_mirrors/cc/CCFA-SkillsCCFA Skills 是一个面向 CCF-A 级论文研究写作的开源技能家族。本文以其中的 ccf-skill-forger技能锻造者为主线带你完成一条完整的开发者路径扩展你自己的 CCF 论文写作技能、编写可触发的 SKILL.md、运行发布前校验脚本、同步文档示意图并把新技能分发到团队。全程只需读懂少量配置不需要掌握复杂编程。先认识skill-forger 是技能家族的维护中枢CCFA Skills 由 17 个分工明确的技能组成从选题评审、文献检索、实验设计到论文写作、学术润色、科研绘图与投稿检查。在这套家族中ccf-skill-forger是唯一专门负责维护技能本身的技能。它的职责可以概括为四件事职责具体做什么扩展技能新建技能目录、编写 SKILL.md 与触发描述消除冲突对照共享规则清理不同技能间的矛盾指令发布校验运行结构、隐私、链接、来源四类检查脚本图表同步维护仓库文档中的 SVG 架构图与安装图它的入口文件是 ccf-skill-forger/SKILL.md配套的参考资料放在 ccf-skill-forger/references/ 目录下按需加载不会污染你的上下文。扩展步骤一命名与落位3 分钟完成新建一个技能前先确定名字和位置。规则很简单只用小写字母、数字和连字符例如pdf-redline、gh-pr-review名字长度不超过 64 个字符避免helper、coding这类过于宽泛的名称个人技能默认放在$CODEX_HOME/skills若未设置该变量则使用~/.codex/skills创建前先检查目标目录避免与现有技能重名。完整判据见设计清单 ccf-skill-forger/references/design-checklist.md其中Naming And Location一节给出了命名与落位的全部细则。扩展步骤二写出能被触发的 SKILL.mdSKILL.md 是技能的心跳。这里有一个新手最容易踩的坑技能的正文只在触发之后才会被加载所以所有何时使用的触发词必须写在 frontmatter 的description里。frontmatter 最小模板如下--- name: ccf-citation-checker description: 核对论文引用、术语与数值一致性。Use when the user asks to audit citations, claims, or figure numbers in a CCF paper draft. ---好的description遵循一个公式来自 ccf-skill-forger/references/patterns.md核心能力。Use when the user asks to 动词, 动词 for 领域/文件类型, including 具体场景.写正文时记住三条使用祈使句写给 Agent 执行而不是写给人的教程引用随附资源时用相对路径长文档、schema、政策文本下沉到references/正文保持精简。另外如果你把新技能加入 CCFA 家族而非个人技能需要保留家族共享的metadata.ccf_skill_controls五个控制字段完整写法见 design-checklist.md 的 Frontmatter 一节。扩展步骤三references、scripts、assets 四选一不是每个技能都需要满配目录。选择能解决重复工作的最小结构你的需求放在哪里原因短流程、判断规则SKILL.md触发后加载读取成本低长文档、schema、政策references/按需选择性加载可重复或易错的操作scripts/可执行、确定性强模板、字体、参考图assets/作为文件使用不占用上下文以科研绘图技能ccf-visual-composer为例它把大量论文参考图放进 references 目录写作时按需取用例如这张 ICML 论文方法图就被用作构图参考——这种SKILL.md 很薄、细节下沉的组织方式正是整个家族 17 个技能共用的骨架。反模式清单如把触发条件藏在正文、SKILL.md与references/内容重复同样记录在 patterns.md 中发布前建议过一遍。校验步骤发布前必跑的 4 个官方检查脚本技能写完后ccf-skill-forger要求先校验、再发布。在仓库根目录依次运行python ccf-common/scripts/check_v04.py python ccf-common/scripts/check_path_privacy.py python ccf-common/scripts/check_markdown_links.py python ccf-common/scripts/check_sources.py脚本检查内容check_v04.py17 个技能的静态结构、YAML 配置与引用路径check_path_privacy.py是否泄露本机绝对路径或用户名check_markdown_links.py文档内 Markdown 链接是否有效check_sources.py来源登记与出处是否一致需要特别理解一点静态校验 ≠ 模型质量提升。技能效果的改进应当用可复现的评测来支撑例如evaluation/目录下的对比实验就给出了带置信区间的评分证据而不是口头宣称更好了手动校验时对照 design-checklist.md 的 Validation 清单逐条勾选核心项包括文件夹名与 frontmattername完全一致frontmatter 与agents/openai.yaml均为合法 YAML无占位符references/中引用的文件真实存在若技能带脚本先在代表性小样例上跑通。发布前易漏隐私检查与图表同步隐私红线任何提交的文件中不得出现本机绝对路径、用户名或展开后的主目录。统一改用$CODEX_HOME、$HOME或仓库相对路径。这就是为什么ccf-skill-forger的工作流在收尾前强制再跑一次 check_path_privacy.py。图表同步如果你维护的是 CCFA 文档中的架构图、流程图不要手绘或手改生成的 SVG。正确做法是修改生成器 tools/build_ccfa_diagrams.py重新生成全部语言变体后再截图检查视觉规范配色、标签长度、箭头方向以 svg-style-guide.md 为准。发布把技能分发给团队并自动更新校验通过后开发环境建议以本地 clone 作为单一来源git clone https://gitcode.com/gh_mirrors/cc/CCFA-Skills团队侧的日常分发与更新可参考 docs/getting-started/AUTO_UPDATE.md通过npx skills update --global --yes完成更新并支持 Windows 任务计划或 cron 定时执行。注意两点更新后需要新开会话才会加载新技能不要把访问令牌或 API key 写进定时任务命令。发布完成的标准动作是汇报四件事技能名、存放位置、关键文件、校验结果。如果某个依赖缺失导致校验无法运行就如实说明哪一步失败了并按手动清单补查——这正是 skill-forger 输出风格的硬性要求。速查表skill-forger 文件地图文件何时使用ccf-skill-forger/SKILL.md理解完整工作流与调用边界design-checklist.md规划新技能、发布前对照校验patterns.md起草 SKILL.md 结构与 description 公式local-commands.md本地初始化、验证命令与 PowerShell 引号坑svg-style-guide.md维护仓库文档示意图README.md家族全景、安装方式与维护入口从扩展、校验到发布skill-forger 提供的是一套小而完整的技能工程流程命名落位、触发描述、资源分层、脚本校验、隐私收尾。把这份清单用熟你自己的 CCF 论文写作技能也能像家族里的 17 个成员一样可靠地被触发、被信任地被复用。【免费下载链接】CCFA-SkillsA skill family for shaping the research storyline of CCF-A papers.项目地址: https://gitcode.com/gh_mirrors/cc/CCFA-Skills创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考