科研立项依据写作器

目标

本 Skill 将 NSFC/科研基金申请书的立项依据整理为可核验、论证连贯且保留 LaTeX 结构的正文。它适用于新写、重构、审查和润色立项依据；宿主 AI 负责理解材料、安排论证和改写正文，Python 脚本负责确定性检查与安全写入。科学问题与科学假设必须从研究现状的缺口自然收束出来，正文先推进科学判断，证据等级、外推边界和待核验项另列为审查记录；只有会改变本段解释的关键限定进入正文。

立项依据的默认内容链为：研究意义 → 国内外研究现状 → 科学问题与科学假设 → 小结，表示论证功能，不要求改成固定四节。已有标题和结构能完成这些功能时予以保留。研究目标、技术路线、主验证场景、终点、阈值和风险处理属于后续章节，本 Skill 只在需要时作简短衔接，不展开这些内容。

流程

输入

必需：项目根目录，以及目标立项依据正文或可定位该正文的项目材料。
通常读取：目标 .tex、研究内容、研究基础和项目 .bib；只读取完成当前论证所需的内容，不归档无关原始材料。
可选：CLI 的 --target-file、完整正文提案文件和 --override 配置。目标文件按“显式配置 → 文件名含立项依据或 justification 的候选 → 字典序”选择；找不到时使用配置允许的默认目标并创建文件。
先按需读取分节写法规划论证地图和段落推进；完成正文后读取质量控制执行一次语义复核；需要回归对照时读取边界表达回归样例。
不把密钥、令牌、凭据、Cookie、完整私有 Prompt 或不必要的大体积原始数据写入产物、日志或报告。

执行步骤

先识别新写、重构、审查或润色任务，再读取目标正文、相关研究内容、研究基础和文献，明确核心科学主张与论证主线。简短诊断分为“必须修复、建议优化、可以保留”，重要问题注明位置、依据和影响。润色优先局部修复，重构说明重排理由；审查任务沿用以下证据与语义复核原则，完成诊断和四类说明后返回，不调用默认会写入的 preview，也不创建目标正文。任务类别不新增 CLI 子命令，不增加阶段确认。
按分节写法选择最小有效修订。公允说明已有贡献，区分“考察但未解决、尚未研究或评价、明确条件下不能解决”，领域全面性受已读取材料范围约束。研究意义 2–3 段、约占正文 15%–25%，现状主题 1–2 段仅为软建议；必要证据、限定、引用及合理结构优先。支持假设的前期观察放在假设之前或紧邻假设，区分外部研究、团队观察、实施基础与探索线索；无前期结果时不强加段落。
正文先推进科学判断，合并重复限定，保留所有改变解释的必要条件；按需拆句或分段。科学问题与假设沿“现状缺口 → 核心未知 → 项目切入点 → 可证伪预测”自然收束。瓶颈—约束—问题—假设仅作内部提纲；除非确有独立且必须分别证伪的分支，不使用 R1/R2/R3、H1/H2 等编号。模型配置、数据划分、指标和验证顺序后置到研究方案。方法学问题可以研究可识别性、收敛性质、误差界、表征规律或泛化条件，不强改为生物机制。
按质量控制复核保真与修订授权。不改变主张的措辞及证据衔接可直接修订；改变因果方向、机制、对象、范围或核心假设时核对依据与已有授权。“证明→提示”“导致→相关”同样可能改变科学含义，依据明确且在既有授权内的纠错可执行并说明；依据不足或未获相关授权时仅列建议，保留待决段落原文，完成其余可保真修订，不宣称全文可直接使用。不虚构文献、结果或结论。
写作任务将完整正文提案交给 scripts/run.py preview：检查目标路径、引用 key、结构命令变化和 diff，通过后默认备份并写入；--dry-run 只生成 diff。引用另区分 bibkey 存在、文献信息可核验、文献支持具体主张；未读足够内容时标明支持性未核验。移动句段后复核引用、公式、标签和数值，脚本通过不等于科学保真。
交付正文与四类说明：论证结构改进、学术表达改进、科学歧义与证据缺口、作者决策事项。写入时附 diff、备份和回滚信息；简单任务简短说明，无问题类别写“未发现”。机器结果用 diagnose、refs、wordcount；历史用 list-runs、diff、rollback。

输出

写作任务：完整正文提案及四类修订说明，重要调整附理由；证据等级、外推边界、保留限定及待核验项归入相应类别，不重复生成审查报告。作者决策事项列选项、影响和当前采用状态；有待决段落时明确成稿限制。审查任务仅输出诊断与建议。
preview：正文-only unified diff，成功写入时输出目标路径、备份和运行记录；宿主 AI 补充修改说明与 rollback --project-root <项目目录> --run-id <run_id> --yes，不把语义审查冒充为脚本字段。
diagnose：结构、引用、DOI、字数和配置约束的文本摘要；传入 --json-out 时额外保存 JSON。
refs：引用核验摘要及 BibTeX 补齐/核验提示；wordcount：按选定口径统计当前字数，不设默认目标、容差或偏差状态。
list-runs、diff、rollback：列出运行记录、查看某次运行的备份差异或从备份恢复。

输出管理

运行记录、临时 diff 和备份使用 config.yaml 的 workspace.runs_dir，默认位于当前任务的 ./.bensz-api/task-{yyyymmdd-hhmm}-{简短描述}/nsfc-justification-writer/。
正式正文只写入自动确定且通过白名单的目标 .tex；不写 main.tex、配置文件、.cls 或 .sty。正式源代码、文档和计划仍写入仓库约定路径，不放入任务工作区。
preview 默认自动写入；审查任务跳过该入口，确需查看候选 diff 时显式使用 --dry-run。每次写入前备份，回滚默认先备份当前版本；回滚必须显式传入 --yes。
任务失败时保留提案、诊断、diff 和错误信息，避免覆盖原正文；不得自动删除、迁移或远程上传用户文件。

校验

运行 python skills/nsfc-justification-writer/scripts/run.py validate-config，确认配置字段和写入白名单有效。
运行 diagnose，检查目标路径、配置的 .bib 中的引用 key 及字数统计（不作目标值判断）；结构命令的前后变化另由 preview 比较。
运行 preview --dry-run，确认变更只涉及正文；出现结构/配置命令时默认拒绝，只有项目白名单允许且用户明确传入 --allow-structural-change 才能继续。
仓库维护时运行 python tests/nsfc-justification-writer/test_revision_safety.py --task-root <已声明的任务目录>，用隔离样稿验证目标定位、字数无约束统计、引用守护、备份/回滚和正文-only diff；产物集中在当前任务目录。安装副本使用上述 CLI 做定向检查，不假设随包附带仓库测试。
按回归样例复核修改范围、缺口分类、假设证据、科学主张与引用支持；这些是语义验收，不用固定词表或机械评分替代。
结构规范另由仓库级 Skill 检查器验证；本 Skill 不把结构检查器当作语义质量判断的替代品。

失败与恢复

目标不明确、路径越界或不在白名单：停止写入，报告候选和原因；修正配置或显式目标后从目标定位重新开始。
缺失输入：登记缺口，完成有依据的部分；新写可提出有边界且明确标记的候选假设，修订原稿不得用保守假设暗换作者主张。待决段落保留原文并给建议，不补造事实，也不把局部修订称为完整定稿。
缺失引用 key、结构命令变化或安全检查失败：保留提案和诊断结果，拒绝写入；修正正文后重新运行 preview。
写入异常：以原文件和写入前备份为恢复起点，保留 run 记录；不要把部分写入宣称为完成。
需要撤销已写入内容时，先用 list-runs 找到 run_id，再执行 rollback --yes；无法定位匹配目标的备份时停止并报告，不使用不确定的旧备份。

约束

遵守以下公共约束，并执行本 Skill 的专属边界。

公共硬约束

任务需要落盘时，使用唯一的 ./.bensz-api/task-{yyyymmdd-hhmm}-{简短描述}/ 根目录；共享材料放入 shared/，Skill 专属材料放入该 Skill 的 input/、output/、log/。
正式交付物、源代码和正式计划按项目约定保存，不写入任务工作区；未经授权不覆盖、删除、迁移或远程写入。
项目维护变更检查 BAC 可用性并记录需求、AI 产出、工具结果、文件改动和验证摘要；BAC 只做过程审计，不替代署名、责任或合规判断。
不记录 API Key、访问令牌、密码、Cookie、环境/凭据文件、私有 Prompt、身份信息、本地用户名、主机名或不必要的大体积原始数据。
文件路径必须规范化并限制在授权项目范围内；外部 URL、子进程和网络访问遵循最小权限，防止路径遍历、SSRF 和命令注入。
Skill 版本唯一记录在自身 config.yaml:skill_info.version；公开 API、协议、目录或配置变更同步文档与 CHANGELOG.md。
仅将 Skill 或 Bensz 基础设施本身的设计缺陷交给 bensz-collect-bugs；先脱敏写入 ~/.bensz-skills/bugs/，当前任务不中断，只有用户明确要求才公开上报，禁止直接修改用户已安装的 Skill 源码。

Skill 专属约束

只改自动确定且通过白名单的正文；保留标题、章节/环境命令、标签和引用命令。
不改 main.tex、项目配置、.cls 或 .sty；allow_missing_citations 为 false 时，缺失 bibkey 默认拒绝写入。
不把研究目标、技术路线、主验证场景、终点、阈值或风险处理写成立项依据的主体论证；不把未验证信息伪装成确定结论。
bensz-collect-bugs 是一个用于缺陷留痕与按需上报的 Agent Skill；仅处理本 Skill 或 Bensz 基础设施本身的流程漏判、输入契约不完整和环境假设错误，不处理用户资料错误、第三方服务波动、用户主动改源码或模型偶发波动。
缺陷先脱敏记录到 ~/.bensz-skills/bugs/，当前任务不中断；默认不收集本地用户名、主机名、工作目录或其它敏感信息。
只有用户明确要求公开上报时，才使用本机 gh api 按文件路径提交脱敏记录；不 clone 或 pull 上游仓库。
严禁直接修改用户本地已安装 Skill 的源代码来“顺手修 bug”。

nsfc-justification-writer