A skill family for shaping the research storyline of CCF-A papers.

简体中文 · English · 繁體中文

一篇高水平论文真正重要的，往往不是最后那份 PDF，而是贯穿其后的研究故事线。它从一个尚不稳定的 idea 开始，在文献中寻找位置，在实验中接受检验，在写作中被组织成可被审稿人理解的论证，又在评审和 rebuttal 中继续被修正。真正困难的地方，不只是写出某一段 introduction，而是让 idea、证据、实验、表达和回应始终指向同一个研究问题。

CCFA Skills 正是从这个观察出发。它把 CCF-A 论文项目看作一条可以被维护、审计和反复推进的研究故事线，而不是一次性的文本生成任务。一个 idea 需要先被塑形，在真正需要取舍时再接受严格评审；一组实验需要服务于明确 claim，而不是孤立地填满表格；一篇论文的写作需要保留证据边界；一次 rebuttal 也不应只是临时答辩，而应成为下一轮修改和重投的可追踪记录。

这个项目的核心 insight 是：论文质量来自连续决策的质量。写作、评审、审计、投稿检查和 rebuttal 不应该互相替代，而应该各自保持边界，并在同一个项目状态中交接。v0.5 因此将家族收敛为 15 个阶段角色，让每个阶段都有清楚的责任，让每个 artifact 都能找到归属，也让整套系统更像一个围绕研究故事线展开的协作框架，而不是松散的 prompt 集合。

默认论文项目闭环如下：

项目搭建
  -> 流程编排
  -> idea 优化
  -> idea 评审
  -> 文献监控 / 竞品跟踪
  -> 文献检索
  -> 实验设计
  -> 写作范例抽取（可选）
  -> 会议感知写作
  -> 科学/写作评审
  -> 完整性审计
  -> 投稿包检查
  -> rebuttal / revision ledger / resubmission

每个阶段只交给一个 owner skill。这样做的目的不是减少功能，而是让触发条件、输出格式和 artifact 归属更稳定：写作由 writer 负责，判断由 reviewer 负责，事实核验由 auditor 负责，投稿包由 submission checker 负责，回应审稿人由 rebuttal writer 负责。

ccfa.yaml 是共享项目状态文件。它记录 target_venue、stage、artifacts、claims、experiments、reviews、revision_ledger 和 submission_checks，让各个 skill 可以联动，但不会互相覆盖正文、实验表、审稿报告或 rebuttal。

触发边界是这个家族最重要的治理点。相似任务必须进入不同 owner，避免一个请求同时触发多个 skill。

这些旧名称不要再作为独立 runtime skills 安装：

ccf-workflow-planner
ccf-paper-compressor
ccf-writing-reviewer
ccf-citation-auditor
ccf-figure-table-builder
ccf-artifact-packager
ccf-venue-format-guide
ccf-resubmission-adapter
ccf-paper-presenter
ccf-doc-diagram-designer

能力仍然存在，只是归属到更合适的 owner：

CCFA 的 artifact 设计是为了避免 skill 互相覆盖。

• 写作、润色、压缩、presentation 任务应服从用户要求的输出格式。用户给 LaTeX 就保持 LaTeX，给 Markdown 就保持 Markdown。
• 用户只有 idea 且要求从 0 写文章时，ccf-paper-writer 先读取目标会议 venue guide 和篇幅预算；如果没有目标会议或找不到 guide，回退 NeurIPS 模板。
• 投稿式完整稿件不能只求可编译：应接近目标会议主文篇幅，短太多要扩写，超出篇幅再由 writer 的 compression 模式压缩，最后交给 ccf-submission-checker 检查页数。
• 非 review 类 skill 应该灵活、信息密度高，产出具体 artifact，而不是空泛流程说明。
• review、audit、submission gate 可以保持严格结构，因为它们的价值是可追踪的判断、风险和 pass/fail 检查。
• 所有 skill 都不能编造实验结果、引用、官方规则或 reviewer 结论。缺证据时应标明 TBD、needs evidence 或交给对应 owner。

会议 LaTeX/template 信息是 reference，不是 runtime skill：

ccf-paper-writer/references/venue-guides/index.md
ccf-paper-writer/references/venue-guides/<venue>.md

使用规则：

完整安装：

git clone https://github.com/mikubaka88/CCFA-Skills.git
mkdir -p "$CODEX_HOME/skills"
cp -R CCFA-Skills/ccf-* "$CODEX_HOME/skills/"

部分安装必须包含 ccf-common：

skills=(ccf-common ccf-paper-writer ccf-paper-reviewer ccf-submission-checker)
mkdir -p "$CODEX_HOME/skills"
for s in "${skills[@]}"; do cp -R "$s" "$CODEX_HOME/skills/"; done

PowerShell：

$skills = @("ccf-common", "ccf-paper-writer", "ccf-paper-reviewer", "ccf-submission-checker")
New-Item -ItemType Directory -Force "$env:CODEX_HOME\skills" | Out-Null
foreach ($s in $skills) { Copy-Item -Recurse -Force $s "$env:CODEX_HOME\skills\" }

推荐安装组合：

如果你想理解这个家族为什么这样设计，建议按下面顺序阅读：

demo/attention-is-all-you-need/ 是一个 ICLR 风格闭环 demo，用原始 Transformer 论文展示 CCFA 家族如何从原文思路提炼、idea 评审、LaTeX 写作、写作/科学评审、完整性审计、投稿检查走到 rebuttal。demo 是示例，不是必须阅读的入口。

常用验证命令：

python ccf-common/scripts/check_v04.py
python ccf-common/scripts/check_markdown_links.py
python ccf-common/scripts/check_sources.py
python ccf-common/scripts/check_path_privacy.py .

生成 SVG：

python tools/build_ccfa_diagrams.py

发布前应保证 runtime skill 数量、frontmatter、venue guide 路径、SVG 文件、Markdown 链接、路径隐私和插件 manifest 都通过检查。