| name | nsfc-justification-writer |
| description | 当用户要求写作、重构、审查或润色 NSFC/科研基金申请书的立项依据、研究意义、国内外现状、科学问题或科学假设时使用。以语义论证和可核验性为核心，支持任意文件名、标题命令和 LaTeX 结构；默认全自动完成诊断、成稿、校正、备份和写入，不向用户发起中途确认或审核问题。 |
| metadata | {"author":"Bensz Conan","short-description":"科研立项依据语义写作与安全改写","keywords":["nsfc-justification-writer","立项依据","科学问题","科学假设","研究意义","国内外现状","LaTeX"],"triggers":["nsfc-justification-writer","立项依据","研究意义","为什么要做","国内外现状","现有不足","科学问题","科学假设"]} |
科研立项依据写作器
BenszAPI 任务工作区
本 Skill 的新任务中间文件统一写入 ./.bensz-api/task-{yyyymmdd-hhmm}-{简短描述}/{skill名}/input|output|log/。同一任务复用一个任务根目录；多 Skill 协作才创建 shared/。正式交付物不写入该目录，历史隐藏目录只允许显式兼容读取、迁移或清理。
与 bensz-collect-bugs 的协作
- 本 skill 设计缺陷导致 bug 时，按
bensz-collect-bugs 记录到 ~/.bensz-skills/bugs/，不要改用户本地已安装 skill；可用 workaround 时先记录再继续。
- 仅用户明确要求公开上报时，才用本地
gh 通过该 skill 上传新增 bug 到 huangwb8/bensz-bugs；不 pull/clone 整仓库。
任务边界
- 自动理解目标文件、段落和目标，直接生成成稿并写入安全目标；同时输出 unified diff、备份路径和假设记录。
- 只改自动确定且通过白名单的正文；保留标题、章节/环境命令、标签、引用命令和配置命令。
- 只改白名单正文文件，不改
main.tex、配置文件、.cls、.sty。目标不唯一时按“已配置目标 → 文件名含立项依据/justification → 字典序首项”自动选择并记录选择依据。
- 目标可来自用户或配置，不假定固定文件名。
- 引用 key 必须能在项目
.bib 中核验；不新增无法核验的引用、结果或绝对化结论。
语义写作规则
- 先写领域价值/必要性与已有证据，再将瓶颈转成待解释的关系、机制、性质或边界。
- 科学问题用疑问句追问认知缺口；假设用可证伪陈述句预测结果。研究目标、路线、验证终点不冒充问题/假设。
- 假设前以事实、文献和缺口为主；干预、比较、终点、路线放在假设后。外部文献的方法描述可作证据，不等于本项目方案前置。
- 切入点/贡献无需固定标题或段数；理论、混合、工程导向只改变措辞与证据重心，不是通过门槛。
- 逻辑与引用检查后必须读取
references/tier2_semantic_review.md，由当前宿主 AI 直接执行 Tier2 语义检查。由宿主 AI 自主规划术语、论证维度和可读性，输出“位置/障碍/影响/保真改法”。检查长句层级、指代、缩写/新概念、抽象名词、衔接和无效修饰；不科普化或因必要限定强改。
- 可读性改写须保留已核验事实、对象、限定、问题/假设、引用、标签和 LaTeX 结构；无法保真保留原句并记录风险，不补事实/证据。
措辞边界：吹牛式、绝对化或无依据夸大由宿主 AI 按 references/boastful_expression_guidelines.md 语义复核并归入逻辑/表达建议；Python 只做路径、结构命令、引用 key 等确定性检查，不用固定词表判定。
推荐工作流
- 读取目标文件和上下文；目标缺失时自动追踪
main.tex，按确定性优先级选择候选，必要时创建白名单内的默认正文文件。
- 检查问题—假设—证据—研究内容闭环及引用 key；随后必做 Tier2，结果分为“事实问题、逻辑问题、表达建议”。
- 完成检查后自动复核专业可读性；
polish 先在内部锁定事实/逻辑/引用，再做受约束精修，不向用户提问。
- 自动生成完整正文或 unified diff；发现结构命令变化时自动回退为正文-only 提案并重试。
- 通过白名单、引用和质量检查后自动写入；写入前备份，写入后展示 diff、假设与回滚入口。
- 字数与引用检查可独立运行；流程不绑定固定标题或维度清单。
输出契约
默认输出：
目标文件（自动选择及依据）：...
修改范围：仅白名单正文
主要问题：...
建议正文或 unified diff：...
引用与事实守护：...
未修改：标题、结构命令、配置和样式文件
可读性发现归入“表达建议”，不当作事实错误；Tier2 是完整诊断必选项，由当前宿主 AI 直接完成，不经过 Python responder 或 fallback。
无法明确正文边界时按最小安全正文范围继续；若材料不足，采用保守假设并在“假设与待核验项”中记录，不暂停等待用户输入。始终执行白名单、备份、缺失 bibkey 检查并报告实际变更。
脚本说明
scripts/run.py preview：自动生成 diff 并按 guardrails.output_mode 写入；需要只读检查时显式加 --dry-run。refs、wordcount：独立引用/字数工具；术语、论证维度和可读性由 Tier2 宿主 AI 规划。diagnose：仅执行 Tier1 确定性诊断，并提示宿主 AI 读取 references/tier2_semantic_review.md；不主动调用模型、不生成 Tier2 fallback 结论。coach、review：主流程必须包含由宿主 AI 直接执行的 Tier2 语义检查。吹牛式/绝对化风险按参考准则由 AI 判断，脚本不做固定短语命中。apply-section：legacy 标题替换写入；新流程优先使用完整正文提案自动写入，不依赖 \\subsubsection。diff、rollback：查看或回滚自动写入变更；回滚命令仍需显式 --yes 以避免误操作。
参考资料
按任务先阅读 references/tier2_semantic_review.md，再按其中需要阅读 references/scientific_question_guidelines.md、references/scientific_hypothesis_guidelines.md、references/professional_readability_guidelines.md 和 references/boastful_expression_guidelines.md。用户流程、脚本用法和架构边界见 README.md；检查维度由宿主 AI 自主规划，不依赖固定术语矩阵或四维度门槛。
