Multi Project Management

多项目管理

跨多个项目使用 ai-coding-ok 的策略——批量安装、共享配置和统一升级。

---

场景

场景	策略
3-5 个个人项目	逐个安装，按项目定制
10+ 团队微服务	批量安装，共享编码规范
含多个包的 Monorepo	根目录一次安装，按包分节
组织级推广	共享模板仓库 + 自动化安装

---

批量安装

#!/usr/bin/env bash
# batch-install.sh

AI_CODING_OK="$HOME/tools/ai-coding-ok"
PROJECTS=(
  "$HOME/projects/api-service"
  "$HOME/projects/web-frontend"
  "$HOME/projects/admin-panel"
)

for project in "${PROJECTS[@]}"; do
  echo "=== 安装到 $project ==="
  cd "$project"
  bash "$AI_CODING_OK/install.sh" --copilot --target .
done

---

共享编码规范

方案 1：符号链接

# 创建共享规范
mkdir -p ~/team-standards
vim ~/team-standards/coding-standards.md

# 在每个项目中创建符号链接
for project in ~/projects/*/; do
  ln -sf ~/team-standards/coding-standards.md "$project/.github/agent/coding-standards.md"
done

方案 2：复制 + 同步脚本

#!/usr/bin/env bash
# sync-standards.sh

SHARED="$HOME/team-standards"
for project in "$HOME/projects"/*/; do
  cp "$SHARED/coding-standards.md" "$project/.github/agent/coding-standards.md"
  echo "✅ 已同步到 $project"
done

---

Monorepo 策略

monorepo/
├── AGENTS.md                          # 根级：总体架构
├── .github/
│   └── agent/
│       └── memory/
│           ├── project-memory.md      # 总体架构 + 各包章节
│           ├── decisions-log.md       # 跨包 ADR
│           └── task-history.md        # 所有包的任务
├── packages/
│   ├── api/
│   ├── web/
│   └── shared/

task-history.md 中按包前缀

### [TASK-042] [api] 添加限流中间件
### [TASK-043] [web] 修复移动端响应式布局
### [TASK-044] [shared] 添加日期格式化工具

---

统一升级

检查所有项目版本

for project in "$HOME/projects"/*/; do
  if [ -f "$project/AGENTS.md" ]; then
    version=$(head -1 "$project/AGENTS.md" | grep -oP 'v\d+\.\d+\.\d+')
    echo "$project → $version"
  fi
done

---

组织级推广

阶段 1：试点（1-2 个项目）

• 在 1-2 个试点项目中安装
• 为组织规范定制模板
• 测试 2 周

阶段 2：模板创建

• 提取组织特定定制为共享模板
• 创建组织标准 coding-standards.md
• 创建组织特定 project-memory.md 章节

阶段 3：推广

• 创建安装 ai-coding-ok + 组织模板的包装脚本
• 加入新人入职检查清单
• 设置 CI 强制执行

阶段 4：维护

• 指定"记忆维护人"（轮值角色）
• 每月审查各项目记忆质量
• 每季度升级 ai-coding-ok 框架

---

项目特定 vs 共享

内容	共享？	方式
coding-standards.md	✅ 是	共享文件，符号链接或同步
workflows.md	⚠️ 部分	共享基础，项目特定补充
system-prompt.md	⚠️ 部分	共享角色，项目特定定义
project-memory.md	❌ 否	每个项目有独特架构
decisions-log.md	❌ 否	每个项目有独特决策
task-history.md	❌ 否	每个项目有独特历史

---

下一步

• 团队最佳实践 — 团队中使用 ai-coding-ok
• 定制化指南 — 为项目定制
• CI 集成 — 跨项目设置 CI