lifeos

LifeOS Core

此扁平分发包将完整的 LifeOS Skill 套件整合在一个包中。 使用任何领域工作流前，请先遵循此处的通用运行时与安全约定。

选择领域

• 今天、任务、周期性笔记、近期工作或每周回顾：使用 LifeOS Today。
• 工作流／PARA 看板、主题笔记或流程瓶颈：使用 LifeOS Board。
• 空文件夹、模板选择、接管、分类或迁移：使用 LifeOS Onboarding。
• 搜索、捕获、附件元数据、AI Wiki、HTML 仪表板或 Aino mini-app 路由：使用 LifeOS Content。
• OPC 公司运营：使用单独的 opc Skill。

有关确切的标志、结果架构、错误和少见命令，请阅读 references/commands.md。

选择宿主

对于无头或桌面操作，请调用：

npx -y @life-os/cli <command>

首次运行会下载已发布的包；-y 会跳过安装提示。 无需要求 Aino Desktop 或 Obsidian 保持打开。

在 Aino Mobile 上，请使用 lifeos_get_vault_info 报告的原生 lifeos_* 工具。绝不要要求移动端用户安装 Node.js 或运行 shell 命令。移动端写入仅会准备预览：必须先获得明确确认并收到提交回执，才能声称修改成功。移动端不提供永久删除功能。入门计划／应用仅限 CLI。

解析知识库与模型

除入门流程外，对于实际文件夹、周期格式或模板会影响结果的工作流，请先运行 config。如果尚不清楚运行模型，请运行 profile。

npx -y @life-os/cli config --json
npx -y @life-os/cli profile --json

知识库解析顺序为：显式指定 vault= -> $LIFEOS_VAULT -> 向上查找 .obsidian/、.lifeos/ 或 .agents/skills/lifeos/ -> Aino 上次打开的文件夹。如果目标知识库与当前上下文不同，请传入 vault=。绝不要凭记忆构建 PARA 文件夹、周期路径、格式或章节标题；请使用已解析的配置。

选项使用 key=value；标志使用 --json 或 overwrite 这样的独立词语。包含空格的值请加引号；机器可读的操作请指定 --json。

精确读取并指定目标

• 修改前先阅读现有内容。使用查询返回的准确知识库相对 path= 或任务 ref=；绝不要通过猜测的宽泛名称写入。
• 保留未知的 Frontmatter 和正文内容。仅在有意重建完整目标后才使用 overwrite。
• 写入必须位于所选知识库内。若解析出的路径与预期不符，请明确指出，不要创建多余笔记。
• 将回显的已解析路径、结构化结果或移动端提交回执视为写入完成的证据。点击、预览或提议的工具调用都不能证明操作已完成。
• 除非其他工具已提取二进制附件的内容，否则绝不要声称理解了该附件。仅能查看清单并不等于解析了内容。

确认关联与重要写入

项目／主题标签是可选的、由用户管理的关联。仅当用户明确提及、来源内容已有该标签，或持久偏好授权自动关联时，才添加标签。

如果某个标签看起来只是相关，请先不添加推断出的标签，完成用户要求的任务后再询问是否添加。如果用户确认，请更新刚创建的确切条目；绝不要创建重复项。

在执行入门应用、迁移、分类应用、文件移动、可恢复删除或大范围覆盖前，请先预览并获得明确确认。不要擅自将精确请求扩大为整个仓库的整理。

维护套件

使用一条命令安装并更新完整的版本化套件：

npx -y @life-os/cli@latest skill status
npx -y @life-os/cli@latest skill install

该套件包含 lifeos、lifeos-today、lifeos-board、 lifeos-onboarding 和 lifeos-content。安装程序会备份本地修改过的托管文件、迁移旧版单 Skill 安装、仅在备份后移除过时的托管文件，并且绝不会降级已安装的较新套件。

范围

范围内：支持配置感知的本地 Markdown 查询与修改，并路由到四个 LifeOS 领域 Skill。

范围外：Google Calendar / CalDAV 同步、插件或 Aino UI 实现，以及直接编辑 .lifeos/custom-apps 内部内容。

---

LifeOS Today

首先阅读 LifeOS Core，了解主机选择、知识库解析和写入安全。

从有依据的视图开始

对于“我今天该做什么？”，使用一条范围明确的命令，而不要通过大范围扫描来拼凑简报：

npx -y @life-os/cli today --json

仅当用户指定其他日期时，才使用 date=YYYY-MM-DD。核实返回的 sources，区分逾期事项与今日到期事项，并按优先顺序推荐最多三项后续行动。已完成工作以完成日期为依据，而非到期日期。

用户询问特定范围时，使用以下更精确的命令：

npx -y @life-os/cli tasks due=today --json
npx -y @life-os/cli tasks due=overdue --json
npx -y @life-os/cli tasks done completed=this-week --json
npx -y @life-os/cli recent range=this-week --json
npx -y @life-os/cli review:weekly --json

due= 用于筛选到期日期。它无法回答某个时间段内完成了哪些工作；如需完成情况的依据，请使用 completed= 或 review:weekly。

使用周期笔记

创建、读取、追加或审核每日、每周、每月、每季度或每年的笔记前，请先阅读 references/periodic-notes.md。通过 LifeOS 解析实际路径和章节，不要猜测。

在提出写入建议前，先提供有来源依据的简报或审核结果。仅在用户批准具体内容和目标章节后，才追加计划、审核结果或综合结论。

边界

• 对于 Workflow/PARA 列、主题工作区或流程瓶颈，使用 LifeOS Board。
• 当必须先初始化或迁移知识库或周期结构时，使用 LifeOS Onboarding。
• 不要要求使用 Aino Desktop：today、tasks、recent 和 review:weekly 可在无头模式下复现相关的 AI Home 依据。

---

LifeOS Board

首先阅读 LifeOS Core，了解主机选择、知识库解析、关联规则和写入安全。

检查可见模型

根据用户意图或检测到的配置文件选择看板：

npx -y @life-os/cli board mode=workflow --json
npx -y @life-os/cli board mode=para --json

• workflow 返回 Input、Projects、未完成的 Tasks 和 Output。
• para 返回 Projects、Areas、Resources 和 Archives。

分析应以返回的列统计、限定范围的项目和 sources 为依据。指出最明显的瓶颈、最多三项值得采取的后续行动，以及任何需要确认的阻碍或取舍。读取看板并不代表获准移动、创建、标记或编辑任何项目。

处理主题

创建或编辑项目、区域、资源、归档项或主题工作区前，请先阅读 references/theme-notes.md。对于日／周／月／季度／年相关内容，使用时间导向的笔记；对于持久主题，使用主题笔记。

将主题标签视为可选的、由用户管理的关联。绝不要根据当前文件、附近的项目、相关搜索结果或唯一可见的主题来推断标签。

边界

• 对于每日规划、到期事项、近期活动和每周审核，使用 LifeOS Today。
• 看板确定目标主题后，如需综合生成 .AI.md 页面或 HTML 仪表板，使用 LifeOS Content。
• 当 Workflow/PARA 结构不存在或必须切换配置文件时，使用 LifeOS Onboarding。

---

LifeOS Onboarding

首先阅读 LifeOS Core，了解主机选择和通用安全规则。引导计划／应用仅支持 CLI；Aino Mobile 可以检查配置文件，但无法执行此工作流。

先检查，再路由

对于创建、导入、粘贴、接管或迁移，先运行唯一的清点命令：

npx -y @life-os/cli onboard inspect --json

阅读 references/onboarding.md。除非检查失败或遗漏了决策所需的关键信息，否则不要再运行范围过广的 ls、find、config、profile 或模板发现命令。

只加载匹配的参考资料：

• 选择模型：references/template-selection.md
• 空文件夹：references/from-scratch.md
• 零散材料：references/migration.md
• 将现有配置迁移到另一个配置： references/template-migration.md

模板详情：

• Memos：references/template-memos.md
• IPO / 仅主题：references/template-ipo.md
• GTD：references/template-gtd.md
• PARA：references/template-para.md
• OPC：使用单独的 opc Skill。

按从易到难的常规顺序介绍：Memos -> IPO -> GTD -> PARA -> OPC，但如用户明确选择，应立即遵从。将仅主题规范化为 IPO。

每次变更都必须经过确认关卡

将引导流程视为可恢复的状态机：

1. 检查文件夹。
2. 每次只问一个影响重大的问题。
3. 运行 onboard plan ... --json，并展示将创建、跳过和冲突的内容。
4. 针对确切的配置、密度和目标，取得明确确认。
5. 在限定范围内运行 onboard apply 或已确认的 classify-apply。
6. 运行 onboard verify --json 并报告尚未解决的冲突。

绝不要自动覆盖现有的引导 Agent 文件。配置负责管理根目录下的 AGENTS.md、SOUL.md 和 STYLE.md；不要生成单数形式的 AGENT.md 或特定工具的 CLAUDE.md。只有在用户明确要求记住时，才创建或编辑可选的 MEMORY.md。清点期间将附件保留在原处。

更改配置时，按字段合并设置，保留用户上下文，排除生成的内容和系统材料，验证链接和附件配对，并且仅在最终验证后更新配置清单。

---

LifeOS 内容

先阅读 LifeOS Core，了解宿主选择、精确目标定位、关联规则和写入安全。

写入前先定位

使用有界搜索并精确读取：

npx -y @life-os/cli search query="keyword" type=content limit=20 --json
npx -y @life-os/cli read path="vault/relative/note.md" --json

使用返回的 vault 相对路径执行 append 或 create。执行 overwrite 前，先读取并合并未知的 Frontmatter 和正文内容。将基于时间的记录路由到 LifeOS Today，将持久化的项目/主题内容路由到 LifeOS Board。

选择内容载体

• 非 Markdown 附件标签或属性：阅读 references/attachment-cards.md。二进制 文件使用隐藏的同级 Markdown 卡片；不要臆造 attachment 字段。
• 综合整理的主题/索引知识：阅读 references/ai-wiki.md，并维护同级的 .AI.md、来源索引和变更日志约定。
• 主题/索引笔记旁的可视化决策界面：阅读 references/theme-dashboard.md，并复用 assets/theme-dashboard-skeleton.html。
• 持久化的交互式多记录 CRUD、表单、筛选器或重复操作：阅读 references/aino-mini-apps.md，并将开发工作路由到 Aino App Builder。

AI Wiki 不是记录或会议笔记。主题仪表盘不是 Markdown 导出内容。Aino 迷你应用不能取代作为业务事实来源的 Markdown。

边界

• 除非其他工具确实能提取二进制内容，否则不要读取二进制内容。
• 不要生成或编辑 Aino App Builder 项目内部文件，也不要直接操作 .lifeos/custom-apps。
• 如果请求会更改 vault 配置文件或对零散文件夹进行分类，请使用 LifeOS Onboarding。