open-code-kit 不再是只包含少量工作流的个人工具箱。 它现在以经过筛选的 Skill 快照为核心，同时保留 opencode-peek 作为 OpenCode 会话可观测性插件。

核心是可追溯的 Skill 快照

仓库提交的是已筛选、可复用的 Skill，而不是自动跟踪上游的聚合器。每个 Skill 的 SKILL.md 定义触发条件、前置条件和安全边界；上游更新需要人工核验后再导入。

规范目录与分发目录并存：

open-code-kit/
├── .opencode/skills/  # 规范集合
├── .agents/skills/    # 面向其他 Agent 的对应分发目录
├── packages/
│   └── opencode-peek/ # OpenCode 会话 transcript 插件
└── assets/

修改 Skill 后，用下面的命令同步两个目录：

tar -C .opencode/skills -cf - . | tar -C .agents/skills -xf -

这也意味着仓库的内容以已提交文件为准。导入上游版本时，应同时更新 Skill 本体、所需支持文件、来源链接和核验日期，避免把“上游最新”误认为“当前可用”。

当前收录十类 Agent 能力

分类	Skill	用途
调研	agent-reach	路由网页、社交媒体、视频与 GitHub 调研任务
AI 资讯	aihot	从 AI HOT 获取中文 AI 资讯
位置服务	amap-lbs-skill	POI 搜索、路线规划与地图数据可视化
设计	brainstorming	将模糊需求收敛为可审阅的设计
工程	diagnosing-bugs	通过紧密复现环定位缺陷和性能回归
工程	grilling	以设计树逐轮压力测试计划、决策或想法
协作	lark-skills	使用飞书/Lark CLI 处理文档、云盘、任务、日历和 IM
创作	nuwa-skill	将人物或主题的思维框架提炼为可运行 Skill
工程	tdd	围绕公开 seam 执行 red → green 的测试开发循环
文档	writing-for-agents	编写 Skill、AGENTS.md 与其他 Agent 文档

早期的 video-download、video-understand 已不在仓库中；文章也不再把它们作为当前能力介绍。

Skill 应按需复制到目标项目

选择所需的目录复制到目标项目的 .opencode/skills/。若目标 Agent 从 .agents/skills/ 发现 Skill，则使用相应的分发目录。

your-project/
└── .opencode/
    └── skills/
        ├── brainstorming/
        └── diagnosing-bugs/

部分 Skill 有自己的运行前提。例如 amap-lbs-skill 需要高德 Web Service Key，可从随附模板创建本地配置：

cp .opencode/skills/amap-lbs-skill/.env.example .opencode/skills/amap-lbs-skill/.env

.env 和 config.json 仅用于本地，不应提交。

opencode-peek 提供会话可观测性

opencode-peek 是仓库中的独立 npm package，当前版本为 0.2.1。它将当前 OpenCode 会话渲染为本地 HTML transcript，并提供：

• 当前会话 transcript 与 Token Usage 报告
• 自定义工具的稳定颜色分配
• 根据模型识别的本地头像
• 可扩展主题的渲染基础

opencode-peek 插件文档

安装、/peek command 配置、隐私边界和本地开发说明。

要求：Node.js >=22，以及兼容 @opencode-ai/plugin >=1.17.14 <2 的 OpenCode plugin API。

# 当前项目安装
opencode plugin opencode-peek

# 全局安装
opencode plugin -g opencode-peek

可选地在 .opencode/opencode.json 中配置 /peek command，使 Agent 先调用 session_inspect 生成快照与 Token 报告，再调用 peek 生成页面。配置完成后重启 OpenCode，执行：

/peek

生成页面位于：

.workspace/cache/peek/latest.html

会话快照、系统提示词和工具输出也会被保存，可能包含源码、路径或其他敏感上下文。应将缓存目录加入 .gitignore：

.workspace/cache/

如果正在使用旧版插件，可强制刷新缓存：

opencode plugin opencode-peek --force

仓库开发只针对插件 workspace

Skill 是随仓库提交的 Markdown 与支持文件；需要构建和测试的是 opencode-peek workspace。

npm install
npm run build
npm test
npm run pack:peek -- --dry-run

pack:peek 用于检查最终 npm tarball。发布前应在干净的 OpenCode 配置中安装该 tarball，确认插件入口和资源不依赖本地源码目录。

适合把 Agent 能力沉淀为可维护资产

open-code-kit 的边界很清楚：Skill 负责把特定任务的方法、触发条件和安全约束固化下来；opencode-peek 则负责观察一次真实会话的执行结果。

比起把所有规则堆进一段通用提示词，这种按任务拆分、保留来源并显式同步分发目录的方式，更适合长期维护和复用。

贡献者: Paiad