科研立项依据写作器

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 中核验；不新增无法核验的引用、结果或绝对化结论。

语义写作规则

1. 先写领域价值/必要性与已有证据，再将瓶颈转成待解释的关系、机制、性质或边界。
2. 科学问题用疑问句追问认知缺口；假设用可证伪陈述句预测结果。研究目标、路线、验证终点不冒充问题/假设。
3. 假设前以事实、文献和缺口为主；干预、比较、终点、路线放在假设后。外部文献的方法描述可作证据，不等于本项目方案前置。
4. 切入点/贡献无需固定标题或段数；理论、混合、工程导向只改变措辞与证据重心，不是通过门槛。
5. 逻辑与引用检查后必须读取 references/tier2_semantic_review.md，由当前宿主 AI 直接执行 Tier2 语义检查。由宿主 AI 自主规划术语、论证维度和可读性，输出“位置/障碍/影响/保真改法”。检查长句层级、指代、缩写/新概念、抽象名词、衔接和无效修饰；不科普化或因必要限定强改。
6. 可读性改写须保留已核验事实、对象、限定、问题/假设、引用、标签和 LaTeX 结构；无法保真保留原句并记录风险，不补事实/证据。

措辞边界：吹牛式、绝对化或无依据夸大由宿主 AI 按 references/boastful_expression_guidelines.md 语义复核并归入逻辑/表达建议；Python 只做路径、结构命令、引用 key 等确定性检查，不用固定词表判定。

推荐工作流

1. 读取目标文件和上下文；目标缺失时自动追踪 main.tex，按确定性优先级选择候选，必要时创建白名单内的默认正文文件。
2. 检查问题—假设—证据—研究内容闭环及引用 key；随后必做 Tier2，结果分为“事实问题、逻辑问题、表达建议”。
3. 完成检查后自动复核专业可读性；polish 先在内部锁定事实/逻辑/引用，再做受约束精修，不向用户提问。
4. 自动生成完整正文或 unified diff；发现结构命令变化时自动回退为正文-only 提案并重试。
5. 通过白名单、引用和质量检查后自动写入；写入前备份，写入后展示 diff、假设与回滚入口。
6. 字数与引用检查可独立运行；流程不绑定固定标题或维度清单。

输出契约

默认输出：

目标文件（自动选择及依据）：...
修改范围：仅白名单正文
主要问题：...
建议正文或 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 自主规划，不依赖固定术语矩阵或四维度门槛。