ishenwei/nexus
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

修改

Browse Source
This commit is contained in:
admin
2026-04-08 19:12:04 +08:00
parent 98b469b97c
commit 89aeb11f49
3 changed files with 0 additions and 649 deletions
Download Patch File Download Diff File Expand all files Collapse all files

458
openclaw/xingshu/Agent任务管理CLI工具实现方案.md
View File

@@ -1,458 +0,0 @@
# Agent 任务管理 CLI 工具实现方案
> 创建日期：2026-03-19
> 作者：星枢
> 用途：定义 CLI 工具的具体实现，供 Agent 调用
---
## 1. 概述
本文档定义用于任务管理的 CLI 工具，帮助执行 Agent（yunjiang、yunzhi、fengchi 等）与 Notion 任务看板交互，实现任务领取、执行、更新、验收等操作。
**核心原则**：
- 简单可靠：一条命令完成一个操作
- 幂等性：重复执行不产生副作用
- 可观测：输出关键日志，便于调试
---
## 2. 工具设计
### 2.1 命令结构
```bash
kanban <command> [options]
```
### 2.2 命令列表
| 命令 | 用途 | 示例 |
|------|------|------|
| `kanban list` | 列出任务 | `kanban list -s TODO -a yunjiang` |
| `kanban get` | 查看任务详情 | `kanban get <task-id>` |
| `kanban take` | 领取任务 | `kanban take <task-id>` |
| `kanban done` | 完成任务 | `kanban done <task-id> -r /path/to/report.md` |
| `kanban review` | 验收任务 | `kanban review <task-id> -r pass -m "验收说明"` |
| `kanban my-tasks` | 我的待办任务 | `kanban my-tasks` |
| `kanban pending-review` | 待我验收的任务 | `kanban pending-review` |
---
## 3. 详细命令定义
### 3.1 kanban list
列出符合条件的任务。
```bash
kanban list [options]
```
**选项**：
| 选项 | 缩写 | 说明 | 默认值 |
|------|------|------|--------|
| `--status` | `-s` | 任务状态 | 全部 |
| `--assignee` | `-a` | 执行者 | 全部 |
| `--priority` | `-p` | 优先级 | 全部 |
| `--limit` | `-l` | 返回数量限制 | 10 |
**示例**：
```bash
# 列出我（yunjiang）待执行的任务
kanban list -s TODO -a yunjiang
# 列出所有待验收的任务
kanban list -s "待验收"
# 列出优先级最高的任务（限制5条）
kanban list -s TODO -p 1 -l 5
```
**输出格式**：
```
ID 任务名 状态 执行者 优先级
----------- ------------------------ -------- ----------- --------
abc123 配置 CI/CD 流水线 TODO yunjiang 1
def456 修复登录 Bug TODO yunjiang 2
```
---
### 3.2 kanban get
查看单个任务的完整信息。
```bash
kanban get <task-id>
```
**示例**：
```bash
kanban get abc123
```
**输出格式**：
```
任务: 配置 CI/CD 流水线
ID: abc123
状态: TODO
优先级: 1
执行者: yunjiang
验收者: fengheng
验收标准:
- CI 流水线运行成功
- 测试覆盖率 > 80%
- 部署到测试环境无报错
验收方式: 自动
依赖任务: def456 (已完成)
创建时间: 2026-03-18 10:00
```
---
### 3.3 kanban take
领取任务，将状态从 TODO 改为 进行中。
```bash
kanban take <task-id>
```
**示例**：
```bash
kanban take abc123
```
**输出**：
```
✅ 已领取任务: abc123
状态: TODO → 进行中
```
**错误情况**：
```
❌ 任务已被其他人领取 (状态: 进行中, 执行者: yunzhi)
❌ 依赖任务未完成 (依赖: def456 状态: TODO)
```
---
### 3.4 kanban done
完成任务，将状态从 进行中 改为 待验收。
```bash
kanban done <task-id> [options]
```
**选项**：
| 选项 | 缩写 | 说明 | 必需 |
|------|------|------|------|
| `--report` | `-r` | Obsidian 报告文件路径 | 是 |
**示例**：
```bash
# 完成任务并提交报告
kanban done abc123 -r /Users/weishen/Obsidian/shenwei/reports/2026-03-19/ci-pipeline.md
```
**输出**：
```
✅ 任务完成: abc123
状态: 进行中 → 待验收
报告: /Users/weishen/Obsidian/shenwei/reports/2026-03-19/ci-pipeline.md
```
**错误情况**：
```
❌ 任务状态不是进行中，无法完成
❌ 报告文件不存在
```
---
### 3.5 kanban review
验收任务（供 fengheng 使用）。
```bash
kanban review <task-id> [options]
```
**选项**：
| 选项 | 缩写 | 说明 | 必需 |
|------|------|------|------|
| `--result` | `-r` | 验收结果：`pass` 或 `fail` | 是 |
| `--message` | `-m` | 验收说明或失败原因 | 否 |
**示例**：
```bash
# 验收通过
kanban review abc123 -r pass -m "CI 流水线运行成功，测试通过"
# 验收失败
kanban review abc123 -r fail -m "部署脚本有语法错误"
```
**输出**：
```
✅ 验收通过: abc123
状态: 待验收 → 完成
❌ 验收失败: abc123
状态: 待验收 → 需修复
原因: 部署脚本有语法错误
```
---
### 3.6 kanban my-tasks
查看当前 Agent 待执行的任务（快捷命令）。
```bash
kanban my-tasks
```
**实现逻辑**：等同于 `kanban list -s TODO -a <当前Agent-ID>`
**输出**：
```
🎯 你有 2 个待执行任务：
[1] 配置 CI/CD 流水线 (优先级: 1)
ID: abc123
验收标准: CI 运行成功, 覆盖率 > 80%
[2] 修复登录 Bug (优先级: 2)
ID: def456
验收标准: 登录流程无报错
```
---
### 3.7 kanban pending-review
查看待当前 Agent 验收的任务（快捷命令，供 fengheng 使用）。
```bash
kanban pending-review
```
**实现逻辑**：等同于 `kanban list -s "待验收" -a fengheng`
---
## 4. 实现架构
### 4.1 目录结构
```
/opt/kanban/
├── bin/
│ └── kanban # 主入口脚本
├── src/
│ ├── __init__.py
│ ├── cli.py # CLI 参数解析
│ ├── notion_client.py # Notion API 封装
│ ├── obsidian_client.py # Obsidian 操作封装
│ └── config.py # 配置管理
├── config/
│ └── config.yaml # 配置文件
└── reports/ # 报告输出目录（可选）
```
### 4.2 配置文件 config.yaml
```yaml
notion:
api_key: "secret_xxxxxxxxxxxxx"
database_id: "xxxxxxxxxxxxx"
obsidian:
vault_path: "/Users/weishen/Obsidian/shenwei"
reports_folder: "reports"
agent:
# 当前 Agent ID，由启动时注入
id: "yunjiang"
```
### 4.3 依赖
```txt
# requirements.txt
pyyaml>=6.0
requests>=2.28.0
python-dotenv>=1.0.0
click>=8.0.0
```
---
## 5. Agent 集成方式
### 5.1 环境变量注入
通过环境变量传递当前 Agent ID：
```bash
export KANBAN_AGENT_ID="yunjiang"
kanban my-tasks
```
### 5.2 在 Agent 代码中调用
**示例：yunjiang 执行任务后**
```python
import subprocess
import os
def execute_and_report(task_id, report_path):
# 1. 执行任务（业务逻辑）...
result = do_task(task_id)
# 2. 生成报告
with open(report_path, 'w') as f:
f.write(f"# 任务执行报告\n\n{result}")
# 3. 调用 CLI 更新 Notion
subprocess.run([
'kanban', 'done', task_id,
'--report', report_path
], env={**os.environ, 'KANBAN_AGENT_ID': 'yunjiang'})
```
---
## 6. 错误处理
### 6.1 错误码
| 错误码 | 说明 |
|--------|------|
| 0 | 成功 |
| 1 | 参数错误 |
| 2 | Notion API 错误 |
| 3 | 任务状态不合法 |
| 4 | 文件不存在 |
| 5 | 权限不足 |
### 6.2 重试机制
对于 Notion API 调用（网络不稳定），实现指数退避重试：
```python
def call_with_retry(func, max_retries=3):
for i in range(max_retries):
try:
return func()
except requests.exceptions.RequestException as e:
if i == max_retries - 1:
raise
time.sleep(2 ** i) # 1s, 2s, 4s
```
---
## 7. 日志
### 7.1 日志级别
| 级别 | 用途 |
|------|------|
| ERROR | 操作失败 |
| WARNING | 警告（可继续） |
| INFO | 关键操作（默认） |
| DEBUG | 调试信息 |
### 7.2 日志格式
```
2026-03-19 07:30:00 [INFO] kanban done abc123 - task completed
2026-03-19 07:30:01 [ERROR] kanban take def456 - dependency not met
```
### 7.3 日志文件
```
/var/log/kanban/kanban.log
```
---
## 8. 部署步骤
### 8.1 安装依赖
```bash
# 安装 Python 依赖
pip install -r requirements.txt
# 确保在 PATH 中
export PATH="/opt/kanban/bin:$PATH"
```
### 8.2 配置
```bash
# 复制配置模板
cp config/config.yaml.example config/config.yaml
# 编辑配置
vim config/config.yaml
# 填入 Notion API Key 和 Database ID
```
### 8.3 测试
```bash
# 测试 list 命令
kanban list -s TODO
# 测试获取任务
kanban get <task-id>
```
---
## 9. 待实现功能
- [ ] Notion API 封装（notion_client.py）
- [ ] CLI 参数解析（cli.py）
- [ ] 配置文件管理（config.py）
- [ ] Obsidian 报告模板
- [ ] 日志系统
- [ ] 错误处理与重试
- [ ] 单元测试
---
## 10. 相关文档
- [[Agent任务管理系统设计]] - 整体架构设计
- [[星枢调度Agent列表]] - Agent 职责定义
- Notion API 官方文档：https://developers.notion.com/
---
*最后更新：2026-03-19*
*作者：星枢*

70
openclaw/xingshu/Agent任务管理系统实施记录.md
View File

@@ -1,70 +0,0 @@
# Agent 任务管理系统实施记录
> 创建日期：2026-03-19
---
## 1. Notion Integration 创建
1. 登录 https://www.notion.so/my-integrations
2. 点击 "New integration"，命名为"任务调度"
3. 获取 Token：`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`
---
## 2. 创建数据库
### 2.1 准备父页面
1. 在 Notion 中创建一个空白页面（如"Agent任务管理"）
2. 右上角 ... → Connect to → 选择"任务调度"
### 2.2 创建任务数据库
**Database ID**: `32847fe1-da27-8135-af44-eefdbd3b1640`
| 字段 | 类型 |
|------|------|
| 任务名 | Title |
| 状态 | Select (TODO/进行中/待验收/完成/需修复) |
| 优先级 | Select (1-5) |
| 验收标准 | Rich Text |
| 报告链接 | URL |
### 2.3 创建 Agents 数据库
**Database ID**: `32847fe1-da27-8101-8758-d416db87d4de`
| 字段 | 类型 |
|------|------|
| Agent ID | Title |
| 名称 | Rich Text |
| 服务器 | Select (Ubuntu2/Ubuntu1/Mac Mini) |
| 角色 | Select (云系/风系/星系) |
| 状态 | Select (在线/离线) |
### 2.4 创建任务类型数据库
**Database ID**: `32847fe1-da27-8172-9558-e8cd5ae3e9b4`
| 字段 | 类型 |
|------|------|
| 类型名 | Title |
| 描述 | Rich Text |
---
## 3. 待完成
- [ ] 连接 Agents 和任务类型数据库到"任务调度" Integration
- [ ] 更新任务数据库，添加 Relation 字段（执行者、验收者、任务类型）
- [ ] 添加预设 Agent 数据
- [ ] 添加预设任务类型数据
---
## 4. 数据库链接
- 任务数据库：https://www.notion.so/32847fe1da278135af44eefdbd3b1640
- Agents：https://www.notion.so/32847fe1da2781018758d416db87d4de
- 任务类型：https://www.notion.so/32847fe1da2781729558e8cd5ae3e9b4

121
openclaw/xingshu/Agent任务管理系统设计.md
View File

@@ -1,121 +0,0 @@
# Agent 任务管理系统设计
> 创建日期：2026-03-18
> 更新日期：2026-03-19
> 参与者：比利哥（用户）、星枢（调度 Agent）
---
## 背景与目标
- 我（星枢）接收任务需求 → 写入 Notion 看板 → 执行 Agent 轮询领取 → 执行完成标记
- 全程可通过手机查看任务进度
---
## 系统架构
```
比利哥 → 星枢(规划确认) → Notion看板 → 云系Agent(轮询领取) → 标记完成
```
**测试范围**：先从云系 Agent（Ubuntu2）开始，星系暂不动。
---
## Notion 数据库结构
### 1. 任务数据库
| 字段 | 类型 | 说明 |
|------|------|------|
| 任务名 | Title | 任务标题 |
| 任务类型 | Relation → TaskTypes | 关联类型 |
| 状态 | Select | TODO / 进行中 / 待验收 / 完成 / 需修复 |
| 执行者 | Relation → Agents | 谁来执行 |
| 验收者 | Relation → Agents | 谁来验收 |
| 优先级 | Select | 1-5（1最高） |
| 依赖任务 | Relation | 关联同一数据库的任务（前置任务） |
| 验收标准 | Text | 可量化标准 |
| 报告链接 | URL | 指向 Obsidian 笔记 |
### 2. Agents 数据库
| 字段 | 类型 | 说明 |
|------|------|------|
| Agent ID | Title | 如 yunjiang |
| 名称 | Text | 如 云匠 |
| 服务器 | Select | Ubuntu2 / Ubuntu1 / Mac Mini |
| 角色 | Select | 云系 / 风系 / 星系 |
| 可执行任务类型 | Relation → TaskTypes | 多对多 |
| 状态 | Select | 在线 / 离线 |
### 3. TaskTypes 数据库
| 字段 | 类型 | 说明 |
|------|------|------|
| 类型名 | Title | 如 开发、运维、监控、CI/CD |
| 描述 | Text | 类型说明 |
| 适用 Agent | Relation → Agents | 多对多 |
---
## 工作流程
### 1. 任务创建（星枢执行）
1. 比利哥给需求
2. 星枢分析需求、拆分子任务、指定执行 Agent、定义验收标准
3. 输出任务列表，与比利哥确认
4. 确认后写入 Notion 看板
### 2. 任务执行（Agent 轮询）
**每个 Agent 定时轮询（3-5 分钟）**：
1. 查询条件：状态=TODO AND 执行者=我 AND (无依赖 OR 依赖任务.状态=完成)
2. 领取任务：状态→进行中
3. 执行完成：创建 Obsidian 报告 → 状态→待验收 → 填入报告链接
### 3. 任务验收
- **暂缓**：验收者、验收流程后续再定
---
## 关键设计决策
| 决策 | 说明 |
|------|------|
| 任务分配 | 直接指定执行 Agent，优先级驱动 |
| 依赖管理 | 通过 Relation 实现，支持多层级依赖 |
| 任务协作 | Agent 通过轮询感知依赖满足，被动触发（延迟分钟级） |
| 报告存储 | 任务完成后生成 Obsidian 笔记，链接回填 Notion |
---
## 待实现
- [ ] Notion Integration 配置（用户创建，提供 Token）
- [ ] 创建三个数据库（任务、Agents、TaskTypes）
- [ ] Notion API 集成（创建/查询/更新任务）
- [ ] 云系 Agent 配置 Heartbeat 轮询
- [ ] 验证任务获取流程
---
## 相关 Agent
| Agent | 服务器 | 角色 |
|-------|--------|------|
| yunjiang | Ubuntu2 | 云匠 / 开发 |
| yunzhi | Ubuntu2 | 云织 / CI/CD |
| yunhan | Ubuntu2 | 云瀚 / 监控 |
| yunce | Ubuntu2 | 云策 / 架构 |
---
## 备注
- 2026-03-18：初始设计
- 2026-03-19：补充数据库 Relation 设计、先从云系测试、验收后续再定