paper-know-journal

paper-know-journal

输入与输出

输入：期刊/杂志名；可附加输出目录、工作区、关注方向、目标文体/文章类型（如 Article、Original Research、Review、Brief Communication、Case Report、Letter）或目标 manuscript 类型。

输出：KnowJournal-{杂志名}.md，默认在用户当前工作目录根目录；用户指定输出位置时按指定保存。文件名中的 /\:*?"<>| 等路径危险字符替换为 -。

中间文件：默认全部放入 .bensz-api/task-{yyyymmdd-hhmm}-{简短描述}/paper-know-journal/{yyyy-mm-dd-hh-mm}/。除最终 Markdown 和用户明确指定输出外，不得在隐藏工作区外写检索日志、网页摘录、截图、草稿、JSON、临时下载或运行缓存。

测试区：轻量验证用 ./tests/paper-know-journal/；测试证据不得混入最终报告。

流程

输入

按用户请求和配置文件提供必要输入；缺失信息应明确列出并停止依赖该输入的步骤。

执行步骤

• 因本 skill 设计缺陷导致的 bug，先用 bensz-collect-bugs 规范记录到 ~/.bensz-skills/bugs/，不要直接修改用户本地已安装的 skill 源码；若有 workaround，先记 bug，再继续完成任务。
• 只有用户明确要求“report bensz skills bugs”等公开上报时，才用本地 gh 上传新增 bug 到 huangwb8/bensz-bugs；不要 pull / clone 整个仓库。

初始化

先运行脚本创建隔离工作区、测试区和安全输出路径：

python3 /path/to/paper-know-journal/scripts/init_workspace.py \
  --journal "Cancer Cell" \
  --cwd "$PWD"

脚本会打印 workspace_dir、output_path、test_dir、manifest_path、sources_path。所有中间产物写入 workspace_dir。如提示 output_path already exists，覆盖前先向用户确认或改用新路径。

如用户指定输出目录或工作区：

python3 /path/to/paper-know-journal/scripts/init_workspace.py \
  --journal "Journal for ImmunoTherapy of Cancer" \
  --cwd "$PWD" \
  --output-dir "/path/to/output" \
  --workspace-dir "/path/to/.bensz-api/task-{yyyymmdd-hhmm}-{简短描述}/paper-know-journal"

调研

必须联网核验，至少覆盖：

• 官方来源：期刊官网、作者指南、投稿系统说明、manuscript preparation / formatting guidelines、出版商政策页、费用页、编辑政策页。
• 社区/第三方来源：SciRev、LetPub、ResearchGate、Reddit、X/Twitter、论坛、机构图书馆说明、作者经验贴等。第三方只作体验线索，不替代官方政策。

优先查证这些信息：

• 期刊全称、出版社/学会、ISSN、官网、投稿入口。
• scope、文章类型、字数/摘要/图表/参考文献限制。
• 目标文体/文章类型的具体要求：用户指定文体时必须覆盖该文体；未指定时先列出官方文章类型，再选择 2-3 个最常见或最相关类型（通常包括原创研究与综述）展开。逐项核验该类型的名称、正文/摘要字数或页数、摘要类型、关键词数量、章节标题与顺序、图表/补充材料/参考文献限制、报告规范清单和特殊提交材料。
• 投稿形式要求：标题页、作者信息、摘要类型与字数、关键词、正文结构、章节标题、文件组成、模板、行距/页码/编号、图表文件格式与分辨率、补充材料、参考文献格式、cover letter、报告规范清单。
• OA/订阅模式、APC、许可证、是否有会员折扣或豁免。
• 审稿方式、首轮决定时间、接收到上线时间、接收率；没有官方数据时标明来源类型和不确定性。
• 格式要求：标题页、摘要、关键词、正文结构、图像分辨率、补充材料、参考文献格式、声明章节、数据/代码/AI 使用政策。
• 近期文章格式：抽样 2-3 篇近年同类文章，归纳摘要、正文结构、图表数量、声明与参考文献风格。
• 社区评价：速度、沟通、拒稿/大修体验、费用争议、透明度、常见槽点；与官方信息分开写。