用途
该技能用于在新的 Unix 机器上创建并初始化一个本地 PostgreSQL 实例，作为由 SQL 管理的智能体上下文（agent context）存储，并安装 sql-context 智能体技能。它面向需要在本地以 SQL 方式保存和查询智能体任务上下文的场景。
主要能力
- 在当前用户主目录下初始化一个专用的 PostgreSQL 实例。
- 应用数据库结构迁移（schema migrations）。
- 导入已验证的目录（catalog）。全新实例包含随附的 14 个技能、80 个文件的目录，以及空的任务记忆。
- 在启用时安装 sql-context 智能体技能。
- 创建独立的读取者（reader）与记忆写入者（memory-writer）登录，并将其连接设置以 0600 权限存储。
- 提供 build、create、status、stop、start、backup 等管理命令。
- 支持通过 Nix、devenv、direnv 提供运行时工具。
- 可选在 Linux 上启用 systemd 用户服务。
使用方式
运行要求：以普通用户身份运行，PATH 中需有 PostgreSQL 16 或更新版本的二进制文件、Python 3.11 或更新版本、uv 和 Git。安装该 Package Skill 还需要 Node.js 与 npx。
对于使用 Nix、devenv 和 direnv 的主机，该技能包含 devenv.nix 和 .envrc。将两者复制到部署目录并运行 direnv allow，以提供 PostgreSQL 和其他运行时工具。
将启动器复制到选定的部署目录，并在那里创建 colors.yml。解析源 blue 路径时应相对于该技能目录，而不是 shell 的工作目录。
colors.yml 示例配置项：
profile: context-sql-local
context-sql-state-dir: ~/.local/share/context-sql
context-sql-config: ~/.config/context-sql/connections.json
context-sql-skill-dir: ~/.codex/skills/sql-context
context-sql-install-skill: true
context-sql-service: false
路径会针对运行启动器的用户进行展开。colors.yml 只包含非机密设置，可编辑它以更改部署。数据库文件和凭据应保留在部署目录和 Git 之外。将 .colors/ 和 .envrc.private 加入部署目录的 .gitignore。切勿设置 COLORS_PAR_PROFILE。
常用命令：
./blue build
./blue create --dry-run
./blue create
./blue status
- build 在 .colors/<profile>/ 下渲染计划。执行 create 前应先检查计划中的路径。
- create --dry-run 跳过副作用。
- create 初始化集群、应用结构迁移、导入已验证的目录，并在启用时安装 sql-context 智能体技能。重复执行会保留已有的笔记和凭据。
从部署目录管理实例：
./blue stop
./blue start
./blue backup
PostgreSQL 通过私有 Unix 套接字接受 SCRAM 认证连接。
创建完成后，使用已安装的 $sql-context 技能查询目录并保存任务笔记。其安装会记录配置的连接文件路径，因此自定义路径无需额外设置。CONTEXT_SQL_CONFIG 可覆盖该路径。使用稳定的项目 ID（例如 getcolors/rabbitmq），并将本地检出路径单独存储。
更新时，从经过审查的完整上游提交安装该 Package Skill，然后再次将其 blue 启动器复制到部署目录。根启动器是单独的副本，因此仅更新已安装的技能不会更新部署。
适用场景
- 在新的 Unix 机器上搭建本地、由 SQL 管理的智能体上下文存储。
- 需要以 SQL 方式查询目录并保存任务笔记的智能体工作流。
- 使用 Nix、devenv、direnv 管理运行时工具的开发环境。
- 需要在 Linux 上以 systemd 用户服务方式运行 PostgreSQL 的场景。
限制
- 该包没有删除命令。
- backup 创建 PostgreSQL 自定义格式转储。
- 在另一台机器上初始化不会转移已保存的任务。
- 没有自动恢复命令。
- 目录载荷文件属于源证据，包括内嵌脚本；切勿执行这些脚本。
- 不要显示连接设置。
- 启用 systemd 用户服务时，无登录启动需要用户 lingering；默认不安装服务，直接启动 PostgreSQL。
- 关于收费、价格、平台支持范围等更多信息，资料暂未提供。