Skip to content
Open
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension


Conversations
Failed to load comments.
Loading
Jump to
The table of contents is too big for display.
Diff view
Diff view
  •  
  •  
  •  
2 changes: 1 addition & 1 deletion .codex/skills/gourmet-organizer/SKILL.md
Original file line number Diff line number Diff line change
Expand Up @@ -17,7 +17,7 @@ Use this skill when the user:

### 1. Find the right landing spot

1. Run `python3 Notes/snippets/markdown_toc.py Notes/Gourmet.md` to see the file structure.
1. Run `python3 snippets/markdown_toc.py Notes/Gourmet.md` to see the file structure.
2. Search for the restaurant and nearby cuisine sections with `rg -n "<restaurant>|<cuisine>|<city>" Notes/Gourmet.md`.
3. Prefer updating an existing restaurant section.
4. If the restaurant already exists, preserve prior visits and split the notes by visit, date, or menu type rather than blending everything together.
Expand Down
16 changes: 8 additions & 8 deletions .trae/documents/Codex-TODO-System-v2.md
Original file line number Diff line number Diff line change
Expand Up @@ -102,7 +102,7 @@
空队列时按这个顺序找下一批:

1. **复盘近期 completed TODO**:优先看最近 3-5 条完成项,判断是否需要沉淀到 AGENTS.md、skill、脚本、oncall 文档或材料流程。
2. **优化本仓库工作系统**:检查 `.trae/`、`Notes/snippets/`、`.codex/skills/`、`.openclaw-memory/`、`.local` 索引和近期笔记结构,找能降低后续摩擦的小改动。
2. **优化本仓库工作系统**:检查 `.trae/`、`snippets/`、`.codex/skills/`、`.openclaw-memory/`、`.local` 索引和近期笔记结构,找能降低后续摩擦的小改动。
3. **只优化素材探索机制,不默认消费材料**:可以改进 trusted sources、读取工具、候选库治理、Unread/fallback 规则;不要把 `.local/LEARNING_MATERIAL_CANDIDATES.md` 当前阅读队列里的具体材料默认转成私有卡片。
4. **只新增明确小切口**:新 TODO 必须有可验证产物,例如 schema、脚本、文档、转发稿、实验设计或笔记落点;不要新增“继续优化系统”这类空任务。
5. **允许明确报告队列为空**:如果没有真实小切口,应直接告诉用户当前 TODO 队列为空,并给出最小触发条件,例如“读完某材料后再触发 `读完`”或“agent-harness 有新回复后再推进”。
Expand All @@ -111,15 +111,15 @@

## 当前保留的工具

- `Notes/snippets/codex_todo_triage.py`:生成 Codex 视角的 TODO triage index,并可写入 `codex_triage` 元数据。
- `python3 Notes/snippets/codex_todo_triage.py`:刷新 `.local/CODEX_TODO_TRIAGE_INDEX.md`。
- `python3 Notes/snippets/codex_todo_triage.py --user-actions`:只打印当前 pending 阻塞任务的用户动作队列。
- `python3 Notes/snippets/codex_todo_triage.py --next-action`:只打印当前最推荐的一个用户动作,并附带轻量 blocker 检查结果。
- `python3 Notes/snippets/codex_todo_triage.py --batch-plan`:输出下一轮 `推进TODO` 的推荐批次;如果没有 Codex-owned active TODO,即使仍有 user-blocked 项,也优先建议流程沉淀、机制优化、效率优化、素材探索能力、笔记重构、脚本/skill 改进和索引治理,不默认消费具体材料队列。
- `python3 Notes/snippets/codex_todo_triage.py --check-blockers`:对已知阻塞项做轻量本机检查,例如 `gh auth status`、`trae` CLI、`ssh`、搜索脚本是否可用。
- `snippets/codex_todo_triage.py`:生成 Codex 视角的 TODO triage index,并可写入 `codex_triage` 元数据。
- `python3 snippets/codex_todo_triage.py`:刷新 `.local/CODEX_TODO_TRIAGE_INDEX.md`。
- `python3 snippets/codex_todo_triage.py --user-actions`:只打印当前 pending 阻塞任务的用户动作队列。
- `python3 snippets/codex_todo_triage.py --next-action`:只打印当前最推荐的一个用户动作,并附带轻量 blocker 检查结果。
- `python3 snippets/codex_todo_triage.py --batch-plan`:输出下一轮 `推进TODO` 的推荐批次;如果没有 Codex-owned active TODO,即使仍有 user-blocked 项,也优先建议流程沉淀、机制优化、效率优化、素材探索能力、笔记重构、脚本/skill 改进和索引治理,不默认消费具体材料队列。
- `python3 snippets/codex_todo_triage.py --check-blockers`:对已知阻塞项做轻量本机检查,例如 `gh auth status`、`trae` CLI、`ssh`、搜索脚本是否可用。
- `.local/CODEX_TODO_TRIAGE_INDEX.md`:本地私有索引,不提交、不公开。
- `.trae/documents/Codex-TODO-User-Action-Queue.md`:剩余 user-blocked TODO 的用户动作队列,把每个阻塞任务压缩成一个命令、一个问题或一个明确选择。
- `Notes/snippets/generate-ai-hotspots-daily.sh` 等 launchd 脚本:作为“可落地自动化任务”的示例。
- `snippets/generate-ai-hotspots-daily.sh` 等 launchd 脚本:作为“可落地自动化任务”的示例。

## 暂不推进

Expand Down
12 changes: 6 additions & 6 deletions .trae/documents/Codex-TODO-Web-Manager-v2.md
Original file line number Diff line number Diff line change
Expand Up @@ -27,9 +27,9 @@
首页只展示四块:

- TODO 总览:pending / completed / feedback_required 数量。
- Next Action:复用 `python3 Notes/snippets/codex_todo_triage.py --next-action`。
- User Action Queue:复用 `python3 Notes/snippets/codex_todo_triage.py --user-actions`。
- Blocker Checks:复用 `python3 Notes/snippets/codex_todo_triage.py --check-blockers`。
- Next Action:复用 `python3 snippets/codex_todo_triage.py --next-action`。
- User Action Queue:复用 `python3 snippets/codex_todo_triage.py --user-actions`。
- Blocker Checks:复用 `python3 snippets/codex_todo_triage.py --check-blockers`。

这比完整 CRUD 更符合当前合作模式:Codex 先判断,再推进一个真实小切口。

Expand Down Expand Up @@ -71,9 +71,9 @@ GET /api/codex/check-blockers
实现方式优先调用或复用:

```bash
python3 Notes/snippets/codex_todo_triage.py --next-action
python3 Notes/snippets/codex_todo_triage.py --user-actions
python3 Notes/snippets/codex_todo_triage.py --check-blockers
python3 snippets/codex_todo_triage.py --next-action
python3 snippets/codex_todo_triage.py --user-actions
python3 snippets/codex_todo_triage.py --check-blockers
```

返回 JSON 时可以先用简单结构:
Expand Down
14 changes: 7 additions & 7 deletions .trae/documents/GitHub-Agent-Memory-Research-Seeds.md
Original file line number Diff line number Diff line change
Expand Up @@ -7,13 +7,13 @@
已完成:

```bash
Notes/snippets/github-search.sh status
Notes/snippets/github-search.sh repos "agent memory llm" 3
Notes/snippets/github-search.sh repos "llm agent" 3
Notes/snippets/github-search.sh repos "agent memory eval" 10
Notes/snippets/github-search.sh issues "memory" openai/codex 3
Notes/snippets/github-search.sh issues "memory" mem0ai/mem0 5
Notes/snippets/github-search.sh issues "memory" langchain-ai/langgraph 5
snippets/github-search.sh status
snippets/github-search.sh repos "agent memory llm" 3
snippets/github-search.sh repos "llm agent" 3
snippets/github-search.sh repos "agent memory eval" 10
snippets/github-search.sh issues "memory" openai/codex 3
snippets/github-search.sh issues "memory" mem0ai/mem0 5
snippets/github-search.sh issues "memory" langchain-ai/langgraph 5
```

结论:
Expand Down
18 changes: 9 additions & 9 deletions .trae/documents/GitHub-Search-GH-Setup.md
Original file line number Diff line number Diff line change
Expand Up @@ -6,7 +6,7 @@

- `gh` 已通过 Homebrew 安装:`gh version 2.86.0`。
- 用户已完成 `gh auth login`。
- `Notes/snippets/github-search.sh status` 已验证登录成功。
- `snippets/github-search.sh status` 已验证登录成功。
- repo / issue 搜索已完成烟测并返回结构化 JSON。

## 一次性授权
Expand All @@ -24,31 +24,31 @@ gh auth login
登录状态验证:

```bash
Notes/snippets/github-search.sh status
snippets/github-search.sh status
```

## Codex / 本仓库可用搜索入口

封装脚本:

```bash
Notes/snippets/github-search.sh
snippets/github-search.sh
```

示例:

```bash
# 搜开源仓库
Notes/snippets/github-search.sh repos "agent memory llm" 10
snippets/github-search.sh repos "agent memory llm" 10

# 在指定仓库里搜代码
Notes/snippets/github-search.sh code "memory router" openai/codex 10
snippets/github-search.sh code "memory router" openai/codex 10

# 搜 issue
Notes/snippets/github-search.sh issues "memory" openai/codex 10
snippets/github-search.sh issues "memory" openai/codex 10

# 搜 PR
Notes/snippets/github-search.sh prs "eval" openai/codex 10
snippets/github-search.sh prs "eval" openai/codex 10
```

脚本行为:
Expand All @@ -70,8 +70,8 @@ Notes/snippets/github-search.sh prs "eval" openai/codex 10
如果未来换机器、token 过期或搜索异常,重新执行:

```bash
Notes/snippets/github-search.sh status
Notes/snippets/github-search.sh repos "agent memory llm" 3
snippets/github-search.sh status
snippets/github-search.sh repos "agent memory llm" 3
```

如果返回 JSON,说明 GitHub 搜索能力可用。
2 changes: 1 addition & 1 deletion .trae/documents/OpenClaw配置优化与最佳实践.md
Original file line number Diff line number Diff line change
Expand Up @@ -108,7 +108,7 @@
5. ❌ 不要绑定到公网 IP(`0.0.0.0`)

### Git 操作最佳实践
1. ✅ 使用 `Notes/snippets/todo-push.sh` 和 `Notes/snippets/todo-pull.sh` 作为标准 git 操作流程
1. ✅ 使用 `snippets/todo-push.sh` 和 `snippets/todo-pull.sh` 作为标准 git 操作流程
2. ✅ todo-push.sh 白名单机制:仅允许 `Notes/`、`.trae/`、`创作/` 三个文件夹
3. ✅ todo-push.sh 黑名单机制:绝对禁止 `公司项目/` 文件夹
4. ✅ 在 commit 前检查 `git status`
Expand Down
8 changes: 4 additions & 4 deletions .trae/documents/OpenClaw集成方案.md
Original file line number Diff line number Diff line change
Expand Up @@ -209,7 +209,7 @@ python main.py "这是一条测试任务"

#### todo-sync Skill

**目标**: 调用 `Notes/snippets/todo-sync.sh`,从 Git 拉取最新代码并扫描新任务
**目标**: 调用 `snippets/todo-sync.sh`,从 Git 拉取最新代码并扫描新任务

**目录结构**:
```
Expand All @@ -221,15 +221,15 @@ cs-notes-todo-sync/

#### todo-push Skill

**目标**: 调用 `Notes/snippets/todo-push.sh` 和 `todo-push-commit.sh`,将本地更改推送到 Git
**目标**: 调用 `snippets/todo-push.sh` 和 `todo-push-commit.sh`,将本地更改推送到 Git

#### todo-prompt Skill

**目标**: 调用 `Notes/snippets/todo-prompt.py`,生成任务执行的 prompt
**目标**: 调用 `snippets/todo-prompt.py`,生成任务执行的 prompt

#### todo-manager Skill

**目标**: 调用 `Notes/snippets/todo-manager.py`,管理 todos 的状态
**目标**: 调用 `snippets/todo-manager.py`,管理 todos 的状态

## 完整闭环流程设计

Expand Down
6 changes: 3 additions & 3 deletions .trae/documents/PROJECT_CONTEXT.md
Original file line number Diff line number Diff line change
Expand Up @@ -30,7 +30,7 @@

### Pull(拉取)
- 指令:“pull” 或 “拉取”
- 执行:`./Notes/snippets/todo-pull.sh`
- 执行:`./snippets/todo-pull.sh`
- 功能:
- git pull 最新代码
- 扫描 Inbox 新任务
Expand All @@ -39,10 +39,10 @@
### Push(推送)
- 指令:“push” 或 “推送”
- 执行:
1. `./Notes/snippets/todo-push.sh`(生成变更摘要)
1. `./snippets/todo-push.sh`(生成变更摘要)
2. AI 分析变更摘要,生成 commit message
3. 向用户展示:commit message + 变更文件列表
4. 用户确认后执行:`./Notes/snippets/todo-push-commit.sh "<commit-message>"`
4. 用户确认后执行:`./snippets/todo-push-commit.sh "<commit-message>"`
- 隐私保护:
- 仅允许:Notes/、.trae/、创作/
- 绝对禁止:公司项目/
Expand Down
14 changes: 7 additions & 7 deletions .trae/documents/Todos-Web-Manager-Process-Oncall.md
Original file line number Diff line number Diff line change
Expand Up @@ -31,36 +31,36 @@
- 默认 `WEB_MANAGER_DEBUG=0`
- 仅当显式设置 `WEB_MANAGER_DEBUG=1` 时开启 debug/reloader

- `Notes/snippets/todos-web-manager/start.sh`
- `snippets/todos-web-manager/start.sh`
- 统一本地启动入口
- 启动前检查 `flask` / `flask_cors` 是否存在
- 默认只绑定 localhost
- 日志目录:`.local/todos-web-manager/logs/`

- `Notes/snippets/todos-web-manager/launchd/com.huangrt.csnotes.todos-web-manager.plist`
- `snippets/todos-web-manager/launchd/com.huangrt.csnotes.todos-web-manager.plist`
- `RunAtLoad=true`
- `KeepAlive.SuccessfulExit=false`
- `ThrottleInterval=30`
- stdout/stderr 固定写入 `.local/todos-web-manager/logs/`

- `Notes/snippets/todos-web-manager/install-launchd.sh`
- `snippets/todos-web-manager/install-launchd.sh`
- 安装并加载 LaunchAgent

- `Notes/snippets/todos-web-manager/uninstall-launchd.sh`
- `snippets/todos-web-manager/uninstall-launchd.sh`
- 卸载 LaunchAgent

## 使用方式

手动前台启动:

```bash
Notes/snippets/todos-web-manager/start.sh
snippets/todos-web-manager/start.sh
```

安装为 macOS 登录后常驻服务:

```bash
Notes/snippets/todos-web-manager/install-launchd.sh
snippets/todos-web-manager/install-launchd.sh
```

查看状态:
Expand All @@ -75,7 +75,7 @@ tail -f .local/todos-web-manager/logs/launchd.err.log
卸载:

```bash
Notes/snippets/todos-web-manager/uninstall-launchd.sh
snippets/todos-web-manager/uninstall-launchd.sh
```

## 后续建议
Expand Down
22 changes: 11 additions & 11 deletions .trae/documents/Todos-管理系统-架构与能力.md
Original file line number Diff line number Diff line change
Expand Up @@ -174,20 +174,20 @@ Lark 通知完成

### 3. 命令行工具

- `Notes/snippets/todo-push.sh` - Git push 标准操作流程
- `Notes/snippets/todo-pull.sh` - Git pull 标准操作流程
- `Notes/snippets/todo-push-commit.sh` - 带 commit message 的 push 脚本
- `Notes/snippets/todo_migrator.py` - Markdown → JSON 迁移工具
- `Notes/snippets/todo_sync.py` - JSON→Markdown 同步功能
- `Notes/snippets/add_todo_to_json.py` - 添加 todo 到 JSON 的工具
- `snippets/todo-push.sh` - Git push 标准操作流程
- `snippets/todo-pull.sh` - Git pull 标准操作流程
- `snippets/todo-push-commit.sh` - 带 commit message 的 push 脚本
- `snippets/todo_migrator.py` - Markdown → JSON 迁移工具
- `snippets/todo_sync.py` - JSON→Markdown 同步功能
- `snippets/add_todo_to_json.py` - 添加 todo 到 JSON 的工具

### 4. 任务执行能力

- `Notes/snippets/task_executor.py` - Task Executor,支持结构化日志输出、任务状态管理、阶段追踪、产物沉淀、指标计算
- `Notes/snippets/blog_monitor.py` - 博主监控脚本
- `Notes/snippets/context_completer.py` - 自动补全上下文脚本
- `Notes/snippets/speech_to_text.py` - 语音转文字脚本
- `Notes/snippets/voice_task_parser.py` - 语音任务解析器
- `snippets/task_executor.py` - Task Executor,支持结构化日志输出、任务状态管理、阶段追踪、产物沉淀、指标计算
- `snippets/blog_monitor.py` - 博主监控脚本
- `snippets/context_completer.py` - 自动补全上下文脚本
- `snippets/speech_to_text.py` - 语音转文字脚本
- `snippets/voice_task_parser.py` - 语音任务解析器

### 5. Plan Mode 能力

Expand Down
2 changes: 1 addition & 1 deletion .trae/documents/Trae-CLI-Proactive-Research-Brief.md
Original file line number Diff line number Diff line change
Expand Up @@ -74,7 +74,7 @@ trae chat [options] [prompt]
- `.trae/documents/trae-agent-评估报告.md`
- `.trae/documents/OpenClaw-vs-Trae-Agent-对比报告.md`
- `.trae/documents/我和trae-agent公平对比报告.md`
- `Notes/snippets/code-reading-trae-agent.md`
- `snippets/code-reading-trae-agent.md`

旧评估中的 `trae-agent` 与当前 Trae App CLI 不一定是同一个产品形态,但有两个判断仍然重要:

Expand Down
2 changes: 1 addition & 1 deletion .trae/documents/失败尝试记录.md
Original file line number Diff line number Diff line change
Expand Up @@ -36,7 +36,7 @@ pip install playwright --break-system-packages
playwright install chromium

# 运行 Playwright 抓取脚本
python3 Notes/snippets/playwright_simple.py "https://www.zhihu.com/question/1999487395494588876/answer/2000362433332660070?share_code=HGYNzglkEV8h&utm_psn=2000559952910099841" --save-html /tmp/zhihu-article.html --output /tmp/zhihu-result.json
python3 snippets/playwright_simple.py "https://www.zhihu.com/question/1999487395494588876/answer/2000362433332660070?share_code=HGYNzglkEV8h&utm_psn=2000559952910099841" --save-html /tmp/zhihu-article.html --output /tmp/zhihu-result.json
```

**错误信息:**
Expand Down
2 changes: 1 addition & 1 deletion .trae/openclaw-skills/_docs/README.md
Original file line number Diff line number Diff line change
Expand Up @@ -47,7 +47,7 @@ Todo 管理 - 管理 CS-Notes 项目中的 todo 任务。

**使用方法:**
```bash
cd /root/.openclaw/workspace/CS-Notes/Notes/snippets/
cd /root/.openclaw/workspace/CS-Notes/snippets/
python3 todo-manager.py
```

Expand Down
2 changes: 1 addition & 1 deletion .trae/openclaw-skills/cs-notes-todo-sync/README.md
Original file line number Diff line number Diff line change
Expand Up @@ -4,7 +4,7 @@ OpenClaw Skill,用于拉取 Git、扫描任务、生成执行提示。

## 功能

- 调用 `Notes/snippets/todo-pull.sh`
- 调用 `snippets/todo-pull.sh`
- 拉取 Git 最新代码
- 扫描 Inbox 中的新任务
- 生成待执行任务提示清单
Expand Down
2 changes: 1 addition & 1 deletion .trae/openclaw-skills/todo-manager/SKILL.md
Original file line number Diff line number Diff line change
Expand Up @@ -18,7 +18,7 @@ description: Todo 管理 - 管理 CS-Notes 项目中的 todo 任务,包括任
### 运行 Todo 管理

```bash
cd /root/.openclaw/workspace/CS-Notes/Notes/snippets/
cd /root/.openclaw/workspace/CS-Notes/snippets/
python3 todo-manager.py
```

Expand Down
2 changes: 1 addition & 1 deletion .trae/openclaw-skills/top-lean-ai-monitor/SKILL.md
Original file line number Diff line number Diff line change
Expand Up @@ -18,7 +18,7 @@ description: Top Lean AI 榜单监控 - 监控 Top Lean AI 榜单的变化,记
### 运行监控

```bash
cd /root/.openclaw/workspace/CS-Notes/Notes/snippets/
cd /root/.openclaw/workspace/CS-Notes/snippets/
python3 top_lean_ai_monitor.py
```

Expand Down
8 changes: 4 additions & 4 deletions .trae/rules/project_rules.md
Original file line number Diff line number Diff line change
Expand Up @@ -39,7 +39,7 @@
- 拿到任务后第一时间标记为 in-progress
- 新建 session 不会再次选择这个任务
* **【强制】任务执行可观测闭环**:
- **所有任务执行必须使用 task_execution_logger**(`Notes/snippets/task_execution_logger.py`)
- **所有任务执行必须使用 task_execution_logger**(`snippets/task_execution_logger.py`)
- 开始任务前:调用 `logger.start_task(task_id)`
- 执行中:记录关键步骤日志(`logger.log_info`、`logger.log_debug` 等)
- 完成任务:调用 `logger.complete_task(task_id)`
Expand All @@ -52,7 +52,7 @@
- **OpenClaw**:独立的 AI 助手系统,有自己的记忆(`.openclaw-memory/`)和规则(`.openclaw-memory/AGENTS.md`),主要用于自主推进 todo
- **共享资源**:两者共享同一个工作空间,包括 todos.json、task_execution_logger 等
- **统一数据源**:都使用 `.trae/todos/todos.json` 作为任务数据源
- **统一日志系统**:都使用 `Notes/snippets/task_execution_logger.py` 记录执行日志和指标
- **统一日志系统**:都使用 `snippets/task_execution_logger.py` 记录执行日志和指标
- **避免冲突**:priority-task-reader 保证只返回 pending 状态的任务,拿到任务后第一时间标记为 in-progress
* **OpenClaw 的核心价值**:
- 可以在后台自主推进任务,不阻塞用户与 Trae 的交互
Expand All @@ -67,7 +67,7 @@
- 向用户报告进度,不要等待用户询问
- 进度报告要包含:百分比、预估剩余时间
* **Git 操作 SOP(第一原则:公司项目文档绝对不能 push 到 git)**:
- **公用 Skill 能力**:使用 `Notes/snippets/todo-push.sh` 和 `Notes/snippets/todo-pull.sh` 作为标准 git 操作流程
- **公用 Skill 能力**:使用 `snippets/todo-push.sh` 和 `snippets/todo-pull.sh` 作为标准 git 操作流程
- **todo-push.sh 白名单机制**:仅允许 `Notes/`、`.trae/`、`创作/` 三个文件夹
- **todo-push.sh 黑名单机制**:绝对禁止 `公司项目/` 文件夹
- **todo-push.sh 排除模式**:排除 `.trae/logs/`、`*.pyc`、`__pycache__/`、`.DS_Store`
Expand Down Expand Up @@ -180,7 +180,7 @@
- 支持任务筛选、搜索、排序
- 支持导出任务 JSON
* **可用工具**:
- `Notes/snippets/todo_migrator.py` - Markdown → JSON 迁移工具(已完成迁移)
- `snippets/todo_migrator.py` - Markdown → JSON 迁移工具(已完成迁移)
- `.trae/web-manager/simple-server.py` - 简单 HTTP 服务器(无需 Flask)
- `.trae/web-manager/server.py` - Flask 后端(待修复 blinker 包冲突)
* **JSON 数据结构**:
Expand Down
Loading