@jun133/athlete 0.0.5 → 0.0.6

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/README.md

@@ -1,47 +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`
-- `P20-外部事实必须绑定证据.md`
-- `P21-没验过就不能收口.md`
-- `P22-阶段推进必须有机器状态.md`
-- `P23-文本链路必须稳定可读.md`
-- `P24-错误兼容不能高于正确性.md`
-
-## 使用规则
-
-1. 新原则必须长期有效，且跨多个模块成立。
-2. 临时实现细节不要升格成原则。
-3. 若与当前实现冲突，应优先修正文档或实现，不能长期并存。
-4. 若只是模块约束，优先写到 `modules/`、`implementation/` 或 `adr/`。
-5. Athlete 仍处于高频重构阶段；错误旧逻辑、错误旧测试、错误旧兼容如果阻碍主干修复，应删除或重写，不为错误行为保活。
-6. 本项目当前优先级是“正确、稳定、可维护”，不是“尽量少改旧代码”。
-7. 若任务存在显式 acceptance / closeout 契约，该契约也是机器真相源的一部分；缺文件、缺证据、缺验证都不能收口。

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,108 +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 路由没坏
-- provider capability / fallback / reasoning 行为没坏
-- browser capability workflow guard / priority 没坏
-- document capability / acceptance signal 没坏
-- one-shot closeout contract 没坏
-- interactive quit guard 不会漏掉运行中的后台进程
-- 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
-- unified acceptance signals
-- orchestrator routing / dispatch
-- protocol / policy / task board truth source
-- Playwright 默认值与 artifact 路由
-- browser capability-first tool priority
-- shell detour workflow guard
-- provider capability profile
-- document-read capability routing / phase advance
-- one-shot CLI terminal closeout
-- interactive quit kill-or-continue confirmation
-- 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 验证
-6. 生态去耦类测试要优先保护“上层不认生态字符串，只认 capability / signal / transition”。
-
-## 不建议的做法
-
-- 为了数量堆很多低价值小测试
-- 把不稳定的真实 API 测试塞进默认 `npm test`
-- 只测 prompt 文案，不测底层机器状态