Living
中文

开始使用 Living

四步开始使用

Public Beta · Coming Soon

注册和公开接入尚未开放。下方是公开 Beta 的接入流程，其中部分 MCP 与 Skills 操作已在本地 Beta 验证。

  1. 创建 Project

    Coming Soon

    登录 Living，创建 Project，输入项目名称并选择语言。

    正式开放后提供创建界面的操作截图。

  2. 签发 MCP Key

    Coming Soon

    在 Project 的连接设置中签发 MCP Key，并作为安全凭证保存，避免将明文 Key 提交到 Git。

  3. 添加 Living MCP Server

    Coming Soon

    公开接入开放后，从 Project 的连接设置获取服务器 URL 和认证说明。

    Claude Code

    • 在项目目录用 Claude Code CLI 的 claude mcp add 添加远程服务器，选择 HTTP 传输。个人连接使用本地作用域（local）。
    • 使用 Project 连接设置提供的 URL 和认证选项。若使用 Bearer Token，CLI 支持设置 Authorization 请求头。
    • 在该项目打开 Claude Code，运行 /mcp，确认 Living 显示为已连接。
    MCP 官方文档
    查看操作系统验证状态
    macOS
    本地 Beta 已验证
    Windows
    待验证
    Linux
    待验证

    本地 Beta 由作者在 macOS 上通过同机 Adapter 验证。Codex 的 MCP 调用通过桥接验证。各系统的公开远程接入均在准备中。

    Codex

    • 打开 Settings → MCP servers → Add server，选择 Streamable HTTP，填写 Living 的服务器名称和 URL。
    • 按 Project 的说明配置认证。若使用 Bearer Token，填写应用可读取的 Token 环境变量名。
    • 保存后选择 Restart，再在输入框输入 /mcp 检查 Living 是否已连接。
    MCP 官方文档
    高级设置：手动配置 TOML

    也可以在用户级 ~/.codex/config.toml 中手动添加服务器，使用 Project 提供的 URL 和认证设置。

    查看操作系统验证状态
    macOS
    本地 Beta 部分验证
    Windows
    待验证
    Linux
    待验证

    本地 Beta 由作者在 macOS 上通过同机 Adapter 验证。Codex 的 MCP 调用通过桥接验证。各系统的公开远程接入均在准备中。

  4. 初始化项目

    公开版需要先创建 Project 并连通 MCP，再在已连接的项目中向 Coding Agent 发送这条提示词。

    发送给 Agent公开接入尚未开放

    初始化当前项目的 Living

    Agent 会通过 MCP 获取兼容的 Skills、安装到项目、初始化 .living/ 并验证结果。

    初始化已在作者的本地 Beta 验证，工程数据留在本地。Codex 桌面端能否自动加载 Skills 仍待验证。

常用 Prompt

初始化后可以用这些提示词调用 Living Skills。

  • 初始化项目查看第 4 步
  • 记录开发成果把完成的工作和实际结果写成成果记录。

    把这次完成的工作整理成 Living 工程记录：写清实际结果和依据，只保留有长期价值的内容。先存在本地，不要同步。

    前提 · 项目已初始化

  • 记录工程判断保留方案、理由与替代方案，区分提议和已采纳。

    把刚才的技术方案讨论记成 Living 决策记录：写明方案、理由、考虑过的替代方案、依据和仍待确认的问题。我没有明确采纳的，标为提议。

    前提 · 项目已初始化

  • 调查系统架构从真实的代码与文档整理当前架构，标明依据。

    根据实际的代码、配置、文档和测试，整理这个项目当前的系统架构，写成有来源的 Living 工程知识。分开写观察到的、推断的和验证过的，不确定的保持未知。先不要同步。

    前提 · 项目已初始化

  • 回顾工程历史梳理阶段变化与关键决定，先给你看再决定记什么。

    回顾这个项目的工程历史：整理阶段性变化、关键决定、已有的证据和仍未解决的事项，每一项注明来源，找不到依据的标为未知。先把结果给我看，再决定哪些写成记录。

    前提 · 项目已初始化

  • 验证并同步确认提交范围后，校验、同步并查看回执。

    把新增和修改过的 Living 记录同步到 Living：先列出准备提交的范围给我确认，校验通过后再同步，然后告诉我回执里的结果。

    前提 · 你明确要求同步时使用

本地 Beta 的数据默认设置

  • 工程记录先保存在本地。
  • 默认关闭自动同步。
  • 向 Living 提交需要你明确授权。
了解数据与安全默认设置
同步范围由你确认
同步前，Agent 列出准备提交的内容，由你指定或确认。
建议不等于批准
Agent 只能把决策记为「提议」，记为采纳需要你明确表态。
不覆盖已有内容
你已有或修改过的同名 Skill、项目原有文件，初始化时都不会被覆盖。
凭证不进项目
MCP Key 不写入 .living/、Git 仓库或公开页面。
设置各自独立
Project 的语言、Agent 的 MCP 配置与本地 .living/ 分开设置，互不替代。

常见问题

现在能自己接入吗？

还不能。注册、Project、MCP Key 与远程连接都在准备中，Living 本体也尚未公开发布。开放后，这一页会换成可以直接执行的步骤。

Project ID 和 MCP Key 有什么区别？

Project ID 标识项目，保存在 .living/project.json。MCP Key 是连接 Living 的安全凭证，应按 Agent 支持的方式妥善管理，避免把明文 Key 写入 .living/、Git 或公开页面。

初始化后，项目里会多出什么？

初始化会核对现有 Project、校验固定版本的 Skills 文件哈希，并将项目目录绑定到该 Project。 一个 .living/ 目录和已安装的 Skills。sync/ 只对应某一个 Living，通常不必提交到 Git。

  • .living/
  • project.json项目绑定，不含凭据
  • records/观察、验证、成果、问题、决策、假设
  • knowledge/有来源的工程知识
  • evidence/记录引用的文件
  • sync/同步状态与每一次的回执
同步时会发生什么？

当前本地 Beta 的同步规则适用于所有发起同步的请求。Agent 在提交前必须获得用户对范围的明确授权。 Agent 先校验准备提交的内容，再整批提交：要么全部写入，要么一条都不写。Living 返回回执，逐条说明新建、更新、未变化或被拒绝，保存在 .living/sync/receipts/。被拒绝时按回执修改后重新同步即可。

Living 会收集我的 Agent 会话吗？

当前本地 Beta 不会收集 Agent 会话。记录与知识由你明确要求后才会同步，Living Web 也不会直接访问项目目录。未来公开版的隐私政策将在开放接入时公布。

Agent 看不到 Living 的工具

MCP 配置在新会话中才会生效，已经打开的会话需要重新开始；新安装的 Skills 也是在会话开始时加载。

初始化停止了

常见原因是同名 Skill 被本地修改过或不是 Living 安装的，或下载的文件没有通过哈希校验。这时不会写入任何文件；按 Agent 给出的原因处理后再初始化。

继续了解

Living Skills

下方版本的 Living Skills 源码已公开，查看或克隆无需 Living 账号。

部分 Skills（如 living-init）仍依赖 Living MCP Bootstrap 与 Contract。完整的独立使用流程待验证，已支持的能力以仓库文档为准。此版本尚未附开源许可证。

在 GitHub 查看 Living Skills · v0.4.0-rc.1
终端
git clone --depth 1 --branch v0.4.0-rc.1 https://github.com/kenkokuLife/living-skills.git

此命令仅获取源文件。