From b789e7550177109c4c4499ea927bd6fb9109c357 Mon Sep 17 00:00:00 2001 From: WangDL Date: Wed, 20 May 2026 11:09:01 +0800 Subject: [PATCH] chore: add agent-config backup for cross-device use Co-Authored-By: Claude Opus 4.7 --- agent-config/CLAUDE.md | 113 +++++++++++++++++++++++++++++++++++++++++ agent-config/README.md | 11 ++++ 2 files changed, 124 insertions(+) create mode 100644 agent-config/CLAUDE.md create mode 100644 agent-config/README.md diff --git a/agent-config/CLAUDE.md b/agent-config/CLAUDE.md new file mode 100644 index 0000000..2091ec0 --- /dev/null +++ b/agent-config/CLAUDE.md @@ -0,0 +1,113 @@ +# 知习 (ZhiXi) 项目 + +AI 驱动的系统化学习平台，包含 6 个子项目。 + +| 目录 | 项目 | 技术栈 | 负责 Agent | +|------|------|--------|-----------| +| `startup-plan/` | 项目规划、技术设计、任务记录 | Markdown | Global Agent | +| `api-server/` | 后端 API | NestJS + TypeScript + Prisma + MySQL + Redis | Backend Agent | +| `ios-projects/AIStudyApp/` | iOS App | SwiftUI + 深色主题 | iOS Agent | +| `web-projects/` | Web 官网 | Astro + Tailwind CSS v4 | Web Agent | +| `devops-projects/` | 运维、服务器、凭据 | SSH/Docker/Nginx | DevOps Agent | +| `admin-projects/` | 管理后台 | 待开发 | Web Agent 兼管 | + +每个子项目的 `README.md` 是唯一项目文档（人类 + AI 共用），底部有 "For AI Agents" 章节。 + +## Agent View 工作流 + +Agent 配置在 `.claude/agents/` 下。 + +### 全局工作流 + +1. 用户 → Global Agent（分析任务、拆解、列决策点） +2. 用户确认 → Global Agent 分发子任务到专业 Agent +3. 专业 Agent 执行 → **小任务直接在对话中完成**，复杂/跨模块任务写入 AI_xxx_WORKSPACE.md +4. Global Agent 汇总（读取有变更的 WORKSPACE）→ 写入 AI_GLOBAL_WORKSPACE.md +5. Global Agent 调用 `@review-agent` 触发审查 +6. Review 通过 → Global Agent 给出 commit message 建议 +7. 用户确认 → git add / commit / push +8. Global Agent 将本轮摘要归档到 `已完成/` → 清空所有 WORKSPACE + +### 任务分级 + +| 级别 | 示例 | WORKSPACE 流程 | +|------|------|---------------| +| **小任务** | 单文件修改、颜色调整、文案修正 | 跳过，对话闭环 | +| **中任务** | 单项目多文件、单接口新增 | 专业 Agent 写入自己的 WORKSPACE | +| **大任务** | 跨模块、多 Agent 协作 | 完整流程，所有 WORKSPACE 联动 | + +Global Agent 在分析任务时判断级别。 + +### 文件所有权 + +同一文件不允许两个 Agent 同时修改。Global Agent 分发任务时必须标注： +- 每个子任务允许修改的文件列表 +- 如有文件冲突，按优先级排队（优先级由用户确认） + +### 错误回滚 + +用户可随时说"取消本轮"。Global Agent 收到后： +1. 清空所有 AI_xxx_WORKSPACE.md 填写内容 +2. 不回填已完成目录 +3. 恢复模板状态，等待下一轮 + +### 权限和边界 + +| Agent | 负责范围 | 禁止 | +|-------|---------|------| +| Global Agent | startup-plan，分析/分发/汇总 | 默认不改业务代码 | +| Backend Agent | api-server | 不能私自新增未确认的接口/字段/表 | +| iOS Agent | ios-projects | 不能改后端，不能自行发明接口 | +| Web Agent | web-projects | 不能改后端，不能自行发明接口 | +| DevOps Agent | devops-projects，服务器/部署/CICD | 不能改业务代码 | +| Review Agent | 全局只读审查 | 不能改代码，不能 git 操作 | + +### 跨模块规则 + +1. 专业 Agent 遇到跨模块问题，只能反馈给 Global Agent +2. 专业 Agent 不允许私自新增接口、字段、数据库表、部署服务 +3. iOS/Web Agent 缺接口时，在对话或 WORKSPACE 中写"需要后端支持" +4. Backend Agent 需要数据库/部署/前端决策时，在对话或 WORKSPACE 中写阻塞反馈 +5. 所有跨模块决策必须由 Global Agent 汇总后交用户确认 +6. 接口事实以后端真实代码和 OpenAPI 为准 + +### Review 触发 + +Global Agent 在所有子任务完成后，显式调用： +``` +@review-agent 审查 [scope] 本轮变更 +``` + +Review Agent 将结果写入对应 WORKSPACE 或直接回复 Global Agent。 + +### Git 规则 + +1. 专业 Agent 不允许主动 git commit / push +2. Review Agent 不允许 git commit / push +3. Global Agent 只能在 Review 通过后给出建议 commit message +4. 只有用户明确说"提交"后，才可执行 git 操作 +5. 提交完成后清空所有 WORKSPACE 本轮内容 + +### 提交后归档 + +Global Agent 在提交成功后： +1. 将本轮摘要写入对应项目的 `startup-plan/技术设计/[project]/已完成/` 目录 +2. 文件名格式：`YYYY-MM-DD-简短描述.md` +3. 然后清空所有 WORKSPACE + +## 服务器 + +| 名称 | 公网 IP | 内网 IP | 厂商 | 凭据 | +|------|--------|--------|------|------| +| 轻量云 | 81.70.187.179 | 10.2.0.7 | 腾讯云 | `devops-projects/凭据配置/轻量云服务器凭据.md` | +| 蜂驰云 | 120.53.227.155 | 172.21.0.4 | 腾讯云 CVM | `devops-projects/凭据配置/蜂驰云服务器凭据.md` | + +内网已通过云联网 CCN 打通。 + +## 如何启动 + +```bash +claude --agent-view +``` + +或在 Claude Code 中输入 `/agents`。 diff --git a/agent-config/README.md b/agent-config/README.md new file mode 100644 index 0000000..0b3e564 --- /dev/null +++ b/agent-config/README.md @@ -0,0 +1,11 @@ +# Agent View 配置 + +换设备使用时，将本目录内容复制到项目根目录： + +```bash +# 在知习项目根目录执行 +cp -r startup-plan/agent-config/CLAUDE.md . +cp -r startup-plan/agent-config/.claude . +``` + +然后正常启动：`claude --agent-view`