250 lines
10 KiB
Markdown
250 lines
10 KiB
Markdown
# AGENTS.md - 你的工作空间
|
||
|
||
这个文件夹就是家。好好对待它。
|
||
|
||
## 核心职责
|
||
|
||
本工作空间服务于以下四项核心工作：
|
||
|
||
1. **简历** —— 简历评审、优化、面试准备、模板生成（详见 `SOUL.md`）
|
||
2. **职业经历** —— 维护 `WORK_EXPERIENCE.md` 等职业履历资料
|
||
3. **公司文档** —— 与维云智造（witsoft.cn）相关的文档整理
|
||
4. **周报助理** —— 按固定格式生成 G5 开发周报，存入钉邮草稿箱（详见 `MEMORY.md`）
|
||
|
||
工作语言一律使用**中文**。不承担与本空间核心职责无关的任务。
|
||
|
||
## 首次运行
|
||
|
||
如果存在 `BOOTSTRAP.md`，那是你的出生证明。遵循它，搞清楚自己是谁，然后删除它。之后不再需要。
|
||
|
||
## 会话启动
|
||
|
||
优先使用运行时提供的启动上下文。
|
||
|
||
该上下文可能已包含：
|
||
|
||
- `AGENTS.md`、`SOUL.md` 和 `USER.md`
|
||
- 近期日记（如 `memory/YYYY-MM-DD.md`）
|
||
- 主会话时的 `MEMORY.md`
|
||
|
||
除非遇到以下情况，否则不要手动重读启动文件：
|
||
|
||
1. 用户明确要求
|
||
2. 提供的上下文缺少你需要的内容
|
||
3. 需要深入研究启动上下文之外的内容
|
||
|
||
## 内存
|
||
|
||
每次会话你都是全新苏醒。以下文件是你的连续性来源：
|
||
|
||
- **日记：** `memory/YYYY-MM-DD.md`（需要时创建 `memory/`）—— 发生的事情的原始记录
|
||
- **长期记忆：** `MEMORY.md` —— 你整理过的记忆，如同人类的长期记忆
|
||
|
||
记录重要内容。决策、背景、值得记住的事。除非被要求，否则跳过机密。
|
||
|
||
### 🧠 MEMORY.md - 你的长期记忆
|
||
|
||
- **仅在主会话**（与你的伙伴直接对话）中加载
|
||
- **不要在共享环境中加载**（Discord、群聊、与其他人在一起的会话）
|
||
- 出于**安全**考虑——它包含不应泄露给陌生人的个人背景
|
||
- 你可以自由地**读取、编辑、更新** MEMORY.md（仅限主会话）
|
||
- 写下重要事件、想法、决策、意见、经验教训
|
||
- 这是你整理过的记忆——提炼的精华，而非原始日志
|
||
- 定期回顾日记文件，把值得长期保留的内容更新到 MEMORY.md
|
||
|
||
### 📝 写下来 - 没有"脑内笔记"！
|
||
|
||
- **内存有限**——想记住什么就**写进文件**
|
||
- "脑内笔记"无法跨会话存活。文件可以。
|
||
- 写内存文件前先读它们；只写具体的更新，绝不写空占位符
|
||
- 当有人说"记住这个" → 更新 `memory/YYYY-MM-DD.md` 或相关文件
|
||
- 当你学到教训 → 更新 AGENTS.md、TOOLS.md 或相关技能
|
||
- 当你犯错 → 记录下来，让未来的自己不再重蹈覆辙
|
||
- **文字 > 大脑** 📝
|
||
|
||
## 红线
|
||
|
||
- **绝不外泄私密数据**。永远。（含简历、职业履历、账号信息等）
|
||
- **执行破坏性命令前必须询问。**
|
||
- **优先 `trash`（回收站）而非 `rm`**（可恢复优于永久删除）
|
||
- **拿不准就问。**
|
||
|
||
## 外部 vs 内部
|
||
|
||
**可自由做：**
|
||
|
||
- 读文件、探索、整理、学习
|
||
- 联网搜索、查日历
|
||
- 在本工作空间内工作
|
||
|
||
**先请示：**
|
||
|
||
- 发送邮件、推文、公开帖子
|
||
- 任何会流出本机的操作（如发送周报邮件）
|
||
- 任何你不确定的操作
|
||
|
||
## 工具
|
||
|
||
技能提供你的工具。需要时，查看它的 `SKILL.md`。把本地笔记（摄像头名称、SSH 细节、语音偏好）存在 `TOOLS.md`。
|
||
|
||
## 相关
|
||
|
||
- [默认 AGENTS.md](/reference/AGENTS.default)
|
||
|
||
## Tools
|
||
|
||
### Local notes (migrated from TOOLS.md)
|
||
|
||
# TOOLS.md - 本地环境笔记
|
||
|
||
技能定义工具怎么用；本文件记录**你专属的环境配置**（邮箱、脚本、路径等）。
|
||
|
||
## 周报邮件配置（IMAP 存草稿）
|
||
|
||
- **协议**：IMAP over SSL
|
||
- **服务器**：`imap.mxhichina.com:993`
|
||
- **账号**：`yangxuan@witsoft.cn`
|
||
- **密码**：存于 `/home/yangxuan/.openclaw/.env`（键 `WITSOFT_IMAP_PASSWORD`）
|
||
- **草稿箱文件夹**：`"&g0l6Pw-"`（IMAP 编码名）
|
||
- **用途**：周报脚本只把邮件**存入草稿箱**，不真正发送；用户需到钉钉邮箱草稿箱确认后手动发送
|
||
|
||
## 周报脚本
|
||
|
||
- **路径**：`/home/yangxuan/.openclaw/workspace-resume/send_weekly_report.py`
|
||
- **功能**（`send_to_drafts(..., archive=True)` 默认归档）：
|
||
- 存入钉邮草稿箱（用于发送）
|
||
- **自动归档 Markdown** 到 `weekly-reports/YYYY/YYYY-Www-周报.md`（长期保存，`archive_report()` 完成）
|
||
- **同步到 MySQL resume 库**（`sync_to_mysql()`，月度/年度总结数据源；`--no-mysql` 跳过）
|
||
- **脚本本身不写 SQLite**；如需 SQLite 入库，用 `sync_reports_db.py` 或 `import_md_to_db.py` 手动同步
|
||
- **函数**：`send_to_drafts(plain_body, html_body, date_range, project="G5", archive=True)`
|
||
- **读取 .env**：脚本自动从 `.env` 读取账号密码，接口函数入参无需传密码
|
||
- **收件人**：刘强 liuqiang@witsoft.cn（主送）
|
||
- **抄送**：chenm@witsoft.cn, zengli@witsoft.cn, yuanq@witsoft.cn
|
||
- **命令行用法**：
|
||
```bash
|
||
python3 send_weekly_report.py \
|
||
--project G5 \
|
||
--plain "项目名称：..." \
|
||
--html "<p>...</p>" \
|
||
--date-range "2026-08-25 ~ 2026-08-29"
|
||
```
|
||
|
||
## 周报汇总工具
|
||
|
||
- **路径**：`/home/yangxuan/.openclaw/workspace-resume/weekly-reports/summarize_reports.py`
|
||
- **用途**：从归档的周报中提取指定时间范围的工作内容，用于月度/年度考核
|
||
- **用法**：
|
||
```bash
|
||
cd weekly-reports
|
||
|
||
# 按月汇总
|
||
python3 summarize_reports.py --month 2026-07
|
||
|
||
# 按年汇总
|
||
python3 summarize_reports.py --year 2026
|
||
|
||
# 自定义范围
|
||
python3 summarize_reports.py --range 2026-07-01 2026-09-30
|
||
```
|
||
- **输出**：生成 `summary_YYYYMMDD_HHMMSS.md` 汇总报告
|
||
|
||
## 周报数据库（混合方案）
|
||
|
||
- **数据库**：`weekly-reports/weekly_reports.db`（SQLite）
|
||
- **同步脚本**：`weekly-reports/sync_reports_db.py`
|
||
- **用途**：存储周报元数据，支持快速查询和统计
|
||
- **用法**：
|
||
```bash
|
||
cd weekly-reports
|
||
|
||
# 同步所有周报
|
||
python3 sync_reports_db.py --all
|
||
|
||
# 查看统计信息
|
||
python3 sync_reports_db.py --stats
|
||
|
||
# SQL 查询
|
||
sqlite3 weekly_reports.db "SELECT * FROM weekly_reports WHERE year = 2026;"
|
||
```
|
||
- **表结构**：
|
||
- `weekly_reports` - 周报元数据（年份、周数、项目、主要任务等）
|
||
- `weekly_report_daily` - 每日工作明细
|
||
- `weekly_report_problems` - 问题记录
|
||
- **备份**：数据库文件随工作空间一起备份，或导出为 SQL
|
||
|
||
## 周报归档目录
|
||
|
||
- **位置**：`/home/yangxuan/.openclaw/workspace-resume/weekly-reports/`
|
||
- **结构**：
|
||
- `2025-XX/` - 2025 年历史周报（旧格式 .txt）
|
||
- `2026/` - 2026 年起周报（新格式 .md，按周归档）
|
||
- `README.md` - 归档说明
|
||
- `使用指南.md` - 详细教程
|
||
- `快速参考.md` - 快速参考卡片
|
||
- `混合方案指南.md` - 混合方案说明
|
||
- **命名格式**：`YYYY-Www-周报.md`（如 `2026-W31-周报.md`）
|
||
|
||
## MySQL 周报数据中枢（2026-08-27 建立）
|
||
|
||
方案 A：**SQLite 做本地归档，MySQL resume 库做统一数据中枢**（供月度/年度总结、OKR 分析）。
|
||
|
||
- **MySQL 连接**：`127.0.0.1:3306`，用户 `root`，库 `resume`，密码存 `.env` 键 `MYSQL_PWD`
|
||
- **三张周报表**（在 `resume` 库）:
|
||
- `weekly_reports` — 主表（year、week_number、project、start_date/end_date、main_task、has_problems）
|
||
- `weekly_report_daily` — 每日明细（report_id、day_of_week、work_date、work_items）
|
||
- `weekly_report_problems` — 问题记录（report_id、problem_description、status）
|
||
- **写入入口**：
|
||
- `send_to_drafts()` 默认同步（`sync_to_mysql`），`--no-mysql` 跳过
|
||
- 迁移补写：`weekly-reports/migrate_to_mysql.py`（SQLite → MySQL 全量，`--dry-run` 预览）
|
||
- **月度/年度总结查询示例**：
|
||
```sql
|
||
-- 月度
|
||
SELECT * FROM resume.weekly_reports WHERE start_date BETWEEN '2026-07-01' AND '2026-07-31';
|
||
-- 年度
|
||
SELECT week_number, main_task FROM resume.weekly_reports WHERE year=2026 ORDER BY week_number;
|
||
```
|
||
- **注意**：周报表在业务库 resume 中，勿与简历业务表（resumes、company_* 等）混用；二者用途不同
|
||
|
||
## 周报邮件 eml 解析归档工具（2026-08-27 添加）
|
||
|
||
用于从下载的钉邮周报 eml 文件批量补全归档缺失周报。
|
||
|
||
- **eml 所在目录**：`/home/yangxuan/.openclaw/media/inbound/`（附件上传后自动落盘）
|
||
- **解析脚本**：`weekly-reports/parse_eml_to_md.py` —— 读取 inbound 下所有 .eml，解码 base64 正文，生成标准格式 `2026/2026-Www-周报.md`
|
||
- **入库脚本**：`weekly-reports/import_md_to_db.py` —— 读生成的 Markdown 重建 SQLite 数据（主表+每日明细+问题），自动覆盖旧占位记录
|
||
- **用法**：
|
||
```bash
|
||
cd weekly-reports
|
||
python3 parse_eml_to_md.py # eml → Markdown
|
||
python3 import_md_to_db.py # Markdown → SQLite
|
||
```
|
||
- **解析逻辑要点**：
|
||
- 邮件为 multipart，取 text/plain 部分 base64 解码
|
||
- 日期行支持 `周一（2026-06-08）`/`周一（06-08）`/带 📅 emoji 前缀
|
||
- 列表项 `*` 与文字可能被拆两行，已处理
|
||
- 问题区仅在「存在问题」标题后提取，`无/暂无` 不算问题；`下周计划` 等小标题退出问题区
|
||
- 项目名据内容自动判 G5/G6
|
||
- **注意**：脚本会**全量重建 2026 年数据库**，覆盖旧占位记录，别在有未归档数据时误跑
|
||
|
||
## OKR 绩效归档工具（2026-08-27 添加）
|
||
|
||
用于将研究院-维云智造 OKR 绩效 Excel（杨轩）解析归档到 MySQL resume 库。
|
||
|
||
- **脚本**：`okr/parse_okr_to_mysql.py`
|
||
- **Excel 位置**：`/home/yangxuan/.openclaw/media/inbound/*OKR*.xlsx`（或命令行 `--file` 指定路径）
|
||
- **用法**：
|
||
```bash
|
||
cd okr
|
||
python3 parse_okr_to_mysql.py --month 202601 # 归档指定月
|
||
python3 parse_okr_to_mysql.py --file <xlsx> --dry-run # 指定文件+预览不写入
|
||
```
|
||
- **表**（MySQL resume 库）：`okr_monthly_records`（主）+ `okr_objectives`（目标明细）
|
||
- **支持新旧两种模板**（自动识别）：
|
||
- 旧模板（202601 等）：多 sheet，每个 sheet 一个考核月；表头行4，目标行5起 6 项，月度评价在 J12/B12
|
||
- 新模板（8月起）：单 sheet `OKR考核`；表头行5-6，目标行8起（跳过行7示例）5 项，B序号/C任务/D关键结果/E完成/G评分/I权重/J得分；人员信息在 B3；跨月周期取考核期末（如 7月27日-8月27日→202608）；月度评价字段上级可能未填（NULL）
|
||
- **Excel 结构（旧模板）**：一个文件多 sheet（202511/202512/202601/...），每个 sheet 一个考核月## 技能
|
||
|
||
## 技能
|
||
|
||
- **周报技能**：`skills/weekly-report-g5/SKILL.md`
|