v0.18 — 项目重命名 data-analysis-skill → data-analysis-skills

⚠️ 升级须知：本版需要重装

skill 的名字变了（data-analysis-skill → data-analysis-skills），因此：

• sync-to-user.sh 不会覆盖旧目录 —— 旧的 data-analysis-skill/ 留在原地，宿主里会出现两份同功能 skill，旧那份从此不再更新。请到你实际在用的宿主目录下手工删除：~/.claude/skills/、~/.codex/skills/、~/.workbuddy/skills/
• 插件市场用户：包名变了，/plugin update 不接续，需重新安装

  /plugin install data-analysis-skills@data-analysis-marketplace
  

变更内容

仓库名、本地项目目录、skill 身份三者对齐（与 v0.14 那次重命名同性质）。属项目身份对齐，非功能性变更 —— 五阶段流程、门禁、统计纪律、模板数据契约均未动。

• skill 目录 skills/data-analysis-skill/ → skills/data-analysis-skills/（git mv，18 个文件全部识别为 rename，文件历史完整保留）
• SKILL.md 的 name、evals.json 的 skill_name
• 四份插件/市场清单的 name / homepage / repository / displayName / websiteURL
• sync-to-user.sh 源路径与三宿主安装目标
• 报告模板落款、examples/sample_report.html
• README 中英双版、需求文档（含文件名）

顺带修掉四处已失效的引用

这四处都是目录改名的直接后果，且常规 grep 扫不到 —— 遵守 .gitignore 的 grep 会跳过 skills/data-analysis-workspace/、requirements/、CLAUDE.md：

1. ~/.claude/skills/data-analysis-skill 指向旧 repo 路径的 symlink 已断链，skill 在 Claude Code 里加载不出来
2. evals.json 的 test_data_dir + 14 条 prompt 共 15 处绝对路径指向旧目录，eval 跑不动
3. validate_template.py:11 硬编码旧模板路径，模板验证直接报错
4. .claude/settings.local.json 权限允许列表与 additionalDirectories 有 7 处旧路径

保持不变

• DATA_ANALYSIS_CLAUDE_SKILL / DATA_ANALYSIS_CODEX_SKILL / DATA_ANALYSIS_WORKBUDDY_SKILL 三个环境变量沿用原名 —— 取自「数据分析」语义而非仓库名
• 历史记录不回改：CHANGELOG 中 v0.18 以下的条目、需求文档的变更记录附录，都保留当时在用的名称

版本号说明

本版占 MINOR。docs/versioning.md 的 bump 规则表原本没有「重命名」条目，本次按 v0.14 先例补入：重命名改的是 skill name、安装路径与插件包名，对调用方可见。原规划 v0.18 的 stock.md（#11）+ 方法模块增强顺延至 v0.19。

验证

模板验证 25/25 PASS · 样例报告结构 8/8 PASS · 5 份 JSON 合法 · evals 17 条路径全部可达 · 三宿主同步成功

v0.17 — 三宿主通用化（Claude Code / Codex / WorkBuddy）

同一套包，现在能装进三家编程智能体：Claude Code / Codex CLI / WorkBuddy。五阶段流程、门禁与统计纪律跨宿主完全一致，只有交互外观按宿主能力自适应。

主要变更

skill 层跨宿主中立化

• SKILL.md 去掉双平台硬编码（原「TodoWrite in Claude Code, update_plan in Codex」）：任务清单工具与结构化提问工具只作举例，宿主没有就降级为纯文本阶段清单 / 编号选择题并等待回复
• 新增明确条款：只降级呈现方式，门禁本身不降级；降级表补「宿主缺少任务清单或结构化提问工具」一行，与既有的「运行环境无法交互」区分开——前者是问法要换，后者是没人可问
• frontmatter description、五阶段流程、统计纪律、模板数据契约均未动

安装与分发

• sync-to-user.sh 增第三目标 ~/.workbuddy/skills/，并新增 symlink 自指守卫（开发机上 ~/.claude/skills/ 常是指向 repo 的 symlink，旧脚本会对同一棵树跑 rsync --delete）
• 新增插件市场清单，Claude Code 与 Codex 可一键安装与更新：.claude-plugin/、.codex-plugin/、.agents/
• WorkBuddy 路径实测：用户级 ~/.workbuddy/skills/，项目级却是 <proj>/.codebuddy/skills/（底层 CodeBuddy 内核名，这处不对称写错则 skill 一个都不出现）

README 改中文优先

• README.md 现在是中文，英文移至 README.en.md
• 两版补「支持哪些智能体」表（逐宿主写清安装路径与验证到什么程度）、安装三路径（粘提示词 / 插件市场 / clone + 脚本）、宿主目录互不读取与项目级 .codebuddy 警告、FAQ「装完没反应」自查、仓库结构段

修掉公开仓库两处「承诺与实况不符」

• sync-to-user.sh 原被 .gitignore 排除，README 却让用户 clone 后运行它 → 纳入版本控制
• 「先看效果」原指向未入库路径（GitHub 上 404）→ 新增 examples/sample_report.html：一份真实生成的 SaaS 36 个月经营分析，用当前模板重新注入（typography 锁版 + 导出 PDF 按钮）

新增 docs/跨宿主验收清单.md
四层一致性口径（门禁 / 纪律 / 报告结构 / 过程可见性）+ S1–S5 五个固定场景 + 逐宿主核对表。

验证程度（诚实标注）

宿主	验证到什么程度
Claude Code	主力宿主，T1–T14 全量 eval 通过
Codex CLI	已适配，交互式全流程与 codex exec 冒烟通过
WorkBuddy	已实测可加载、可运行；S1–S5 逐项核对未回填——不声称「已完整测试」

其它遵循同一 Agent Skill 结构的工具亦可加载，未逐一实测。

怎么升级

• 散装安装：git pull && bash sync-to-user.sh
• 插件形态：Claude Code /plugin update data-analysis-skill

本次验证

三宿主安装后 SKILL.md md5 一致 · claude plugin validate . 通过 · validate_template.py 25/25 PASS（0 FAIL）· check_report_html.py examples 8/8 PASS

完整变更记录见 CHANGELOG.md。

v0.16 — 多数据集输入支持

多数据集输入支持

v0.16 建立统一的「多数据集接入子流程」，覆盖 Excel 多 sheet / CSV 多文件 / JSON 多结构 三种形态——修复了贯穿需求 / 架构 / 实现 / 契约 / 测试五层的「单一数据集公理」缺口，并消除 pandas 默认行为的静默丢失隐患（只读 sheet 0 / 只处理被点名文件 / JSON 多键行为不可预测）。

核心变更

• Phase 1 多源识别子流程（SKILL.md）：枚举全部 sheet / 文件 / JSON 键 → 告知用户 → 确认关联策略（融合 join/concat 或分源独立），并入第一轮提问不新增轮次
• 反静默丢失红线（Statistical Discipline #5，核心层生效）：禁止静默只读第一个 sheet / 只处理被点名文件 / 合并 JSON 键——把模板「不做静默截断」的纪律从输出层延伸到输入层
• 新方法模块 references/data-sources.md：三形态读取范式 + 关联策略矩阵（concat / merge on key / 分源独立）+ 报告组织（融合模式靠 data_overview.narrative + processing_notes，分源模式靠 sections）
• JSON / TSV 基础覆盖：消除「纸面支持」（此前 test-data 0 个 JSON/TSV），新增 eval T11 / T12
• 5 个新 eval 场景 T8–T12（Excel 多 sheet / 多 CSV 关联 / JSON 多键 / JSON 单表 / TSV 单表）

设计原则：契约最小破坏

report_data 字段不变。融合模式由 data_overview.narrative + appendix.processing_notes 承载，分源模式由 sections 天然承载。模板 JS 渲染逻辑、validate_template.py 25 项断言、check_report_html.py 校验均不动（实测全绿）。

冒烟验证

iteration-5 T8（Excel 多 sheet）：with_skill 4/4 assertions + HTML 结构 8/8 PASS，多源接入纪律按设计运行（枚举全源 → 融合策略声明 → processing_notes 记录关联键）。基线 RED 概率性未复现（静默丢失是概率性行为），全量 T9–T12 留后续。

---

完整变更见 CHANGELOG.md。

v0.15 — Grid.js 表格双模式 + 教育行业模版

v0.15 变更内容

新增

• 表格双模式：≤20 行静态出版表，>20 行自动 Grid.js 交互表（分页/搜索/数值排序），Grid.js 6.2.0 双源 CDN 锁版（bootcdn 主 + unpkg 备）
• 教育行业模版 education.md（#6 首批交付）— 培训机构全景：学员运营 + 教学效果 + 招生获客
• 表格数据量纪律放松：允许明细行、单表上限 500 行、TOP-N 截断 + processing_notes

改进

• validate_template.py 新增 13 项断言（双源版本锁、阈值常量、数值解析排序、中文 locale、打印 CSS）
• Node 单元测试 21 例（静态表字节一致性 ×3、parseNum ×13、numCompare ×5）
• Playwright 运行时测试 13 项（双模式切换、升降序数值排序、搜索过滤、打印媒体）

历史版本

完整变更记录见 CHANGELOG.md（v0.1–v0.14）。