ex-ussr-kinship-research

环境要求

• 已安装 Node.js（npx 与 Skills CLI 依赖它）
• 一个支持 Agent Skills 的智能体运行时，如 Codex、Claude Code
• 可访问 GitHub 的网络环境（用于拉取仓库）
• 已安装 git（仅手动克隆方式需要）

安装与启动步骤

1. 1确认运行环境

   先确认本机已装 Node.js，并已有一个支持 Agent Skills 的智能体客户端；Node.js 具体版本要求以 Skills CLI 文档为准。

   node -v

   复制

2. 2用 CLI 安装技能

   README 推荐的可选方式：npx 调用 Skills CLI 把仓库作为技能添加，默认安装到当前项目。

   npx skills add https://github.com/DenisSergeevitch/ex-ussr-kinship-research

   复制

3. 3按提示选择智能体

   命令执行后 CLI 会让你选择目标智能体与安装位置，按交互提示选择即可，无需手写配置。

4. 4改为全局安装

   若希望在所有项目中都能使用该技能，在命令后追加 -g 参数做个人级安装。

   npx skills add https://github.com/DenisSergeevitch/ex-ussr-kinship-research -g

   复制

5. 5手动克隆方式

   README 的另一条路径是把仓库直接克隆进智能体的 skills 目录，适合不用 CLI 的场景。

   git clone https://github.com/DenisSergeevitch/ex-ussr-kinship-research.git

   复制

6. 6放入 skills 目录

   把克隆下来的整个目录移动到你所使用智能体的 skills 文件夹内，目录名保持原样。

7. 7在对话中调用

   用日常语言向智能体描述要查的人物、地域与年代，它会按证据优先原则给出检索路径与带出处的笔记。

如何确认成功

在智能体中提出一个前苏联地区家族史料问题，若回答按“证据优先”给出档案类别、检索路径并标注可追溯出处，即说明技能已加载生效。

常见问题

注意事项

• 适用范围限于前苏联 15 个加盟共和国及俄罗斯帝国相关档案，其他地区不在覆盖内。
• README 提醒区域性示例不能替代当地的实际研究，具体档案要按事件发生时的历史管辖与当前保管机构选择。
• 克隆方式的具体目标目录取决于你所用的智能体，请以该智能体的 skills 目录约定为准。
• Skills CLI 的 Node.js 版本要求与参数可能变化，以官方文档为准。