dongshuyan/compass-skills

What it solves

COMPASS Skills 解决了长时间运行的 AI 代理工作流中状态和上下文丢失的问题。它通过在本地管理用户偏好、项目进度和任务依赖，避免必须重放完整的对话记录，确保代理在不同会话之间仍然与用户目标保持一致。

How it works

该项目提供一组可安装到 AI 编码代理（如 Claude Code 或 Codex）的 SKILL.md 包。这些技能使用 Markdown 指令和本地 Python 脚本来实现特定工作流：

• State Management：维护本地用户配置文件以记录沟通偏好，并在仓库内部创建任务图（DAG）以追踪目标和子任务。
• Alignment：澄清门在执行前通过聚焦问题将模糊或高风险任务缩小范围。
• Continuity：将当前对话状态压缩成可直接粘贴的提示，用于新的 AI 会话。
• Meta-Programming：提供工具将成功的运行历史转化为可复用的新技能，或基于真实证据升级已有技能。

Who it’s for

适用于使用 AI 编码代理、管理复杂长期项目的开发者，需要一种结构化方式来保持上下文、跟踪进度，并确保代理不偏离原始目标。

Highlights

• Local-First Privacy：所有任务和配置数据均存储在本地，绝不上传至外部服务器。
• Task Forest：可视化的任务图，跨越对话边界仍然保存。
• Session Handoff：专用的提示生成器，实现 AI 对话之间的无缝切换。
• Skill Engineering：从观察到的代理运行历史直接构建和精炼技能的工具。