name: nsfc-research-foundation-writer
version: 0.1.0 # 与 config.yaml 中的 skill_info.version 保持一致
description: 为 NSFC 正文"（三）研究基础"写作/重构，并同步编排"工作条件"和"研究风险应对"，用证据链证明项目可行、资源条件对位研究内容、风险预案可执行。适用于用户要写/改"研究基础、前期工作、可行性分析、工作条件、平台团队、风险应对"等场景。
author: ChineseResearchLaTeX Project
metadata:
short-description: NSFC（研究基础+工作条件+风险应对）编排写作
keywords:
- nsfc
- 研究基础
- 可行性分析
- 工作条件
- 平台团队
- 风险应对
- latex
triggers:
- 研究基础
- 前期基础
- 可行性
- 工作条件
- 平台
- 风险应对

以下路径相对于项目根目录

config: skills/nsfc-research-foundation-writer/config.yaml
references: skills/nsfc-research-foundation-writer/references/

NSFC（三）研究基础编排写作器

目标输出（契约）

• 写入落点（2 个文件）：
• extraTex/3.1.研究基础.tex（包含“研究风险的应对措施”）
• extraTex/3.2.工作条件.tex
• 禁止改动：main.tex、extraTex/@config.tex、任何 .cls/.sty
• 核心目标：用“证据链 + 条件对位 + 风险预案”回答评审的三个问题：你做过吗？你做得成吗？出问题你怎么兜底？

必需输入（最小信息表）

• 若用户未提供，请先收集/补全：references/info_form.md

工作流（按顺序执行）

1. 定位项目与目标文件：
2. 验证 project_root 是否存在，不存在时报错并提示用户指定正确路径
3. 检查 extraTex/ 目录是否存在，不存在时尝试创建或报错提示
4. 确认 project_root 和 output_mode（默认为 apply）
   • preview 模式：只生成内容预览，不写入文件（适合调试）
   • apply 模式：将生成的内容写入 extraTex/3.1.研究基础.tex 和 extraTex/3.2.工作条件.tex
5. 仅编辑这两个文件，禁止修改 main.tex、extraTex/@config.tex、任何 .cls/.sty
6. 生成 3.1 研究基础（证据链优先）：
7. 研究积累：围绕 2.1 的关键任务，列出“做过什么/掌握什么/已有平台什么”。
8. 阶段性成果：只写可核验内容（论文/专利/数据/原型/预实验现象）；不确定的细节用占位符要求用户补齐。
9. 可行性四维：理论/技术/团队/条件各给 1–3 个支撑点，并与研究内容逐条对齐。
10. 在 3.1 中显式写“研究风险的应对措施”：
11. 至少 3 条风险（技术/进度/资源各至少 1 条）
12. 每条：风险描述 → 早期信号（触发阈值/现象）→ 预案/替代路线（含降级目标与可交付）
13. 生成 3.2 工作条件（条件对位研究内容）：
14. 已具备条件：逐条列出，格式建议：
    • 平台：XXX 平台（已具备 / 可访问）
    • 数据：XXX 数据集（已获取 / 可公开获取）
    • 样本：XXX 医院/机构（已签署合作协议 / 伦理审批中）
    • 算力：XXX 服务器 / GPU（已配置 / 共享使用）
    • 团队分工：成员 A 负责 XX，成员 B 负责 YY
    • 合规路径：伦理审批（XXX 委员会，周期 X 个月）
15. 尚缺条件与解决途径：逐条列出，格式建议：
    • 缺少条件：XXX（影响：YYY）
    • 解决途径：采购 / 合作 / 替代数据源 / 实验降级方案
    • 时间表与责任人：如用户提供，应写入；如未提供，用占位符标记
16. 一致性校验：
17. 校验 1：检查 3.2 工作条件 是否能逐条支撑 2.1 的关键任务
    • 方法：列出 2.1 的每个关键任务，确认 3.2 中有对应的条件支撑
    • 示例：
    • 任务 1：XXX 实验 → 条件：XXX 平台、XXX 样本
    • 任务 2：YYY 算法 → 条件：YYY 算力、ZZZ 数据
18. 校验 2：检查风险预案是否与年度计划可兼容
    • 方法：列出 2.3 的每年里程碑，确认风险预案有对应的降级方案
    • 示例：
    • 第一年：样本获取 → 风险：样本入组慢 → 预案：有替代数据源与降级验证方案
19. 校验失败时的处理：
    • 如果发现不一致，标记为 [需补充：XXX] 并提示用户
    • 如果用户未提供 2.1 或 2.3，跳过对应校验并提示用户

验收标准（Definition of Done）

质量契约验证（来自 config.yaml）

• 研究基础必须覆盖：
• 与本项目相关的研究积累（证据链）
• 已取得的阶段性成果（可核验）
• 可行性要点（理论/技术/团队/条件）
• 研究风险与应对措施（显式写出）
• 工作条件必须覆盖：
• 已具备条件（平台/数据/样本/算力/团队/合规）
• 尚缺条件与解决途径（时间/预算/合作/采购/替代方案）

详细检查清单

见：references/dod_checklist.md

常见问题与边缘情况

Q1: 项目目录中没有 extraTex/ 目录怎么办？

A: 本技能会自动尝试创建 extraTex/ 目录。如果失败，请手动创建：

mkdir -p projects/NSFC_Young/extraTex

Q2: 我还没有写 2.1 研究内容，可以直接写 3.1 研究基础 吗？

A: 不建议。3.2 工作条件 需要与 2.1 的关键任务对齐。建议先使用 nsfc-research-content-writer 完成 2.1。

Q3: 信息表中的某些内容我不方便公开怎么办？

A: 可以提供"可核验线索"而非完整内容。例如：
- ❌ "我们在 Nature 上发表了论文 XXX"
- ✅ "我们在 Nature 上发表过相关论文（可提供审稿人推荐信）"

Q4: 风险应对必须写 3 条吗？

A: 是的，至少 3 条（技术/进度/资源各至少 1 条）。如果风险较少，可以写"风险较低，暂无其他明显风险"。

Q5: 我的信息表内容很少，能生成完整的研究基础吗？

A: 可以。AI 会根据你提供的信息生成内容，并在不确定的地方使用占位符（如 [请补充：XXX]），请你后续补全。

变更记录

• 本技能不在本文档内维护变更历史；统一记录在根级 CHANGELOG.md。