Version Management

版本管理

ai-coding-ok 如何管理版本、版本标记如何工作，以及完整的升级路径历史。

---

版本方案

ai-coding-ok 遵循语义版本：

vMAJOR.MINOR.PATCH

v3  .  1  .  0
│    │     │
│    │     └── PATCH：向后兼容的 bug 修复
│    └──────── MINOR：向后兼容的新功能
└───────────── MAJOR：不兼容的结构性变更

各级别触发条件

级别	示例
MAJOR	插件打包（v3.0.0）、模板语言拆分、新文件结构
MINOR	新平台支持（v2.1.0 Cursor）、新防御层（v4.1.0 hooks）、新自动加载机制（v2.2.0 CLAUDE.md）
PATCH	模板内容修复、措辞改进（v3.0.1 Act 强制执行）

---

版本标记

每个已安装文件第一行携带版本标记：

Markdown 文件

<!-- ai-coding-ok: v4.1.0 -->

YAML 文件

# ai-coding-ok: v4.1.0

---

完整升级路径历史

graph LR
    v1.0[v1.0<br/>初始发布<br/>2025] --> v2.0[v2.0<br/>PDCA 强制要求<br/>Mode A/B/C/D<br/>版本标记]
    v2.0 --> v2.1[v2.1.0<br/>Cursor + OpenCode<br/>支持]
    v2.1 --> v2.2[v2.2.0<br/>CLAUDE.md shim<br/>Skill desc 重写]
    v2.2 --> v3.0[v3.0.0<br/>插件打包<br/>双语模板]
    v3.0 --> v3.0.1[v3.0.1<br/>Act 输出格式<br/>强制执行]
    v3.0.1 --> v3.1[v4.1.0<br/>五层防御<br/>Claude Code hooks]

Loading

v1.0 → v2.0

变更	类型
AGENTS.md 新增 PDCA 强制指令块	新增
copilot-instructions.md 新增 PDCA 强制执行块	新增
所有模板文件新增版本标记	新增
SKILL.md 新增 Mode A/B/C/D 和 Upgrade Playbook	新增
workflows.md Step 5 标注"⚠️ 不可跳过"	修改
copilot-instructions.md 页脚章节移除	删除

v2.2.0 → v3.0.0

变更	类型
插件打包（.claude-plugin/plugin.json）	新增
双语模板（templates/en/、templates/zh/）	新增
英文 README 拆分	修改
install.sh `--lang en	zh` 标志
skills/ai-coding-ok/ 中权威 SKILL.md	新增

v3.0.1 → v4.1.0

变更	类型
五层防御体系	新增
Claude Code hooks（4 个）	新增
CLAUDE.md STOP 指令	修改
AGENTS.md Plan 3→7 步	修改
安装时自动配置（Step 5.5 + 5.6）	新增
{{SOURCE_DIR_PATTERN}} 占位符	新增

---

检查你的版本

# 检查安装版本
head -1 AGENTS.md
# → <!-- ai-coding-ok: v4.1.0 -->

# 检查所有文件版本一致性
grep -r "ai-coding-ok: v" AGENTS.md CLAUDE.md .github/

---

下一步

• 升级 ai-coding-ok — 如何执行升级
• Changelog — 完整版本历史与详情
• 文件结构 — 哪些文件有版本标记