ccf-common

CCF Common

Family File Contract

开始写入前，为每项任务／产物确定规范输出路径和一个稳定的工作目录。重用明确指定或已建立的任务路径；否则使用项目根目录下的 ccfa-workfiles/<purpose>/<artifact-id>/，并仅在需要时创建 source/、assets/、cache/ 和 build/。直接更新现有文件；不要散落中间文件，也不要创建迭代副本。保留输入和所需证据；仅清理经确认由本任务创建且可丢弃的文件。使用 UTF-8 进行文本读写，并在保存或渲染后检查中文文本。处理文件时，遵循 artifact-contracts.md，并在技能切换期间重用相同路径。

Collaboration Contract

应用这些共享控制之前，先启用 ccf-humanization，除非其基线已处于启用状态。执行一次此入口，然后继续专业工作；不要递归地重新进入任一预检流程。在协作者之间重用适用规则。

指定一位整合负责人，并积极运用其他技能来补齐缺失的先决条件或核查重要发现。重用适用证据；不要为了节省 token 而跳过必要的前期工作。最终定稿前，整合各方贡献并核验受影响的结果。遵循条件适用的 cooperation routes；避免无关阶段和重复报告。

Core Rule

这是每项 CCFA 专业技能启用前、ccf-humanization 启用后的共享控制模块。它负责确定任务范围、整合负责人、相关先决条件、证据边界和文件路径，专业技能则负责生成研究交付物。应用这些控制不会启动维护工作流，也不要求提交治理报告。

Invocation Controls

CCFA Handoff Mode：PARTIAL（推荐）。 遵循 metadata.ccf_skill_controls.handoff_question_mode 和 references/handoff-modes.md。直接调用时，确保在应用这些控制前已阅读 Humanization 的基线。不要递归地重新启动任一预检流程。在协作者之间重用适用规则，并且只阅读当前决策所需的共享参考资料。

家族预检

明确所需结果、范围／权限、负责集成的所有者，以及缺失或可复用的前置条件。使用 references/routing.md 了解协作方式，使用 references/handoff-modes.md 了解交接方式。处理来源或私人材料时遵守证据／隐私规则，处理文件前遵守制品规则，进行评估时遵守审查标准。复用已加载的规则和已知路径；不要仅为启用此技能而创建接收表或状态文件。建立适用的管控措施后，继续专家任务。仅在确有家族维护请求时，才使用下方的维护工作流。

发现元数据和命名的预检不代表已读取其中的说明。应用可见的入口内容，并通过有针对性的读取恢复缺失或截断的相关部分。诊断有人报告的触发失败时，应区分已安装版本、实际读取的工具、所选模式和产生的行为；不要编造加载回执。普通任务无需启动报告或持久化记录。

使用此技能的 scripts/preferences.py resolve 一次性解析偏好设置；已知项目时，添加 --project <established-root>；并在交接时复用简要结果。没有文件即使用默认值，不写入文件，也不提问。当前的明确指示优先于项目、用户和内置默认设置。这些选择仅适用于可选的额外工作；必要的检查和预检仍须执行。只有在需要增强功能、首次选择、配置更改，或解析器缺失／出错时，才读取 preferences.md 中的相关部分；不要加载整份指南，也不要在每项任务中都打开网页。

区分当前用户目标、有依据的处理路径和下一步行动。任务需要探索时，尝试不同机制；执行期间应沿用已选路径，除非出现实质性理由需要调整。区分已提议、已执行和已验证的工作。上下文丢失或反复偏离后，应核对实际制品，并采取一个有边界的步骤，同时不降低交付标准。重复工作必须有新的观察、改变的假设或具体修复。对于耗时较长的任务、进展停滞或重大恢复，应加载 continuity.md；短任务无需额外文件或审查调用。

明确要求自主研究或重复实验时，转至编排器的 research loop。它使用任务的实验范围和预算，而非可选的维护候选额度。常规写作、概念审查和规划不会启动实验。

共享控制

仅加载当前预检决策或维护任务所需的参考资料：

• references/routing.md：用于确定哪个 CCFA 技能负责处理请求，并避免触发范围重叠。
• references/task-modes.md：用于处理探索式／快速／标准深度、基于授权的后续操作、选择性上下文、宿主支持的并行工作，以及 GPT-6 适配。
• references/review-output-standards.md：用于确保数值评分、多审稿人评审组、分数变更条件和可见输出质量保持一致。
• references/handoff-modes.md：用于解读 metadata.ccf_skill_controls.handoff_question_mode。
• references/preferences.md：用于确定已记忆的可选增强项、优先级，以及本地的三语配置页面；强制预检和必要检查仍须执行。
• references/continuity.md：在重新路由和恢复过程中保留任务意图；仅在有用时使用精简状态和可选记录验证。
• references/privacy-and-evidence.md：用于处理手稿、评审、答辩、私人草稿、文献检索或证据主张。
• references/source-registry.yaml：用作场所规则、评审方法、范例记录和研究工作流参考资料的共享来源清单。
• references/ccf-a-venue-map.md：在非写作技能需要场所类别映射、但不依赖 ccf-paper-writer 时使用。
• references/skill-trigger-registry.yaml：用作规范触发器注册表；依据相同的职责边界对照描述和 Agent 提示词。
• references/artifact-contracts.md：凡技能会创建或修改文件时均须使用；其中定义了职责归属、规范路径、中间文件的最少生成原则、默认原位覆盖、任务范围内的清理，以及必须保留的历史记录。
• references/ccfa-yaml-contract.md：用于共享的 ccfa.yaml 项目状态架构。

维护工作流

1. 遵循当前用户范围和现有授权，再考虑默认设置；对于不新增文件的维护，只编辑现有内容。编辑任何 CCFA 系列技能时，保留 metadata.ccf_skill_controls 块，并确保其中的键与 references/handoff-modes.md 保持一致。
2. 添加新的触发语句前，先参考 references/routing.md，避免所有权重叠。
3. 更改检查清单的严格程度、快速润色、标准审查或输出约定前，先参考 references/task-modes.md。
4. 更改评分卡、审查者小组、评分风险表述或最终输出自检规则前，先参考 references/review-output-standards.md。
5. 添加任何浏览、引用、新颖性、评分、实验结果、压缩或反驳指令前，先参考 references/privacy-and-evidence.md。
6. 更改生成的文件名、修订行为、报告文件夹、缓存、尝试存档或台账前，先参考 references/artifact-contracts.md。默认每项交付物只保留一个规范文件，每项任务或工件使用一个稳定的工作目录，并在交付前清理任务创建的临时文件。保留必要证据和其他任务的文件。
7. 切勿提交个人绝对路径、用户名、展开的主目录、私有本地技能根目录或特定机器的命令示例。请使用 $CODEX_HOME、$HOME、仓库相对路径或不包含身份信息的占位符。
8. 在 references/source-registry.yaml 中添加新的公共来源；不要在同级的 source-notes.md 文件中重复冗长的 URL 列表。本地引用必须使用仓库相对标识符或不包含身份信息的 local:/repo: 标识符，而非机器路径。
9. 编辑来源注册表后，运行 scripts/check_sources.py。该脚本只报告问题，不得改写注册表文件。
10. 运行 scripts/check_v04.py，检查系列元数据、注册表、脚本语法、引用的资源和回归；然后在定稿涉及文档、示例、来源记录、脚本、图表或发布文件的 CCFA 系列更改前，运行 scripts/check_path_privacy.py。

输出约定

对于常规预检，将控制权交还给专业人员，无需单独报告。审计或更新 CCFA 技能时，请报告：

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