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 可提交反馈）

---

模板

日期

提交信息: 简要描述

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