📖 AI 助手注意：此为 Skill 开发参考文档。
- 开发 MyKnowledge 时（改代码、发布新版本、修复 Bug）：按需查阅此文件
- 正常响应用户请求时：请忽略此文件
⚠️ 改版本号时用bash scripts/bump-version.sh X.Y.Z一键同步，以下为参考。
| # | 文件 | 位置 |
|---|---|---|
| 1 | SKILL.md |
frontmatter version |
| 2 | settings.yaml |
skill.version + version_compatibility.current |
| 3 | _meta.json |
version |
| 4 | manifest.json |
version |
| 5 | one-time/onboarding/main.md |
skill-state.yaml 模板 |
| 6 | hooks/claude/hooks.json |
version |
| 7 | hooks/claude/README.md |
示例 version |
| 8 | hooks/openclaw/HOOK.md |
frontmatter version |
| 9 | hooks/openclaw/hook-guide.md |
示例 version |
| 10 | README.md |
badge + 性能对比表 |
主版本.次版本.修订号 — 1.4.0
- 主版本：不兼容 API 变更
- 次版本：向下兼容功能添加
- 修订号：向下兼容问题修复
📝 版本号说明：1.4.8 已误发到 ClawHub，从 1.4.80 继续（SemVer 修订号支持多位数）。
| 日期 | 版本 | 问题 | 教训 |
|---|---|---|---|
| 2026-06-11 | 1.2.1→1.2.2 | ClawHub 不允许覆盖同版本 | 发布前先跑 lint，发现 lint 不通过需升版本号 |
| 2026-06-11 | 1.2.1 | 改了 5 个文件忘了 Hook 4 个 + README 2 处 | 版本号用 lint 第 5 项自动检查，不要人工记 |
| 2026-06-11 | 1.2.1 | lint 误报用户 KB 路径 | 新增用户侧路径加入 KNOWN_USER_FILES 或豁免 |
| 2026-06-11 | 1.2.3 | 忘了 build-skillhub.sh 生成 SkillHub zip | ClawHub 和 SkillHub 是独立渠道，lint→build→publish 缺一不可 |
| 2026-06-11 | 1.1.12 | FAQ + PITFALLS 没进 zip | 新增文件确认进 manifest.json 的 skillhub_includes |
| 2026-06-11 | 1.1.11 | 负面标签被平台误判为缺陷 | 遵循文档措辞规范，用中性表述 |
| 2026-06-12 | 1.3.2 | version_compatibility.current 漏同步 |
lint 已新增 pattern3 检查 current: 后的版本号 |
| 2026-06-12 | 1.4.71 | 未确认方案就直接修改代码 | 改代码前必须先与用户确认设计方案 |
| 2026-06-12 | 1.4.71/1.4.72 | 版本号误用（把修订号当成次版本号用） | 严格遵循 SemVer，修订号 Z 从 0 递增，不要用 71/72 这样的数字 |
| 2026-06-14 | 1.4.82 | 审计报告发现错误提示不够友好 | 错误提示应使用通俗语言，避免技术术语；提供具体解决方案而非让用户自查 |
| 2026-06-14 | 1.4.85 | 审计报告第一批修复 | 问题1：明确区分工作目录和导出目录；问题4：增加数据存储声明；问题3：创建隐私声明文档 |
| 2026-06-14 | 1.4.86 | 发布时忘记使用 releases/ 目录的 ZIP 文件 | SkillHub 发布必须使用 releases/*-skillhub.zip，这是 build-skillhub.sh 的产出；不要尝试从源码目录直接发布 |
| 2026-06-14 | 1.4.86 | 发布流程优化 | 创建 scripts/release.sh 统一发布脚本，降低 Token 消耗约 90%；支持 --skip-github/--skip-clawhub/--skip-skillhub/--dry-run 参数 |
| 2026-06-14 | 1.4.86 | 新增 skills.sh 平台支持 | 在 README.md 中添加 npx skills add 安装说明；skills.sh 无需发布，CLI 自动扫描 GitHub 仓库 |
| 2026-06-14 | 1.4.86 | 新增 agentskill.sh 平台支持 | 创建 docs/submit-to-agentskill.sh.md 手动提交指南；访问 agentskill.sh/submit 提交 GitHub 仓库 URL |
| 2026-06-15 | 1.4.87 | 文档架构优化 | 将"开发文档"和"用户文档"彻底分离：1) CHANGELOG.md 拆分成用户-facing（进 zip）和开发视角（CHANGELOG-FOR-DEV.md，不进 zip）；2) RELEASE-LOG.md 简化为开发参考；3) 创建 docs/release-history.md 和 docs/roadmap.md 存放详细记录；4) 更新 manifest.json 的 skillhub_includes 和 path_check_exempt |
- 详细发布记录 →
docs/release-history.md - 路线图 →
docs/roadmap.md - 开发指南 →
DEVELOPMENT.md - 用户视角变更记录 →
CHANGELOG.md
最后更新: 2026-06-15