From e82eb4e857de8b7d29903dc119e69ad3be8f1b65 Mon Sep 17 00:00:00 2001
From: "zhiye.sun" <zhiye.sun@sinitek.com>
Date: Mon, 31 Aug 2026 13:47:53 +0800
Subject: [PATCH] =?UTF-8?q?docs(release):=20=E5=A2=9E=E5=8A=A0=20SemVer=20?=
 =?UTF-8?q?=E6=9B=B4=E6=96=B0=E6=97=A5=E5=BF=97?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 CHANGELOG.md | 78 ++++++++++++++++++++++++++++++++++++++++++++++++++++
 README.md    |  3 ++
 2 files changed, 81 insertions(+)
 create mode 100644 CHANGELOG.md

diff --git a/CHANGELOG.md b/CHANGELOG.md
new file mode 100644
index 0000000..afb72c4
--- /dev/null
+++ b/CHANGELOG.md
@@ -0,0 +1,78 @@
+# 更新日志
+
+本文档记录 CraftKit 对使用者有明显影响的功能、工作流和兼容性变化。版本号遵循 [Semantic Versioning 2.0.0](https://semver.org/lang/zh-CN/)：主版本表示不兼容变化，次版本表示向后兼容的新能力，修订版本表示向后兼容的问题修复。
+
+历史版本根据 Git 提交倒推，只保留重要里程碑，不逐条复述全部提交。各版本对应的 Git 历史通过 `v<版本号>` 标签标记。
+
+这里的版本号表示 CraftKit 仓库整体发布版本。`dev`、`doc`、`git`、`knowledge` 和 `skill` 的插件清单版本仍按各插件实际变化独立维护，不要求与仓库版本保持一致。
+
+## [Unreleased]
+
+当前没有尚未发布的重大变更。
+
+## [1.2.0] - 2026-08-31
+
+### Added
+
+- 增加项目初始化到应用拆分的共同工作流，明确应用边界、拆分判据、审批门和交付基线。
+- 分别增加新项目与已有项目两种执行口径。
+- 新项目流程覆盖项目上下文、需求基线、业务能力地图、应用拆分、契约设计和建设计划。
+- 已有项目流程覆盖现状建模、耦合识别、目标与过渡架构、数据权威、渐进迁移和回滚。
+
+### Changed
+
+- 明确应用拆分不等于强制微服务化，允许模块化单体或暂不拆分成为评审结论。
+- README 增加项目初始化与应用拆分工作流入口。
+
+## [1.1.1] - 2026-08-31
+
+### Fixed
+
+- 文档转换脚本改为按需加载 `python-docx` 和 `openpyxl`，缺少依赖时返回明确提示，不再影响帮助和参数探测。
+- 缺少转换依赖时不创建输出目录或半成品。
+- 为后端设计、后端实现和前端实现补充 `guidance` 未安装时的规范检索回退路径，降低插件间隐式耦合。
+
+## [1.1.0] - 2026-08-28
+
+### Added
+
+- 增加从需求归集、技术设计、代码实现、测试审核到本地提交的全流程自动化指南。
+- 建立 S0 至 S9 阶段状态机、G1 至 G5 人工审批门、验证矩阵、回退规则和任务台账。
+- 提供可直接交给 Codex 或其他兼容智能体的总控提示词。
+
+## [1.0.0] - 2026-08-26
+
+### Added
+
+- 建立由 `dev`、`doc`、`git`、`knowledge` 和 `skill` 组成的完整 CraftKit 插件体系。
+- 提供 44 个可独立发现的 Skill，覆盖软件设计与实现、文档处理、Git 交付、项目知识和规范维护。
+- README 增加完整 Skill 目录、插件用途和本地使用说明。
+
+### Changed
+
+- 收敛插件元数据和能力描述，使 CraftKit 具备稳定、可理解的首个正式版本基线。
+- 清理仅服务早期建设过程的资料，保留实际运行、维护和发布所需内容。
+
+## [0.3.0] - 2026-08-26
+
+### Added
+
+- Skill 数量扩展到 44 个，形成首个完整能力集合。
+- 补齐代码实现、审查、测试、升级、工作量评估和专项技术设计能力。
+- 补齐版本发布、需求整理、报告和消息编写能力。
+
+## [0.2.0] - 2026-08-25
+
+### Added
+
+- Skill 数量扩展到 25 个，形成可用的开发、文档、Git、知识和规范能力基础。
+- 增加变更计划、后端设计和前端设计等开发分析能力。
+- 建立项目初始化、规范检索、交接、复盘和经验维护的基础结构。
+
+## [0.1.0] - 2026-08-25
+
+### Added
+
+- 初始化 CraftKit 仓库和 Codex 插件市场骨架。
+- 建立 `dev`、`doc`、`git`、`knowledge` 和 `skill` 五个插件区域。
+- 建立插件清单、仓库说明和基础维护结构。
diff --git a/README.md b/README.md
index 24087b4..1a81a0d 100644
--- a/README.md
+++ b/README.md
@@ -2,6 +2,8 @@
 
 CraftKit 是面向 Codex 的通用插件工具集，覆盖软件开发、文档处理、Git 交付、项目知识维护和 Skill 管理。每个插件的核心能力均可独立安装；同时安装相关插件时可以获得跨 Skill 增强，缺少增强插件时按各 Skill 声明的回退流程执行。能力描述保持简洁、中性，并以当前 Codex 能力和公开标准为基础维护。
 
+版本发布与重要变更记录见 [CHANGELOG.md](CHANGELOG.md)。
+
 ## 全流程自动化
 
 需要根据原始需求和项目代码，串联需求分析、技术设计、开发分支、代码实现、测试审核与本地提交时，请使用 [CraftKit 全流程自动化使用指南](WORKFLOW.md)。该指南提供阶段状态机、人工审批门、自动推进规则和可直接交给 Codex 或其他已安装 CraftKit 工具的总控提示词。
@@ -108,6 +110,7 @@ CraftKit 是面向 Codex 的通用插件工具集，覆盖软件开发、文档
 CraftKit/
 ├─ .agents/plugins/marketplace.json  # 仓库级 Codex 插件市场清单
 ├─ AGENTS.md                         # 项目协作与维护约定
+├─ CHANGELOG.md                      # SemVer 版本与重要变更记录
 ├─ WORKFLOW.md                       # 需求到本地提交的研发交付工作流
 ├─ PROJECT-INITIALIZATION-AND-APPLICATION-SPLIT.md
 │                                   # 项目初始化到应用拆分的共同入口