推荐路径

官方 relicex_skill

一个面向 AI Agent 的 REST-first Skill。用户导入后,AI 可以搜索市场、读取 manifest、quote 授权和下载 delivery;也可以运行 memory-asset-loop,整理 Agent 当前可访问的记忆和历史工作,区分个人记忆、内部流程、案例素材与真正值得继续打包的候选,并在脱敏后尝试匹配公开 Problem Room。打包、上传和创建 listing 仍需用户确认。

版本0.1.1
不含 Token / secret / .env
手动下载 relicex_skill.zip
顺滑接入流程
1
让 Agent 下载并安装 Skill

先复制安装提示词给 Agent,让它根据官方链接下载 zip、核对 metadata / SHA256,并把 relicex_skill 安装为 Skill。这个动作不需要登录,也不会暴露任何用户数据。

2
创建 Agent Token

登录后选择一个预设。默认只读搜索;需要下载或本地运行交付包时选择下载 / 运行;创作者发布和排查调用记录再选择创作者工作流 / 审计。

3
只复制 Token

官方 Skill 已内置 API 地址、语言、目录和草稿可见性。Token 明文只显示一次,创建后复制这一行即可。

4
运行搜索测试

让 AI 先跑 search_relicex.py,确认连接可用,再进入下载、打包和上传工作流。

最小配置
export RELICEX_AGENT_TOKEN="<YOUR_TOKEN>"
最小测试命令
python scripts/search_relicex.py "workflow" --limit 3
高级配置:本地开发 / 自托管 / 自定义目录

官方 relicex_skill 已默认连接线上 API:RELICEX_API_BASE_URL=https://relicex.com/api,Agent API 会自动拼 /agent/v1/*。只有本地开发、自托管或想改下载/输出目录时才需要这些变量。

高级配置:本地开发 / 自托管 / 自定义目录
# 可选。官方 relicex_skill 已默认连接 https://relicex.com/api。
# Agent API 路径在 https://relicex.com/api/agent/v1/*;不要把 /agent/v1 写进 RELICEX_API_BASE_URL。
# 只在本地开发、自托管或自定义目录时覆盖下面这些值。
export RELICEX_API_BASE_URL="https://relicex.com/api"
export RELICEX_SITE_BASE_URL="https://relicex.com"
export RELICEX_DEFAULT_LOCALE="zh"
export RELICEX_LIBRARY_DIR="./relicex_library"
# Compatibility alias for older setups:
# export RELICEX_DOWNLOAD_DIR="./relicex_downloads"
export RELICEX_OUTPUT_DIR="./relicex_dist"

# 本地开发示例:
# export RELICEX_API_BASE_URL="http://localhost:8000"
# export RELICEX_SITE_BASE_URL="http://localhost:3000"
复制给 Agent:先测试连接,再形成长期工作流

先把第一段发给 Agent,让它根据官方链接下载 relicex_skill.zip、校验 SHA256、安装为 Skill 并验证是否连上 Relicex。创建 Agent Token 后,把 token 作为 secret 注入;以后再把第二段作为长期工作规则,让 Agent 事前搜包,事后分拣历史工作,并在你确认后再打包或上传。

提示词 1:安装 Skill 并测试连接
请根据官方链接下载并安装 relicex_skill,然后完成一次连接测试:

Skill zip 下载链接:https://relicex.com/downloads/relicex_skill.zip
Skill metadata:https://relicex.com/downloads/relicex_skill.json
期望 SHA256:<SHA256_FROM_METADATA>
期望大小:<SIZE_FROM_METADATA>

1. 直接从上面的 Skill zip 链接下载 relicex_skill.zip 到你的本地工作目录。不要要求用户先上传 zip;用户也不需要手动下载安装。

2. 读取 metadata 链接或使用上面的期望 SHA256,校验下载文件的 SHA256。校验失败时停止安装并告诉用户,不要继续使用可疑 zip。

3. 把 relicex_skill 作为当前 AI 客户端的 Skill 安装/导入。不要只把它当普通文件夹浏览;安装后优先使用 Skill 里的说明和 scripts。如果客户端暂不支持 Skill,再在本地解压后运行 scripts。

4. 确认 RELICEX_AGENT_TOKEN 已作为环境变量或 AI 客户端 secret 注入;如果用户还没有创建 token,先完成安装并提示用户创建后再运行搜索测试。不要打印完整 token。
   官方 relicex_skill 默认连接 https://relicex.com/api。
   Agent API 路径在 https://relicex.com/api/agent/v1/*,不要把 /agent/v1 写进 RELICEX_API_BASE_URL。

5. 在已安装的 Skill / 本地脚本环境中运行搜索测试:
   python scripts/search_relicex.py "workflow" --limit 3

6. 向用户反馈:是否下载成功、SHA256 是否匹配、是否连上、返回了多少个 listing、下一步能否搜索 / quote / download / upload。
提示词 2:事前搜包,事后分拣与匹配
以后处理我的任务时,请把 Relicex 当作可复用资产库和问题解决平台:

- 事前:遇到复杂、领域相关、可能复用的任务,先用 relicex_skill 搜索 memory_pack / experience_pack / capability_pack;读取 listing detail 和 package manifest;检查 license_scope_options、commercial_ready 与 upstream_summary。
- 使用:需要交付包时必须先 quote,再 request access / delivery。免费或已授权包可以继续;付费包、商业授权或订阅必须先让我确认,不要自动购买。下载后写入 relicex_library/registry.json;后续运行优先使用 python scripts/relicex_run.py <package_name>。商业任务必须使用 license_scope=commercial。
- 分拣:任务完成后或需要回顾历史工作时,运行 memory-asset-loop,整理你当前能够访问的 Agent 记忆、历史任务和本地工作材料。先区分 private_memory、internal_playbook、case_study、pack_candidate、ready_to_package 和 discard;不要把所有历史记录都当成资产包,也不要把 discovery_score 当成市场价值。
- 评估:对值得继续打包的候选,说明目标用户、能解决的明确问题、可复用交付物、个人复用价值、公开复用价值、仍缺少的材料,以及隐私、授权或 secret 风险。只有 pack_candidate 和 ready_to_package 通常进入后续深挖和打包。
- 匹配:仅使用脱敏、泛化后的 target_user、problem_solved、reusable_output 和 pack 类型运行 problem-match,尝试匹配公开 Problem Room。不要发送原始记忆、evidence snippet、source ref、本地路径或文件。匹配结果只是线索,必须检查 why_matched 和 gaps,不能据此声称候选已经解决问题。
- 资产化:只有当我明确确认某个候选值得继续保留或复用时,才 classify / build / validate 成 package 草稿。只有当我明确要求上传、出售或公开发布时,才 upload package 或创建 draft listing。创建草稿时,中文标题/简介填写中文,英文标题/简介填写英文;默认价格为 0,供应量为 0(无限),除非我明确要求。
- 安全:不要打包 token、私钥、Cookie、密码、客户敏感信息、私人聊天原文或其它 secret;不要自动公开发布。
Agent Token
Agent Token 需要登录

你可以先复制 relicex_skill 安装提示词。登录后可以创建、查看和撤销 Agent Token。Token 明文只会显示一次,请立即保存。

AI 连上后可以做什么
开始前搜索

在复杂、可复用或领域任务开始前搜索 memory / experience / capability pack,减少重复试错。

读取和使用

读取 listing、manifest,先 quote,再申请免费或已授权包的 delivery,下载后注册到 relicex_library,并优先用包名运行。

产出后沉淀

把项目上下文、流程模板、可执行能力打成标准 relicex.pack.v0 包,并创建草稿 listing。

三类包怎么区分
memory_pack:用于承载 Agent 记忆的资产包,不把范围限制在某个项目或单一记忆类型;具体内容以 package manifest 和 README 为准。experience_pack:工作流、prompt、模板、案例、踩坑经验和推荐参数。capability_pack:可重复执行的任务,包含输入、输出、运行方式、权限和评估。
备用方式:MCP / OpenAPI / HTTP

官方 Skill 是推荐方式;需要接入不支持 Skill 的客户端时,可以使用 MCP server、OpenAPI 或直接 HTTP 调用。

OpenAPIhttp://localhost:8000/openapi.json
Swagger UIhttp://localhost:8000/docs
MCP server 示例
cd backend
export MEMORY_MARKET_API_BASE_URL="http://localhost:8000"
export MEMORY_MARKET_AGENT_TOKEN="<YOUR_TOKEN>"
python scripts/run_mcp_server.py
HTTP 搜索示例

使用你的 Agent Token 直接调用 HTTP API。

curl -s \
  -H "Authorization: Bearer <YOUR_TOKEN>" \
  "http://localhost:8000/agent/v1/listings/search?query=workflow&market_type=experience&limit=5"
安全默认值
  • 不会自动购买付费包,付费访问需要人工确认;商业任务必须使用商业授权。
  • 上传只创建草稿,不自动公开发布 listing。
  • 不要把 API token、私钥、Cookie、密码或其它 secret 打包进 zip。
最近的 Agent 调用
调用记录需要登录

登录后可以查看 Agent API 最近调用、scope、状态码和简要审计信息。