Skip to content

hello-scholar-2 v2.0.0版本更新

Choose a tag to compare

@Tx1207 Tx1207 released this 06 Aug 03:13
· 20 commits to main since this release

hello-scholar v2.0.0

本版本完成 next-generation Skill workflow,并引入 Document Model v2 的受审核迁移流程,强化中英文 Skill 合同与项目级 Git 产物管理规则。

文档迁移:先盘点、后批准、再执行

当前版本没有 docs migrate 命令,也不会自动移动、删除、双写文档或创建迁移脚本。

迁移已有文档时,将以下提示发送给 Claude Code 或 Codex:

请先运行 `npm root -g`,并读取其输出目录下的 `hello-scholar/docs/migration/document-model-v2.md`。如果文件不存在,请停止并报告,不要猜测其他路径。读取后,严格按该文件的 Document Model v2 流程迁移当前项目文档:先只读盘点并输出逐项 Mapping Proposal,等待我批准后仅执行获批行;不要自动移动、删除、双写或创建迁移脚本。当前版本没有 `docs migrate`命令。对于文件夹数量过多的情况,询问用户是否使用subagent加速处理。完成前必须确认每个获批目标位于 canonical v2 path,相关 `legacy-path` notices 已消失或在 Mapping Proposal 中明确获批保留。

迁移遵循以下边界:

  • 先生成逐项 Mapping Proposal,每行独立等待用户批准;
  • 使用 canonical v2 路径:
    • Spec:hello-scholar/specs//SPEC-.../spec.md
    • Plan / Tasks:与 Spec 位于同一 Bundle
    • Record:runs//record.md
    • Handoff:hello-scholar/handoffs/YYYY-MM-DD--handoff.md
  • 历史 Record 会通过 Proposal 中的 Lifecycle / Status Mapping 映射到当前合法状态,同时保留 abandoned、invalid 等原始历史语义;
  • 只有目标位于 canonical path、能被文档发现器识别,且预期的 legacy-path notice 已消失或获准保留时,才能报告迁移完成。

主要更新

Next-generation Skill workflow

  • 完成并统一 Spec、Plan、Tasks、Record、Architecture、Handoff 的 owner 分工和审批门;
  • 完成扁平化 Skill 布局与项目级安装流程;
  • 新增或完善生产力 Skill,包括迁移、文档维护、收敛审计、计划、任务拆分和实验记录流程;
  • 加强当前事实、设计、实施、实验和验证之间的文档驱动闭环。

双语 Skill 合同对齐

  • 完整审计 16 组中英文 Skill 与相关双语模板;
  • 修复 generating-tasks 对 spec.md 全文读取要求的英文遗漏;
  • 对齐 writing-plans 的执行交接禁止规则;
  • 对齐 using-helloscholar 的流程 Skill 优先级;
  • 为中文 crash-audit 补齐会话/批准阶段触发说明和按用户语言输出的规则;

文档与项目规则

  • README 迁移提示改为通过 npm root -g 定位全局安装的 document-model-v2.md,不依赖当前项目内存在 hello-scholar 源文件;
  • document-model-v2.md 新增 canonical v2 目录树、路径验收、legacy notice 验证和历史 Record 生命周期映射要求;
  • AGENTS.md、AGENTS-zh.md、CLAUDE.md 同步加入 Git 大文件规则:
    • 不提交模型权重、数据集、checkpoint、实验 outputs / results / logs、构建产物或压缩包;
    • 暂存和提交前检查新增文件大小;
    • 使用精确 .gitignore 规则排除不需版本控制的产物;
    • 对发布、复现或外部契约必需的大文件先报告并等待确认。