chore: add agent-config backup for cross-device use
Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>
This commit is contained in:
parent
2994509bd3
commit
b789e75501
113
agent-config/CLAUDE.md
Normal file
113
agent-config/CLAUDE.md
Normal file
@ -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`。
|
||||
11
agent-config/README.md
Normal file
11
agent-config/README.md
Normal file
@ -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`
|
||||
Loading…
x
Reference in New Issue
Block a user