🔄 AI Workspace Improver

从真实使用中发现问题，让个人 AI Workspace 持续变好

选择 Workflow · 快速开始 · 报告与验收 · Roadmap

中文 · English

---

ai-workspace-improver 是个人 AI Workspace 的持续改进入口。它从历史会话和当前资产中发现真实痛点，分析 Token 使用，并把值得保留的经验交给合适的知识或内容流程。

它的基本原则很简单：一次只处理一个问题域，先提交可判断的报告，用户验收后再把未解决事项写入 Todo。复盘和修复分开进行，避免长任务因上下文不足而半途而废。

📋 选择 Workflow

Workflow	适合什么时候用	结果	状态
W1 会话与协作复盘	回顾近期对话、项目协作或 Skill 使用体验	用户痛点、反复纠正、资产缺口和新需求	Stable core
W2 AI Asset Health Check	检查 Skill、prompt、agent、guidance、文档和仓库	冲突、冗余、同步 drift 与卫生问题	Beta
W3 Token 效率分析	找出高消耗任务及可验证的省 Token 方法	消耗模式、原因判断和优化实验	Beta
W4 知识与内容整理	整理选定的 Idea、经验或 AI bad case	Todo、长期笔记或内容草稿	Planned
W5 Improver 演进评审	审查本 Skill 的能力、优先级和 Roadmap	成熟度判断与后续建设计划	Beta

每次任务只运行一个 Workflow。W1、W3 和 W4 可以观察同一时期的会话，但状态彼此独立；W2 可以单独或定期运行；W5 根据重要反馈和里程碑执行。只有出现明确关联证据时，才会建议在新任务中继续其他 Workflow。

完整关系见 Roadmap。

🚀 快速开始

安装

# Windows
git clone https://github.com/JackySummerfield/ai-workspace-improver.git "%USERPROFILE%\.agents\skills\ai-workspace-improver"

# macOS / Linux
git clone https://github.com/JackySummerfield/ai-workspace-improver.git ~/.agents/skills/ai-workspace-improver

需要 Python 3.10+，并允许 AI 助手读取待分析的本地会话或工作区文件。W3 还需要可靠的 Token telemetry；当前可使用用户自行安装的 ccusage 读取 Codex session。W2 不需要历史会话。

直接描述你要解决的问题

每日回顾

对 ai-workspace-improver 做一次 W2 Targeted Deep Health Check，先只生成报告

分析最近哪些任务最耗 Token，并给出可验证的优化实验

整理这次项目中的经验和 AI bad case

每日回顾 默认进入 W1。W4 仍在规划中；现阶段会明确组合已有的知识与写作 Skills，不会假装已具备完整 Workflow。

✅ 报告与验收

一份合格的报告会讲清楚：发生了什么、为什么重要、问题是否仍存在、建议做什么，以及不处理的实际影响。统计数字和内部术语不会代替结论。

• 接受：未解决事项写入 Todo，随后推进对应 Workflow 的状态。
• 修改：保留当前分析范围，根据反馈修订报告。
• 拒绝：不消耗待复盘会话，也不记录为已验收。

W1 默认只处理尚未验收的新会话；来源过长时会分批完成。各 Workflow 分别维护自己的运行状态，不会互相推进 cursor。复盘任务不会顺手修改其他资产，后续从 Todo 逐项实施。

🔐 隐私与边界

• 原始聊天、命令、工具输出、凭据和 Token 不写入报告、Todo 或 Git。
• 缺少可靠 telemetry 时会直接说明，不用字符数冒充 Token。
• 不自动安装工具、启动服务、修复资产、提交、推送或发布。
• 工作区健康状态只有影响实际使用或需要用户决定时，才会成为主要发现。

🗺️ Roadmap

当前重点是让五个 Workflow 形成稳定、相互独立又可交接的能力：完善 W1 的多类资产识别；验证 W2 的内容、同步和卫生检查；把 W3 扩展为可接入 Codex、Hermes 等来源的 adapter；组合现有知识与写作 Skills 建设 W4；用 W5 持续校正优先级。

详细阶段、验收条件和明确不做的事项见 AI Workspace Improver Roadmap。

🛠️ 开发与验证

python -m unittest discover -s tests -v
python scripts/validate_review_report.py reviews/review_YYYY-MM-DD.md
python scripts/collect_chat_history.py --state-summary

核心 Workflow 的兼容性决策和历史沿革保存在能力迁移矩阵，不占用用户使用说明的主线。

License

MIT License. See LICENSE.