HCodeFlow

主题

七、团队协作与框架迭代 ​

7.1 角色与职责 ​

角色归属职责
框架维护者AI 基础设施组维护 core/ 内容质量、审核变更、版本发布、通知下游升级
项目负责人各业务项目组接入框架、安排升级窗口、协调团队反馈
项目开发者各业务项目组日常使用框架工作流、维护项目自定义内容
下游 AI各业务项目按框架协作规则工作，发现改进时判断层级并告知用户

7.2 变更的三条路径 ​

框架内容的变更有三条路径，适用于不同场景：

路径 A：AI 驱动（最常见） ​

下游项目的 AI 在日常工作中发现框架内容需要改进或需要新增基础设施时，自动触发：

下游 AI 判断改动属于公司级
    ↓
直接修改 marker 上方内容（或新建文件并打 marker）
    ↓
告知用户：改了什么、为什么判断为公司级
    ↓
用户联系 AI 基础设施组
    ↓
基础设施组审查 → harvest.sh 收割 → 发版 → 所有项目升级

AI 的判断依据参见 core/rules/framework_protection.md 中的判断原则（公司级 vs 项目级）。

路径 B：试验场验证（适合需要验证的改动） ​

框架维护者主动发起，在真实项目中验证后再发布：

框架开 exp/ 分支 → dev 版本推送到试验项目 → 真实任务验证 → harvest.sh 收割 → 发版

详见 六、更新与维护 的试验场工作流。

路径 C：人工反馈（适合明确的小改动或工具问题） ​

团队成员直接提 Issue 或 MR：

项目团队提 Issue / MR → 基础设施组评估 → 修改 core/ → 发版 → 下游升级

7.3 变更分类与影响 ​

变更类型影响文件示例
Agent 行为core/agents/*.md"PM Agent 产出的 Spec 缺少性能要求"
工作流规则core/rules/project_rule.md"Q0 轻量判定条件太严格"
合并检查项core/rules/merge_checklist.md"需要增加国际化检查项"
新增 Skillcore/skills/ 新增目录"需要一个安全审查 Skill"
Skill 规则更新core/skills/*/SKILL.md"SQL 规范需要补充分库分表场景"
编码规范模板templates/*.template"后端规范模板需补充日志规范"
脚本工具tools/*.sh"升级脚本遇到特殊字符报错"

7.4 变更评审与风险分级 ​

所有框架变更在合并前需经过评审，评审深度取决于风险级别：

风险级别判定条件评审要求
低仅影响新项目（模板变更）框架维护者自行评审
中影响所有已接入项目（被管理文件变更）至少 1 个项目负责人参与
高影响框架核心机制（marker 格式 / 脚本逻辑）所有项目负责人参与

评审通过后：MR 合并到 develop → 更新 VERSION 和 CHANGELOG → release.sh --confirm 发版通知。

7.5 示例：一次 AI 驱动的框架迭代 ​

场景：your-project 项目的 AI 在开发中发现 Dev Agent 自测阶段没有强制要求证据，判断这是公司级改进。

  1. AI 修改并告知：修改 .claude/agents/dev-agent.md marker 上方内容，增加证据要求，告知用户这是公司级改动
  2. 用户联系基础设施组：基础设施组在框架目录执行 bash tools/harvest.sh ../your-project 审查 diff
  3. 收割并发版：harvest.sh --apply 写入 core/ → 更新 VERSION → release.sh --confirm
  4. 所有项目升级：各项目执行 upgrade.sh，自动继承新的证据要求

Copyright ©️ 2026, CodeFlow Contributors