@jun133/athlete 0.0.4 → 0.0.6

package/spec/modules//346/211/251/345/261/225/346/234/272/345/210/266.md

@@ -1,105 +0,0 @@
-# 扩展机制
-
-## 当前扩展口
-
-Athlete 当前有 3 个标准扩展口：
-
-1. tools：负责动作
-2. skills：负责按需 workflow 与知识
-3. MCP：负责接外部能力源
-
-## skill 当前状态
-
-skills 已经是标准化 V1，而不是散装 prompt 片段。
-
-当前主要实现：
-
-- `src/skills/types.ts`
-- `src/skills/schema.ts`
-- `src/skills/discovery.ts`
-- `src/skills/matching.ts`
-- `src/skills/loading.ts`
-- `src/skills/state.ts`
-- `src/skills/workflowGuards.ts`
-- `src/skills/prompt.ts`
-
-## 当前 workflow skill
-
-当前仓库已落地的关键 workflow skill：
-
-- `test-guardrails`
-- `spec-alignment`
-- `mineru-pdf-reading`
-- `mineru-image-reading`
-- `mineru-doc-reading`
-- `mineru-ppt-reading`
-- `web-research`
-- `browser-automation`
-
-MinerU 文档 workflow 现在按类别拆成独立工具：
-
-- `mineru_pdf_read`
-- `mineru_image_read`
-- `mineru_doc_read`
-- `mineru_ppt_read`
-
-## web-research / browser-automation 的边界
-
-这两个 skill 现在已经是真实 workflow，而不是占位文档。
-
-职责边界：
-
-- `web-research`
-  - 何时先搜
-  - 何时打开网页
-  - 何时提取信息
-  - 何时总结
-  - 何时落文档
-- `browser-automation`
-  - 何时导航
-  - 何时 snapshot
-  - 何时 click / type
-  - 何时 screenshot
-  - 何时做网页交互
-
-不负责：
-
-- 实现浏览器 transport
-- 取代 MCP / tool
-
-## 联网能力分层
-
-当前分层是：
-
-1. MCP / tools
-   - 提供真实浏览器能力
-   - 当前优先是官方 `@playwright/mcp`
-2. workflow skill
-   - 提供使用策略
-   - 当前是 `web-research` 与 `browser-automation`
-
-设计原则：
-
-- 联网能力先做成 `tool` 或 `MCP`
-- `skill` 只做 workflow
-- 不把底层联网继续堆进 `systemPrompt`
-
-## 当前接线点
-
-当前 skill / MCP / runtime 的接线点：
-
-- `src/context/projectContext.ts`
-- `src/tools/skills/loadSkillTool.ts`
-- `src/agent/systemPrompt.ts`
-- `src/agent/runTurn.ts`
-- `src/tools/runtimeRegistry.ts`
-- `src/mcp/registryIntegration.ts`
-
-## 当前约束
-
-当前扩展仍必须满足：
-
-- 不破坏 continuation / compact / recovery
-- 不让主循环继续长胖
-- 不新造平行技能体系
-- 不让 MCP 绕开统一 registry

package/spec/overview/v0/350/214/203/345/233/264.md

@@ -1,54 +0,0 @@
-# v0 范围
-
-## 当前已在范围内
-
-### 运行时
-
-- 单 turn 主循环
-- 自动 continuation
-- 上下文压缩
-- verification 状态机
-
-### 工具与执行
-
-- 文件读写与补丁修改
-- shell 执行
-- docx / spreadsheet 基础能力
-- background job
-
-### 控制面
-
-- 任务板持久化
-- teammate 名册与 inbox
-- 协议请求与审批状态
-- worktree 绑定与隔离
-
-### 扩展
-
-- 项目指令发现
-- skill catalog 发现与按需加载
-- MCP 工具接入
-
-## 当前不在范围内
-
-- 图形化编排平台
-- 跨项目长期人格记忆
-- 全自动自治 swarm
-- 复杂经济系统、积分系统、市场化调度
-- 大而全行业平台能力
-
-## 下一阶段新增范围
-
-1. 主 Agent 的总指挥层
-2. 更清晰的任务拆分与派工规则
-3. skills 的标准声明与加载协议
-4. reviewer / verifier / planner 这类专门角色的演进边界
-
-## 范围控制规则
-
-如果一个新需求同时满足下面两条，应该延后：
-
-- 会削弱当前“耐跑底盘”
-- 不能明显增强“总指挥层”或 “skills 扩展口”
-
-当前阶段优先做“更会组织”，不是“看起来更全能”。

package/spec/overview//344/272/247/345/223/201/345/256/232/344/271/211.md

@@ -1,59 +0,0 @@
-# 产品定义
-
-## Athlete 是什么
-
-Athlete 是一个终端优先的 AI harness。
-
-它不是“在命令行里聊天”，而是一套让模型持续做任务的运行系统：
-
-- 能调用工具
-- 能持久化任务状态
-- 能续跑长任务
-- 能把慢操作放后台
-- 能按需调用子智能体或队友
-
-## 当前核心定位
-
-当前 Athlete 的核心定位是：
-
-**一个耐跑、可续跑、面向复杂任务的终端智能体框架。**
-
-它现在最强的价值不是“最会聊天”，而是：
-
-- 不容易中途断掉
-- 出错后会继续排查
-- 长任务能自动续跑
-- 多步任务有状态落盘
-
-## 下一阶段定位
-
-下一阶段 Athlete 的定位是：
-
-**一个以耐跑主 Agent 为核心、能够统筹任务与技能扩展的总指挥型智能体平台。**
-
-关键词：
-
-- 主 Agent 很强
-- 复杂任务时会拆分与调度
-- skills 是标准扩展口
-- 多 Agent 是按需能力，不是默认军团
-
-## 目标用户
-
-### 当前主要用户
-
-- 会在终端里工作的开发者
-- 想研究 agent harness 架构的维护者
-
-### 未来扩展用户
-
-- 需要多步自动化的人
-- 需要文档、表格、资料整理等复杂任务的人
-- 想给 agent 增加行业技能的人
-
-## 非目标
-
-- 不做拖拽式工作流平台
-- 不做纯聊天机器人
-- 不追求“默认一堆 agent 同时乱跑”
-- 不把长期人格记忆作为当前阶段的核心卖点

package/spec/principles/P17-/346/211/251/345/261/225/351/235/240/344/272/213/344/273/266/347/224/237/351/225/277.md

@@ -1,32 +0,0 @@
-# P17 扩展靠事件生长
-
-## 原则
-
-扩展不能只靠往 system prompt 里继续堆规则，应该沿着清晰的扩展点生长。
-
-## 为什么
-
-Athlete 未来一定会长：
-
-- skills
-- 更多工具
-- 更多角色
-- 更多运行时通知
-
-如果没有扩展点，主循环和工具层都会越来越胖。
-
-## 在 Athlete 里的含义
-
-当前扩展入口主要有三种：
-
-- tool registry
-- skills
-- MCP
-
-下一阶段要补的是更明确的 runtime / lifecycle 事件点。
-
-## 当前对应
-
-- `src/tools/runtimeRegistry.ts`
-- `src/skills/catalog.ts`
-- `src/mcp/`

package/spec/principles/P18-/344/270/273/345/276/252/347/216/257/345/222/214/346/226/207/344/273/266/351/203/275/344/270/215/350/203/275/351/225/277/350/203/226.md

@@ -1,36 +0,0 @@
-# P18 主循环和文件都不能长胖
-
-## 原则
-
-主循环不能无限长，文件也不能无限长。
-
-## 为什么
-
-Athlete 以后会继续长总指挥层、skills、角色和协议。
-
-如果不控制体积：
-
-- AI 更容易改坏系统
-- 人更难定位职责
-- 小改动会牵动全身
-
-## 铁律
-
-1. 单文件默认不超过 300 行。
-2. 文件超过 300 行时，必须先检查是不是职责耦合。
-3. 只要出现“一个文件里有两件以上主要事情”，优先拆目录或拆文件。
-4. 主循环只保留全局调度规则，不塞模块细节。
-
-## Athlete 当前阶段的执行方式
-
-- 优先新增目录，不优先堆到已有大文件
-- 一类状态一个 store
-- 一类工具一个子目录
-- 一类角色一个清晰边界
-
-## 当前对应
-
-- `src/agent/runTurn.ts`
-- `src/tools/`
-- `src/team/`
-- `src/tasks/`

package/spec/principles/README.md

@@ -1,39 +0,0 @@
-# 宪法原则
-
-这一组文档是 Athlete 当前唯一有效的架构原则集合。
-
-它们直接服务于实现与维护。
-
-## 当前原则体系
-
-### 核心 12 条
-
-- `P01-一个循环一个智能体.md`
-- `P02-加一个工具只加一个处理器.md`
-- `P03-先计划再动手.md`
-- `P04-大任务拆给子智能体.md`
-- `P05-知识按需加载.md`
-- `P06-上下文要能压缩.md`
-- `P07-任务图要落盘.md`
-- `P08-慢操作放后台.md`
-- `P09-任务太大就分给队友.md`
-- `P10-队友之间要有统一协议.md`
-- `P11-队友自己认领任务.md`
-- `P12-工作区和任务要隔离.md`
-
-### 当前工程铁律
-
-- `P13-session是任务现场.md`
-- `P14-执行约束不是安全策略.md`
-- `P15-provider必须可替换.md`
-- `P16-配置只能有一个入口.md`
-- `P17-扩展靠事件生长.md`
-- `P18-主循环和文件都不能长胖.md`
-- `P19-先写失败测试再写实现.md`
-
-## 使用规则
-
-1. 新原则必须长期有效，且跨多个模块成立。
-2. 临时实现细节不要升格成原则。
-3. 若与当前实现冲突，应优先修正文档或实现，不能长期并存。
-4. 若只是模块约束，优先写到 `modules/`、`implementation/` 或 `adr/`。

package/spec/repo//345/274/200/345/217/221/350/247/204/345/210/231.md

@@ -1,39 +0,0 @@
-# 开发规则
-
-## 总则
-
-Athlete 是 harness 工程，不是一次性脚本。
-
-所有改动优先保护：
-
-1. 耐跑底盘
-2. 控制面真相
-3. 扩展边界
-
-## 文件规则
-
-1. 单文件默认不超过 300 行。
-2. 超过 300 行时必须检查是不是耦合过多。
-3. 能拆目录就拆目录，能拆文件就拆文件。
-4. 一个文件只做一件主要事情。
-5. 一个模块尽量只保留一个主要变更理由。
-
-## 架构规则
-
-1. 控制面判断不偷塞进工具细节。
-2. 工具只通过注册表接入。
-3. 新状态优先进入现有真相源，不先新建平行 JSON。
-4. skills 负责知识与流程，不替代工具动作。
-5. 总指挥层负责调度，不负责具体文件改写。
-
-## 文档规则
-
-1. SPEC 写当前真实能力与未来方向，但两者必须分开。
-2. docs 偏解释和维护，spec 偏约束和边界。
-3. ADR 只记录关键决定，不拿来写宣传。
-
-## 测试规则
-
-1. 关键骨架改动先补失败测试。
-2. 修过的真实 bug 尽量固化成回归测试。
-3. 不为了覆盖率堆低价值测试。

package/spec/repo//346/234/254/345/234/260/345/221/275/344/273/244/344/270/216/346/265/201/347/250/213.md

@@ -1,32 +0,0 @@
-# 本地命令与流程
-
-## 常用命令
-
-```powershell
-npm install
-npm run build
-npm run typecheck
-npm test
-npm run dev
-```
-
-## 推荐开发流程
-
-1. 先确认改动落在哪一层
-2. 先补或设计测试
-3. 再改实现
-4. 运行 `npm test`
-5. 最后更新 SPEC / docs
-
-## 写 SPEC 的流程
-
-1. 先写当前真实能力
-2. 再写未来方向
-3. 检查有没有把两者混在一起
-4. 检查单文件是否过胖
-
-## 写代码的流程
-
-1. 先找真相源
-2. 再找工具入口
-3. 最后再看 UI 是否要同步

package/spec/testing/fail-first-/347/254/254/344/270/200/346/211/271/346/265/213/350/257/225/345/210/227/350/241/250.md

@@ -1,11 +0,0 @@
-# fail-first 第一批测试列表
-
-## 先补的测试
-
-1. 总指挥层不会破坏现有 continuation
-2. 总指挥层不会绕过 task board 真相源
-3. lead 能在 subagent / teammate / background 之间做正确分流
-4. skills 元数据缺失时有明确失败结果
-5. skill 加载后能被后续 turn 正确识别
-6. reviewer / verifier 角色不会越权修改任务分配
-7. 单文件拆分后 registry 与 runtime 行为不变

package/spec/testing/fixtures-/350/247/204/350/214/203.md

@@ -1,20 +0,0 @@
-# fixture 规范
-
-## 原则
-
-fixture 只保留能说明问题的最小状态。
-
-## 推荐 fixture 类型
-
-- task board 样例
-- protocol request 样例
-- team inbox 样例
-- worktree index 样例
-- compact / resume session 样例
-- skill metadata 样例
-
-## 规则
-
-1. 一个 fixture 只服务一个测试主题。
-2. 不把大量无关状态塞进同一个 fixture。
-3. 真实 bug 的 fixture 优先长期保留。

package/spec/testing//346/265/213/350/257/225/347/255/226/347/225/245.md

@@ -1,97 +0,0 @@
-# 测试策略
-
-## 目标
-
-测试优先保护 Athlete 的骨架，
-不是为了表面覆盖率。
-
-## 当前重点
-
-- 主循环没坏
-- context / continuation / recovery 没坏
-- lightweight context externalization 没坏
-- checkpoint / reload / resume 没坏
-- runtime stats / runtime summary 没坏
-- task / background 没坏
-- team / protocol / policy 没坏
-- worktree isolation 没坏
-- skill catalog 与 skill loading 没坏
-- Playwright MCP 接线、优先级与 artifact 路由没坏
-- post-completion closeout 不会退回无意义循环
-
-## 当前测试类型
-
-### 1. 骨架测试
-
-保护架构约束，不让主骨架被改坏。
-
-### 2. 缺陷回归测试
-
-真实 bug 修掉后，把 bug 固化成测试。
-
-### 3. 结构预算测试
-
-保护主循环和关键控制面文件不继续长胖。
-
-## 当前已覆盖的重点
-
-- runtime registry / tool visibility
-- skill metadata / discovery / loading / gating
-- continuation / compact / recovery
-- lightweight context externalization
-- checkpoint 持久化 / reload / resume
-- runtime metrics 持久化 / reload / summary
-- finalize / closeout gating
-- lightweight verification signals
-- orchestrator routing / dispatch
-- protocol / policy / task board truth source
-- Playwright 默认值与 artifact 路由
-- browser-first tool priority
-- shell detour workflow guard
-- post-completion todo/task loop prevention
-
-## 命令
-
-默认本地测试：
-
-```powershell
-npm test
-```
-
-只做测试编译：
-
-```powershell
-npm run test:build
-```
-
-核心测试集：
-
-```powershell
-npm run test:core
-```
-
-真实 API 验证（不进入默认 `npm test`）：
-
-```powershell
-npm run verify:runtime-context-api
-npm run verify:runtime-checkpoint-api
-npm run verify:runtime-observability-api
-```
-
-## 当前原则
-
-1. 骨架测试优先。
-2. 回归测试优先。
-3. 默认测试不要强依赖不稳定外部 API。
-4. 真实 API / 真实浏览器验证可以做，但不要强塞进默认 `npm test`。
-5. runtime observability 这类能力必须同时覆盖：
-   - 结构化持久化
-   - reload 后一致性
-   - 用户可读 summary
-   - 真实 API 验证
-
-## 不建议的做法
-
-- 为了数量堆很多低价值小测试
-- 把不稳定的真实 API 测试塞进默认 `npm test`
-- 只测 prompt 文案，不测底层机器状态