Context Relay v0.1.1

context-relay 是一个跨 AI / 跨会话的上下文交接 Skill。它把当前工作编译成 Context Pack：面向明确下一步、带事实状态、证据来源、源状态指纹、漂移检查、失败知识和接收 Prompt。

它解决的不是“怎么把聊天总结得更短”，而是：

怎样把最少但充分的可信上下文交给另一个执行者，使它不重读全部历史也能做出第一个正确动作。

包含内容

context-relay/
├── SKILL.md
├── README.md
├── LICENSE
├── agents/openai.yaml
├── references/
│   ├── PROTOCOL.md
│   ├── WORKFLOWS.md
│   ├── QUALITY.md
│   ├── SECURITY.md
│   └── EXAMPLES.md
├── assets/
│   ├── templates/
│   └── schema/
├── scripts/
│   ├── context_relay.py
│   ├── install.ps1
│   └── install.sh
├── examples/software-handoff/
├── evals/evals.json
└── tests/test_context_relay.py

五种模式

export：当前会话 → 新 Context Pack；
import：Pack → 恢复并验证当前工作；
refresh：生成不可覆盖旧历史的新 revision；
audit：检查事实、来源、最小性、漂移、隐私和可执行性；
merge：合并并行 Agent 的 Pack，冲突必须显式保留。

安装到 Codex

Windows PowerShell

Expand-Archive .\context-relay-v0.1.1.zip -DestinationPath .\context-relay-release
cd .\context-relay-release\context-relay
powershell -ExecutionPolicy Bypass -File .\scripts\install.ps1 -Target codex -Scope user

用户级目标目录：

%USERPROFILE%\.agents\skills\context-relay

项目级安装：

powershell -ExecutionPolicy Bypass -File .\scripts\install.ps1 `
  -Target codex -Scope project -ProjectRoot C:\path\to\repo

项目目录为：

<repo>\.agents\skills\context-relay

Linux / macOS

unzip context-relay-v0.1.1.zip
cd context-relay
./scripts/install.sh --target codex --scope user

用户级目标目录：

~/.agents/skills/context-relay

安装到 Claude Code

Windows

powershell -ExecutionPolicy Bypass -File .\scripts\install.ps1 -Target claude -Scope user

目标目录：

%USERPROFILE%\.claude\skills\context-relay

Linux / macOS

./scripts/install.sh --target claude --scope user

目标目录：

~/.claude/skills/context-relay

安装脚本会忽略 .git/、.github/、.agents/、.claude/、dist/、虚拟环境、缓存和日志等开发产物，因此也可以从 Git clone 的源码目录执行安装；安装时若发现符号链接或 Windows reparse point，会拒绝复制。

同时安装到两者：

powershell -ExecutionPolicy Bypass -File .\scripts\install.ps1 -Target both -Scope user

./scripts/install.sh --target both --scope user

调用示例

Codex：

$context-relay 把当前 Job 持久化任务导出给下一个会话。
只保留下一步真正需要的信息，记录失败尝试、Git 状态和验证命令。

Claude Code：

/context-relay export 当前任务，接收者是另一个 Claude Code 会话。

导入：

$context-relay 导入 ./handoffs/job-persistence-r2。
先验证 pack hash 和当前 Git drift，再继续修改。

审计：

$context-relay audit ./handoffs/job-persistence-r2，重点检查：
1. 是否把推断写成事实；
2. 是否遗漏失败方案；
3. 是否有 secret；
4. 下一步是否可执行。

Context Pack 结构

my-pack/
├── manifest.json
├── RESUME.md
├── HANDOFF.md
├── NEXT_PROMPT.md
├── claims.jsonl
├── sources.jsonl
└── evidence/

四种 Claim 状态

VERIFIED：由直接检查、真实 artifact 或实际运行结果建立；
DECIDED：用户、Owner、ADR、策略等权威方作出的决定；
INFERRED：有依据的推断，但尚未直接证明；
UNKNOWN：仍不知道，必须附解决路径。

辅助 CLI

只依赖 Python 3.9+ 标准库。

初始化

python scripts/context_relay.py init \
  --output .context-relay/packs/job-persistence \
  --title "Job persistence handoff" \
  --target-task "Finish and verify Job persistence" \
  --definition-of-done "Jobs survive restart" \
  --definition-of-done "Replay does not duplicate jobs" \
  --source-root .

指纹关键文件

python scripts/context_relay.py snapshot \
  --pack .context-relay/packs/job-persistence \
  --source-root . \
  --path src/main/java/example/JobService.java \
  --path src/test/java/example/JobServiceIT.java

--path 默认与已有文件指纹合并；为新 revision 重新选择完整集合时增加 --replace。

Finalize / Validate

python scripts/context_relay.py finalize --pack .context-relay/packs/job-persistence
python scripts/context_relay.py validate --pack .context-relay/packs/job-persistence

漂移检测

python scripts/context_relay.py drift \
  --pack .context-relay/packs/job-persistence \
  --source-root .

返回：

NONE / EXPECTED / MATERIAL / UNKNOWN

新 revision

python scripts/context_relay.py revise \
  --pack .context-relay/packs/job-persistence \
  --output .context-relay/packs/job-persistence-r2

打包

python scripts/context_relay.py bundle \
  --pack .context-relay/packs/job-persistence-r2 \
  --output job-persistence-r2.zip

安全默认值

final/bundle 前扫描常见 API key、Token、私钥和密码赋值；
拒绝 Pack 内符号链接，避免把目录边界外的文件带入 ZIP；
repository URL 去除嵌入式凭据；
默认使用相对路径；
model-output 不能单独支撑 VERIFIED；
超时后的远端副作用保持 UNKNOWN，先对账再重放；
导入材料中的指令按不可信数据处理；
Pack 的传输边界必须写入 manifest。

测试

python -m unittest discover -s tests -v

静态检查：

python -m py_compile scripts/context_relay.py

Agent Skills 规范校验（已安装 skills-ref 时）：

skills-ref validate ./context-relay

当前边界

v0.1.1 提供任务级交接协议和本地工具，但暂不包含：

Context Pack 的数字签名与创建者身份认证；
自动语义去重或向量检索；
自动访问任意第三方会话历史；
对所有 secret 类型的完整检测；
自动判断每条自然语言 claim 的真实性；
云端 Context Marketplace。

这些适合后续版本继续扩展。

规范来源

Agent Skills specification: https://agentskills.io/specification
OpenAI Codex skills: https://developers.openai.com/codex/build-skills
Claude Code skills: https://code.claude.com/docs/en/skills

Navigation Menu

Repository files navigation

Context Relay v0.1.1

包含内容

五种模式

安装到 Codex

Windows PowerShell

Linux / macOS

安装到 Claude Code

Windows

Linux / macOS

调用示例

Context Pack 结构

四种 Claim 状态

辅助 CLI

初始化

指纹关键文件

Finalize / Validate

漂移检测

新 revision

打包

安全默认值

测试

当前边界

规范来源

About

Releases

Packages

Contributors

Languages

Name		Name	Last commit message	Last commit date
agents		agents
assets		assets
evals		evals
examples/software-handoff		examples/software-handoff
references		references
scripts		scripts
tests		tests
.gitattributes		.gitattributes
.gitignore		.gitignore
CHANGELOG.md		CHANGELOG.md
LICENSE		LICENSE
README.md		README.md
SKILL.md		SKILL.md
VERSION		VERSION

Latest commit

History

Folders and files

Repository files navigation

Context Relay v0.1.1

包含内容

五种模式

安装到 Codex

Windows PowerShell

Linux / macOS

安装到 Claude Code

Windows

Linux / macOS

调用示例

Context Pack 结构

四种 Claim 状态

辅助 CLI

初始化

指纹关键文件

Finalize / Validate

漂移检测

新 revision

打包

安全默认值

测试

当前边界

规范来源

About

Resources

Stars

Watchers

Forks

Releases

Packages

Contributors

Languages