Imported from Benboerba620/ai-workspace-hub (system/templates/AGENTS.md). Install upstream with npx skills add Benboerba620/ai-workspace-hub --skill templates. Copyright stays with the author.

AI Workspace Instructions

这个 repo 是一个 all-in-one AI 研究工作系统，包含六大能力。Codex 进入本目录后，先读本文件，再读 workspace/workspace-config.md。

本文件与 CLAUDE.md 保持同一套工作协议。两者内容应当同源，改一个就同步另一个。研究对象、状态和 ID 统一遵循 system/integrations/object-model.md。

工作方式

• 默认使用中文。
• 事实、推测、待验证必须分开。
• 优先使用本地文件。
• 删除、覆盖、发布、推送前必须确认。

核心路由

先读 workspace/workspace-config.md。非简单任务按其中"三条简单规则"执行。

路径约定：本文件和各 skill 中的 wiki/ 是默认示例。若 workspace-config.md 的 wiki_root 不是 ./wiki，所有 wiki 读写都以配置值为根目录，不要同时写入本地 wiki/。

六大能力

工具代码在 tools/ 目录下。首次使用时 agent 检查依赖，缺什么用 python3 -m pip install ... 安装；如果环境只有 python，再替换成 python -m pip ...。

状态与确认

• Markdown frontmatter 是研究、假设和证据“当前状态”的唯一来源；正文只保存分析与历史。
• config/daily-watchlist-watchlist.md 是日报执行股票池的唯一来源；workspace/monitoring/ 只是用户看板。
• 旧工作区如果已有 daily-watchlist-reports/、monitoring/ 或 _archive/，继续读取原位置，不自动搬动用户文件；新工作区分别使用 output/daily-watch/、workspace/monitoring/ 和 workspace/archive/。
• wiki 沉淀、假设状态调整、股票池新增、研究偏好固化等需要确认的动作，先追加到 workspace/review-queue.md，不能只留在对话里。
• 研究开始时必须先运行 research_preflight.py --context ... --research-id ... --research-file ... --record，加载命中的 rule / pattern / exploration 并扫描相关 entity / concept / source；打开命中页面全文后才联网。
• 研究报告必须记录 preflight_id / knowledge_used / wiki_pages_loaded 和 Wiki check；扫描失败可以人工降级，但不能静默跳过。
• 新建、复盘或改变知识状态后运行 knowledge_lifecycle.py rebuild-index --apply；三类 _index.md 是自动生成的加载路由，不手工堆证据。
• 用户说“看看现在该做什么”时，运行 python system/scripts/workspace_status.py（macOS/Linux 可用 python3）。

active-context：断点续传

workspace/meta/active-context.md 是工作记忆，支撑"今天停、明天接"。只记最近 1-2 周仍有价值的上下文，单条一行。两条规则配套，自动执行，不必询问用户：

• 续接（开场自动读）：用户开场出现"继续 / 接着 / 昨天 / 上次"等延续信号 → 第一动作就是读 active-context.md，顺着最新一条的「续接锚点」接上，不要让用户重新交代上下文。
• 断点（结束自动写）：满足任一条件即在「最近对话延续」段追加一行——① 用户说"今天到此 / 先到这吧 / 明天继续 / 暂停 / 保存进度"；② 一段工作落盘、做出决策、或长对话自然收尾。

格式（一条一行）：

- **YYYY-MM-DD：主题（状态）** -> 文件路径 + 一句话摘要 + 续接锚点

状态标签：PAUSED 半成品 / DONE 完成 / 决策 决定。

上限与自动清理（写断点时顺手做，不另外问用户）：「最近对话延续」段有三道闸门——① 日期：超过 14 天的条目整条剪到 workspace/meta/active-context-archive-YYYY-MM.md（不丢续接锚点）；② 条数：剪完仍超 20 条时，最旧的几条一并归档；③ 行长：单条正文超 1500 字节时，全文进归档、原地只留一行索引（标题 + 文件路径 + 存档指针）。第三道管的是前两道够不着的地方——一条写成小作文的条目既不老也不多，却能单独吃掉整个文件的预算。

写完断点跑一次脚本即可，不要手工搬运：

python3 system/scripts/prune_active_context.py           # dry-run，先看会剪什么
python3 system/scripts/prune_active_context.py --apply   # 确认后执行

脚本只动「最近对话延续」段；「当前关注」「待办」这类状态段需要人判断，一个字节都不碰。同日同主题用"改"不用"新增"，避免堆叠。

最小试跑（基座，零依赖）

用户可以直接说：

把 inbox/first-note.md 整理进 personal wiki。

Codex 应该创建一篇 wiki/sources/YYYY-MM-DD-first-note.md，并在 workspace/meta/active-context.md 记录本次试跑结果。这条链路只读写 markdown，不需要安装任何依赖。

数据源

配置在 config/*.env 中，配了才用，没配降级不报错。

获取方式：

• Longbridge：https://open.longbridge.com/zh-CN/skill/
• tushare：https://tushare.pro/register
• FMP：https://financialmodelingprep.com/

friction-log：同一个坑不打第二次补丁

执行中出现绕路、重试、数据源异常、文档写的步骤和实际对不上——当场追加一条到 workspace/meta/friction-log.md，不等用户问。每条写清楚：场景 / 摩擦 / 原因判断 / 改法 / 范围（一次性 · 项目级 · 全局级）。

硬规则：同一个问题第 2 次出现时，禁止再打补丁。 第一次可以就地绕过并记录；第二次说明病灶在机制里，只有两条路——

1. 当场修根：改脚本默认值、改 skill 的步骤、改目录约定，让这类问题不可能再犯；
2. 修根成本确实高，就把成本和方案摆出来让用户拍板，不要自己悄悄再绕一次。

理由：补丁的成本摊在未来每一次执行上，修根只付一次。同一个绕路走到第三回，之前所有"这次先这样"加起来早就超过修根的开销了，而且此时没人记得当初为什么要绕。

范围决定归宿：一次性的记进日志就够；项目级和全局级的，日志只记 why，修改要落到机制本身（脚本 / skill / 模板）。

系统维护（防臃肿）

• 装好上手后一次性瘦身：system/skills/post-install-cleanup.md（清安装脚手架 + 精简必读文件）。
• 每周结构体检、给精简建议：system/skills/structure-health.md。
• active-context 三道闸门：python3 system/scripts/prune_active_context.py --apply。