ai_soc_sw/docs/05_变更日志/2026-05-23.md

# 变更日志

## 2026-05-23

### 框架搭建（3 次提交）

**feat(skill): 更新 Skill 文件为 v2.0 新框架结构** (`3491827`)
- ai-collab-setup/SKILL.md 升级为 v2.0
  - 采用 R/W/RW/- 四态权限体系
  - 新增 read_only_paths 和 forbidden_paths 配置
  - 工作流增加 retry 和 escalation 机制
  - 新增提示词模板（code-style.md、doc-template.md、bug-report.md）
  - 目录结构新增 src/server/、src/config/、src/types/
- add-subproject/SKILL.md 升级为 v2.0
  - 目录结构新增 src/server/、src/config/、src/types/ 子目录
  - 示例任务增加完整的 feedback/round1.md 格式
  - impact.md 增加影响的功能模块和环境依赖变更段落
  - 脚本兼容 Windows PowerShell 和 Linux/macOS
  - ENVIRONMENT.md 默认使用 pnpm 包管理器

**feat(structure): 新增项目级目录 docs/、tools/、data/** (`456cda9`)
- docs/ 项目级总体文档（5 个子目录：产品需求、系统架构、开发规范、部署运维、变更日志）
- tools/ 开发工具脚本
- data/ 训练数据
- AGENTS.md 权限矩阵新增三个目录的权限定义
- coder.json Dev AI 新增 docs/、tools/、data/ 可写路径
- tester.json QA AI 新增 docs/、data/ 只读路径，tools/ 禁止路径
- ai-collab-setup/SKILL.md 目录结构同步更新到 v2.1

**feat(context): 新增 resume-context Skill 和项目上下文文档体系** (`9f493c1`)
- resume-context Skill（接着干）- 换电脑时自动同步上下文
- docs/PROJECT_CONTEXT.md 项目整体上下文
- docs/DECISIONS.md 架构决策记录（ADR）
- docs/06_开发日志/ 按日期记录讨论内容
- 根目录 ENVIRONMENT.md 开发环境配置
- ai-collab-setup/SKILL.md 版本升至 v2.2

**fix(changelog): 补充变更日志归档目录 archived/** (`b7c3d4e`)
- 创建 docs/05_变更日志/archived/ 目录
- PROJECT_CONTEXT.md 项目结构图补充 archived/ 子目录
- ai-collab-setup/SKILL.md 两处目录树同步更新

**fix(constitution): 修正 QA AI 权限 - 区分'禁止修改'与'禁止读取'** (`defecb0`)
- tester.json: projects/*/src/、projects/*/docs/、shared/ 从 forbidden 移至 read_only
- AGENTS.md: QA AI 只读路径补充业务代码、技术文档、共享资源、验收标准
- ai-collab-setup/SKILL.md: 权限矩阵同步更新，QA AI 可读 src/docs/shared

**feat(resume-context): 增加角色识别机制** (`da14b96`)
- 触发词格式：接着干 开发/测试/架构
- 开发模式：Dev AI，按宪法约束（coder.json）
- 测试模式：QA AI，按宪法约束（tester.json）
- 架构模式：人类负责人，最高权限，不受宪法约束
- 版本升至 v2.0

**feat(arch-ai): 新增 Arch AI（架构AI）角色，升级为'1 人+3AI'协作模式** (`490af83`)
- 新增 .ai/config/architect.json - Arch AI 配置文件（最高 AI 权限）
- 新增 .ai/prompts/architecture/ - 架构设计提示词目录
- AGENTS.md: 新增 Arch AI 角色定义，权限矩阵增加 Arch AI 列
- workflow.json: 工作流从 4 阶段扩展为 5 阶段（新增架构设计阶段）
- ai-collab-setup/SKILL.md: 全面支持 3 角色架构，版本升至 v3.0
- resume-context/SKILL.md: 架构模式改为 Arch AI，版本升至 v3.0
- README.md: 目录结构、团队角色、工作流程全面更新

**工作流变更**:
```
需求分析(Arch AI) → 架构设计(Arch AI) → 开发实现(Dev AI) → 测试验证(QA AI) → 验收确认(人类)
```

**docs(readme): 补充 README.md 和变更日志 - 同步 Arch AI 升级** (`c31ab66`)
- README.md: 更新为"1 人+3AI"协作模式，目录结构、团队角色、工作流程全面更新
- AGENTS.md: AI 配置文件说明增加 architect.json 和 architecture/ 提示词
- docs/05_变更日志/2026-05-23.md: 补充今天所有提交的变更记录

**feat(skill): 新增 update-constitution 和 update-docs 两个 Skill** (`62d908c`)
- update-constitution: 更新宪法文件（AGENTS.md、配置文件、权限矩阵）
- update-docs: 更新项目文档（README.md、变更日志、PROJECT_CONTEXT.md）
- 解决痛点：核心代码改了，文档和变更日志容易忘

**feat(skill): 新增 git Skill - 封装常用 git 操作** (`75312d7`)
- 将 status/add/commit/push/pull/branch/log/diff/stash/reset 封装为参数化动作
- 规范提交信息格式（type(scope): subject）
- 控制提交频率，按功能/任务粒度提交

**feat(skill): 新增 switch-model Skill - 大模型切换时快速同步上下文** (`5cba5c2`)
- 必须指定角色（架构/开发/测试），不同角色检查不同内容
- 简洁版检查报告，控制在 1 屏内
- 加载对应角色配置、活跃任务、可用 Skill 列表、环境配置

**fix(switch-model): 调整执行顺序，git 安全检查优先** (`b3fbe33`)
- 将 git status/log/branch 移到上下文加载之前
- 增加异常处理：未提交变更/合并冲突/分支错误/远程更新
- 版本升至 v1.1

**feat(skill): 新增 7 个 Skill 工具** (`75312d7` ~ `b3fbe33`)
- ai-collab-setup: 创建协作框架
- add-subproject: 添加子项目
- resume-context: 换电脑时同步上下文
- switch-model: 换大模型时同步上下文
- update-constitution: 更新宪法文件
- update-docs: 更新项目文档
- git: 封装 git 操作

**fix(constitution): 修复 tester.json 权限冲突** (`当前提交`)
- review/*/acceptance.md 从 read_only 移除，保留 allowed（QA AI 可补充验收标准）
- review/*/feedback/ 从 forbidden 移除，保留 allowed（QA AI 可提交反馈）

---

## 模板

### 日期

**提交信息**: 简要描述

- 具体变更内容
- 影响范围