ccf-common

Compare original and translation side by side

🇺🇸

Original

English

🇨🇳

Translation

Chinese

CCF Common

Core Rule

核心规则

This is the shared control module for the CCFA Skills family. Do not use it as a user-facing research assistant module. Use it to keep routing, handoff behavior, source provenance, private-material handling, and score-risk language consistent across

ccf-*

skills and

ccf-skill-forger

这是CCFA Skills家族的共享控制模块。请勿将其用作面向用户的研究助手模块。使用它来确保

ccf-*

技能和

ccf-skill-forger

之间的路由、交接行为、来源溯源、私密材料处理以及评分风险语言保持一致。

Invocation Controls

调用控制

CCFA Handoff Mode: PARTIAL (Recommended). Follow

metadata.ccf_skill_controls.handoff_question_mode

and

references/handoff-modes.md

. This skill provides shared policy only; route ordinary research tasks to the owning skill in

references/routing.md

CCFA交接模式：PARTIAL（推荐）。遵循

metadata.ccf_skill_controls.handoff_question_mode

和

references/handoff-modes.md

。本技能仅提供共享策略；将普通研究任务路由至

references/routing.md

中指定的所属技能。

Shared Controls

共享控制

Load only the file needed for the current maintenance task:

```
references/routing.md
```
: Use to resolve which CCFA skill owns a request and to avoid trigger overlap.
```
references/task-modes.md
```
: Use to interpret quick and standard execution modes across CCFA skills.
```
references/review-output-standards.md
```
: Use to keep numeric scoring, multi-reviewer panels, score-change conditions, and visible output quality consistent.

references/handoff-modes.md

: Use to interpret

metadata.ccf_skill_controls.handoff_question_mode

```
references/privacy-and-evidence.md
```
: Use when handling manuscripts, reviews, rebuttals, private drafts, literature searches, or evidence claims.
```
references/source-registry.yaml
```
: Use as the shared source inventory for venue rules, review methods, exemplar records, and research-workflow references.
```
references/ccf-a-venue-map.md
```
: Use when a non-writing skill needs venue-family mapping without depending on
```
ccf-paper-writer
```
.
```
references/skill-trigger-registry.yaml
```
: Use as the v0.4 public trigger registry for routing conflict audits.
```
references/artifact-contracts.md
```
: Use whenever a skill creates or revises files; it defines ownership, canonical paths, overwrite-in-place defaults, and the narrow cases that require retained history.

references/ccfa-yaml-contract.md

: Use for the shared

ccfa.yaml

project-state schema.

仅加载当前维护任务所需的文件：

```
references/routing.md
```
：用于确定哪个CCFA技能负责处理请求，避免触发器重叠。
```
references/task-modes.md
```
：用于解读CCFA技能中的快速执行模式和标准执行模式。
```
references/review-output-standards.md
```
：用于确保数值评分、多评审小组、分数变更条件以及可见输出质量的一致性。

references/handoff-modes.md

：用于解读

metadata.ccf_skill_controls.handoff_question_mode

。

```
references/privacy-and-evidence.md
```
：用于处理手稿、评审意见、反驳意见、私密草稿、文献检索或证据声明时使用。
```
references/source-registry.yaml
```
：用作场地规则、评审方法、范例记录和研究工作流参考的共享源清单。
```
references/ccf-a-venue-map.md
```
：当非写作技能需要场地家族映射且无需依赖
```
ccf-paper-writer
```
时使用。
```
references/skill-trigger-registry.yaml
```
：用作v0.4版本的公共触发器注册表，用于路由冲突审计。
```
references/artifact-contracts.md
```
：当技能创建或修改文件时使用；它定义了所有权、规范路径、原地覆盖默认值以及需要保留历史记录的少数情况。

references/ccfa-yaml-contract.md

：用于共享的

ccfa.yaml

项目状态 schema。

Maintenance Workflow

维护工作流

When editing any CCFA family skill, preserve the
```
metadata.ccf_skill_controls
```
block and keep its keys aligned with
```
references/handoff-modes.md
```
.
Use
```
references/routing.md
```
before adding new trigger language to prevent overlapping ownership.
Use
```
references/task-modes.md
```
before changing checklist strictness, quick polishing, standard review, or output contracts.
Use
```
references/review-output-standards.md
```
before changing scorecards, reviewer panels, score-risk language, or final output self-check rules.
Use
```
references/privacy-and-evidence.md
```
before adding any browsing, citation, novelty, scoring, experiment-result, compression, or rebuttal instruction.
Use
```
references/artifact-contracts.md
```
before changing generated filenames, revision behavior, report folders, caches, attempt archives, or ledgers. Default to one canonical artifact per deliverable and update it in place.
Never commit personal absolute paths, usernames, expanded home directories, private local skill roots, or machine-specific command examples. Use
```
$CODEX_HOME
```
,
```
$HOME
```
, repo-relative paths, or non-identifying placeholders.
Put new public sources in
```
references/source-registry.yaml
```
; do not duplicate long URL lists in sibling
```
source-notes.md
```
files. Local references must use repo-relative or non-identifying
```
local:
```
/
```
repo:
```
identifiers, not machine paths.
Run
```
scripts/check_sources.py
```
after source-registry edits. The script reports issues only and must not rewrite registry files.
Run
```
scripts/check_path_privacy.py
```
before finalizing CCFA-family changes that touch docs, examples, source records, scripts, diagrams, or release files.

编辑任何CCFA家族技能时，保留
```
metadata.ccf_skill_controls
```
块，并使其键与
```
references/handoff-modes.md
```
保持一致。
添加新触发器语言前，使用
```
references/routing.md
```
以避免所有权重叠。
更改检查清单严格性、快速润色、标准评审或输出契约前，使用
```
references/task-modes.md
```
。
更改评分卡、评审小组、评分风险语言或最终输出自检规则前，使用
```
references/review-output-standards.md
```
。
添加任何浏览、引用、新颖性评估、评分、实验结果、压缩或反驳指令前，使用
```
references/privacy-and-evidence.md
```
。
更改生成文件名、修订行为、报告文件夹、缓存、尝试存档或分类账前，使用
```
references/artifact-contracts.md
```
。默认每个交付件对应一个规范制品，并原地更新它。
切勿提交个人绝对路径、用户名、展开的主目录、私密本地技能根目录或特定机器的命令示例。使用
```
$CODEX_HOME
```
、
```
$HOME
```
、仓库相对路径或非识别占位符。
将新的公共源添加至
```
references/source-registry.yaml
```
；不要在同级
```
source-notes.md
```
文件中重复长URL列表。本地引用必须使用仓库相对路径或非识别的
```
local:
```
/
```
repo:
```
标识符，而非机器路径。
编辑源注册表后运行
```
scripts/check_sources.py
```
。该脚本仅报告问题，不得重写注册表文件。
在完成涉及文档、示例、源记录、脚本、图表或发布文件的CCFA家族变更前，运行
```
scripts/check_path_privacy.py
```
。

Output Contract

输出契约

When auditing or updating CCFA skills, report:

text

Routing impact:
Handoff mode impact:
Private-material safety:
Source-registry changes:
Score-risk language changes:
Validation result:

审核或更新CCFA技能时，需报告：

text

Routing impact:
Handoff mode impact:
Private-material safety:
Source-registry changes:
Score-risk language changes:
Validation result: