# nextclaw - Doramagic AI Context Pack

> 定位：安装前体验与判断资产。它帮助宿主 AI 有一个好的开始，但不代表已经安装、执行或验证目标项目。

## 充分原则

- **充分原则，不是压缩原则**：AI Context Pack 应该充分到让宿主 AI 在开工前理解项目价值、能力边界、使用入口、风险和证据来源；它可以分层组织，但不以最短摘要为目标。
- **压缩策略**：只压缩噪声和重复内容，不压缩会影响判断和开工质量的上下文。

## 给宿主 AI 的使用方式

你正在读取 Doramagic 为 nextclaw 编译的 AI Context Pack。请把它当作开工前上下文：帮助用户理解适合谁、能做什么、如何开始、哪些必须安装后验证、风险在哪里。不要声称你已经安装、运行或执行了目标项目。

## Claim 消费规则

- **事实来源**：Repo Evidence + Claim/Evidence Graph；Human Wiki 只提供显著性、术语和叙事结构。
- **事实最低状态**：`supported`
- `supported`：可以作为项目事实使用，但回答中必须引用 claim_id 和证据路径。
- `weak`：只能作为低置信度线索，必须要求用户继续核实。
- `inferred`：只能用于风险提示或待确认问题，不能包装成项目事实。
- `unverified`：不得作为事实使用，应明确说证据不足。
- `contradicted`：必须展示冲突来源，不得替用户强行选择一个版本。

## 它最适合谁

- **正在使用 Claude/Codex/Cursor/Gemini 等宿主 AI 的开发者**：README 或插件配置提到多个宿主 AI。 证据：`README.md` Claim：`clm_0004` unverified 0.25
- **希望把专业流程带进宿主 AI 的用户**：仓库包含 Skill 文档。 证据：`.agents/skills/autonomous-maintainability-campaign/SKILL.md`, `.agents/skills/classic-software-design-principles/SKILL.md`, `.agents/skills/code-investigation-workflow/SKILL.md`, `.agents/skills/code-review/SKILL.md` 等 Claim：`clm_0005` supported 0.86

## 它能做什么

- **AI Skill / Agent 指令资产库**（可做安装前预览）：项目包含可被宿主 AI 读取的 Skill 或 Agent 指令文件，可用于把专业流程带入 Claude、Codex、Cursor 等宿主。 证据：`.agents/skills/autonomous-maintainability-campaign/SKILL.md`, `.agents/skills/classic-software-design-principles/SKILL.md`, `.agents/skills/code-investigation-workflow/SKILL.md`, `.agents/skills/code-review/SKILL.md` 等 Claim：`clm_0001` supported 0.86
- **多宿主安装与分发**（需要安装后验证）：项目包含插件或 marketplace 配置，说明它面向一个或多个 AI 宿主的安装和分发。 证据：`apps/examples/hello-notes/marketplace.json`, `apps/examples/starter-card/marketplace.json`, `apps/examples/workspace-glance/marketplace.json`, `packages/nextclaw-core/src/features/agent/shared/skills/hermes-runtime/marketplace.json` 等 Claim：`clm_0002` unverified 0.25
- **命令行启动或安装流程**（需要安装后验证）：项目文档中存在可执行命令，真实使用需要在本地或宿主环境中运行这些命令。 证据：`README.md`, `packages/browser-connector/README.md`, `packages/nextclaw-agent-chat-ui/README.md`, `packages/nextclaw-app-runtime/README.md` 等 Claim：`clm_0003` unverified 0.25

## 怎么开始

- `npm install -g nextclaw` 证据：`README.md` Claim：`clm_0006` unverified 0.25, `clm_0008` unverified 0.25, `clm_0011` unverified 0.25
- `curl -fsSL https://nextclaw.io/install-docker.sh | bash` 证据：`README.md` Claim：`clm_0007` unverified 0.25
- `npm install -g @nextclaw/browser-connector` 证据：`packages/browser-connector/README.md` Claim：`clm_0008` unverified 0.25
- `npm i -g nextclaw` 证据：`packages/nextclaw/README.md` Claim：`clm_0009` unverified 0.25
- `npm i @nextclaw/agent-chat-ui` 证据：`packages/nextclaw-agent-chat-ui/README.md` Claim：`clm_0010` unverified 0.25
- `npm install -g @nextclaw/app-runtime` 证据：`packages/nextclaw-app-runtime/README.md` Claim：`clm_0011` unverified 0.25
- `npm install @nextclaw/app-sdk` 证据：`packages/nextclaw-app-sdk/README.md` Claim：`clm_0012` unverified 0.25
- `pnpm add -D @nextclaw/client-sdk` 证据：`packages/nextclaw-client-sdk/README.md` Claim：`clm_0013` unverified 0.25
- `npm i @nextclaw/ui` 证据：`packages/nextclaw-ui/README.md` Claim：`clm_0014` unverified 0.25

## 继续前判断卡

- **当前建议**：先做研究框架试用
- **为什么**：这个项目面向研究工作流，核心风险是资料可信度和输出质量；先用 Prompt Preview 验证研究框架，再在隔离环境试装。

### 30 秒判断

- **现在怎么做**：先做研究框架试用
- **最小安全下一步**：先用 Prompt Preview 验证研究框架；满意后再隔离试装
- **先别相信**：研究结论、引用和实验结果不能在安装前相信。
- **继续会触碰**：研究判断、命令执行、宿主 AI 配置

### 现在可以相信

- **适合人群线索：希望把专业流程带进宿主 AI 的用户**（supported）：有 supported claim 或项目证据支撑，但仍不等于真实安装效果。 证据：`.agents/skills/autonomous-maintainability-campaign/SKILL.md`, `.agents/skills/classic-software-design-principles/SKILL.md`, `.agents/skills/code-investigation-workflow/SKILL.md`, `.agents/skills/code-review/SKILL.md` 等 Claim：`clm_0005` supported 0.86
- **能力存在：AI Skill / Agent 指令资产库**（supported）：可以相信项目包含这类能力线索；是否适合你的具体任务仍要试用或安装后验证。 证据：`.agents/skills/autonomous-maintainability-campaign/SKILL.md`, `.agents/skills/classic-software-design-principles/SKILL.md`, `.agents/skills/code-investigation-workflow/SKILL.md`, `.agents/skills/code-review/SKILL.md` 等 Claim：`clm_0001` supported 0.86

### 现在还不能相信

- **研究结论、引用和实验结果不能在安装前相信。**（unverified）：研究 Skill 可以组织问题和路径，但不能替代真实资料检索、论文核验和实验复现。
- **是否适合你的具体研究领域不能直接相信。**（unverified）：Skill 覆盖很多研究主题，不代表对你的领域、资料要求和可信度标准足够。
- **真实输出质量不能在安装前相信。**（unverified）：Prompt Preview 只能展示引导方式，不能证明真实项目中的结果质量。
- **宿主 AI 版本兼容性不能在安装前相信。**（unverified）：Claude、Cursor、Codex、Gemini 等宿主加载规则和版本差异必须在真实环境验证。
- **不会污染现有宿主 AI 行为，不能直接相信。**（inferred）：Skill、plugin、AGENTS/CLAUDE/GEMINI 指令可能改变宿主 AI 的默认行为。 证据：`.agents/skills/autonomous-maintainability-campaign/SKILL.md`, `.agents/skills/classic-software-design-principles/SKILL.md`, `.agents/skills/code-investigation-workflow/SKILL.md`, `.agents/skills/code-review/SKILL.md` 等
- **可安全回滚不能默认相信。**（unverified）：除非项目明确提供卸载和恢复说明，否则必须先在隔离环境验证。
- **真实安装后是否与用户当前宿主 AI 版本兼容？**（unverified）：兼容性只能通过实际宿主环境验证。 证据：`apps/examples/hello-notes/marketplace.json`, `apps/examples/starter-card/marketplace.json`, `apps/examples/workspace-glance/marketplace.json`, `packages/nextclaw-core/src/features/agent/shared/skills/hermes-runtime/marketplace.json` 等
- **项目输出质量是否满足用户具体任务？**（unverified）：安装前预览只能展示流程和边界，不能替代真实评测。

### 继续会触碰什么

- **研究判断**：问题拆解、资料路径、实验路径、结论结构和可信度判断。 原因：研究型 Skill 可能让输出看起来更专业，但不能替代真实证据核验。
- **命令执行**：包管理器、网络下载、本地插件目录、项目配置或用户主目录。 原因：运行第一条命令就可能产生环境改动；必须先判断是否值得跑。 证据：`README.md`, `packages/browser-connector/README.md`, `packages/nextclaw-agent-chat-ui/README.md`, `packages/nextclaw-app-runtime/README.md` 等
- **宿主 AI 配置**：Claude/Codex/Cursor/Gemini/OpenCode 等宿主的 plugin、Skill 或规则加载配置。 原因：宿主配置会改变 AI 后续工作方式，可能和用户已有规则冲突。 证据：`.agents/skills/autonomous-maintainability-campaign/SKILL.md`, `.agents/skills/classic-software-design-principles/SKILL.md`, `.agents/skills/code-investigation-workflow/SKILL.md`, `.agents/skills/code-review/SKILL.md` 等
- **本地环境或项目文件**：安装结果、插件缓存、项目配置或本地依赖目录。 原因：安装前无法证明写入范围和回滚方式，需要隔离验证。 证据：`README.md`, `apps/examples/hello-notes/marketplace.json`, `apps/examples/starter-card/marketplace.json`, `apps/examples/workspace-glance/marketplace.json` 等
- **宿主 AI 上下文**：AI Context Pack、Prompt Preview、Skill 路由、风险规则和项目事实。 原因：导入上下文会影响宿主 AI 后续判断，必须避免把未验证项包装成事实。

### 最小安全下一步

- **先跑 Prompt Preview**：先验证它能否正确界定研究问题和证据边界，不要先相信研究输出。（适用：任何项目都适用，尤其是输出质量未知时。）
- **只在隔离目录或测试账号试装**：避免安装命令污染主力宿主 AI、真实项目或用户主目录。（适用：存在命令执行、插件配置或本地写入线索时。）
- **先备份宿主 AI 配置**：Skill、plugin、规则文件可能改变 Claude/Cursor/Codex 的默认行为。（适用：存在插件 manifest、Skill 或宿主规则入口时。）
- **安装后只验证一个最小任务**：先验证加载、兼容、输出质量和回滚，再决定是否深用。（适用：准备从试用进入真实工作流时。）

### 退出方式

- **保留安装前状态**：记录原始宿主配置和项目状态，后续才能判断是否可恢复。
- **准备移除宿主 plugin / Skill / 规则入口**：如果试装后行为异常，可以把宿主 AI 恢复到试装前状态。
- **保留资料和结论核验清单**：如果后续发现引用或实验路径不可靠，可以回到证据边界阶段重新校验。
- **记录安装命令和写入路径**：没有明确卸载说明时，至少要知道哪些目录或配置需要手动清理。
- **如果没有回滚路径，不进入主力环境**：不可回滚是继续前阻断项，不应靠信任或运气继续。

## 哪些只能预览

- 解释项目适合谁和能做什么
- 基于项目文档演示典型对话流程
- 帮助用户判断是否值得安装或继续研究

## 哪些必须安装后验证

- 真实安装 Skill、插件或 CLI
- 执行脚本、修改本地文件或访问外部服务
- 验证真实输出质量、性能和兼容性

## 边界与风险判断卡

- **把安装前预览误认为真实运行**：用户可能高估项目已经完成的配置、权限和兼容性验证。 处理方式：明确区分 prompt_preview_can_do 与 runtime_required。 Claim：`clm_0015` inferred 0.45
- **宿主 AI 插件或 Skill 规则冲突**：新规则可能改变用户现有宿主 AI 的工作方式。 处理方式：安装前先检查插件 manifest 和 Skill 文件，必要时隔离测试。 证据：`apps/examples/hello-notes/marketplace.json`, `apps/examples/starter-card/marketplace.json`, `apps/examples/workspace-glance/marketplace.json`, `packages/nextclaw-core/src/features/agent/shared/skills/hermes-runtime/marketplace.json` 等 Claim：`clm_0016` inferred 0.45
- **命令执行会修改本地环境**：安装命令可能写入用户主目录、宿主插件目录或项目配置。 处理方式：先在隔离环境或测试账号中运行。 证据：`README.md`, `packages/browser-connector/README.md`, `packages/nextclaw-agent-chat-ui/README.md`, `packages/nextclaw-app-runtime/README.md` 等 Claim：`clm_0017` inferred 0.45
- **待确认**：真实安装后是否与用户当前宿主 AI 版本兼容？。原因：兼容性只能通过实际宿主环境验证。
- **待确认**：项目输出质量是否满足用户具体任务？。原因：安装前预览只能展示流程和边界，不能替代真实评测。
- **待确认**：安装命令是否需要网络、权限或全局写入？。原因：这影响企业环境和个人环境的安装风险。

## 开工前工作上下文

### 加载顺序

- 先读取 how_to_use.host_ai_instruction，建立安装前判断资产的边界。
- 读取 claim_graph_summary，确认事实来自 Claim/Evidence Graph，而不是 Human Wiki 叙事。
- 再读取 intended_users、capabilities 和 quick_start_candidates，判断用户是否匹配。
- 需要执行具体任务时，优先查 role_skill_index，再查 evidence_index。
- 遇到真实安装、文件修改、网络访问、性能或兼容性问题时，转入 risk_card 和 boundaries.runtime_required。

### 任务路由

- **AI Skill / Agent 指令资产库**：先基于 role_skill_index / evidence_index 帮用户挑选可用角色、Skill 或工作流。 边界：可做安装前 Prompt 体验。 证据：`.agents/skills/autonomous-maintainability-campaign/SKILL.md`, `.agents/skills/classic-software-design-principles/SKILL.md`, `.agents/skills/code-investigation-workflow/SKILL.md`, `.agents/skills/code-review/SKILL.md` 等 Claim：`clm_0001` supported 0.86
- **多宿主安装与分发**：先说明这是安装后验证能力，再给出安装前检查清单。 边界：必须真实安装或运行后验证。 证据：`apps/examples/hello-notes/marketplace.json`, `apps/examples/starter-card/marketplace.json`, `apps/examples/workspace-glance/marketplace.json`, `packages/nextclaw-core/src/features/agent/shared/skills/hermes-runtime/marketplace.json` 等
- **命令行启动或安装流程**：先说明这是安装后验证能力，再给出安装前检查清单。 边界：必须真实安装或运行后验证。 证据：`README.md`, `packages/browser-connector/README.md`, `packages/nextclaw-agent-chat-ui/README.md`, `packages/nextclaw-app-runtime/README.md` 等

### 上下文规模

- 文件总数：5821
- 重要文件覆盖：40/5821
- 证据索引条目：176
- 角色 / Skill 条目：96

### 证据不足时的处理

- **missing_evidence**：说明证据不足，要求用户提供目标文件、README 段落或安装后验证记录；不要补全事实。
- **out_of_scope_request**：说明该任务超出当前 AI Context Pack 证据范围，并建议用户先查看 Human Manual 或真实安装后验证。
- **runtime_request**：给出安装前检查清单和命令来源，但不要替用户执行命令或声称已执行。
- **source_conflict**：同时展示冲突来源，标记为待核实，不要强行选择一个版本。

## Prompt Recipes

### 适配判断

- 目标：判断这个项目是否适合用户当前任务。
- 预期输出：适配结论、关键理由、证据引用、安装前可预览内容、必须安装后验证内容、下一步建议。

```text
请基于 nextclaw 的 AI Context Pack，先问我 3 个必要问题，然后判断它是否适合我的任务。回答必须包含：适合谁、能做什么、不能做什么、是否值得安装、证据来自哪里。所有项目事实必须引用 evidence_refs、source_paths 或 claim_id。
```

### 安装前体验

- 目标：让用户在安装前感受核心工作流，同时避免把预览包装成真实能力或营销承诺。
- 预期输出：一段带边界标签的体验剧本、安装后验证清单和谨慎建议；不含真实运行承诺或强营销表述。

```text
请把 nextclaw 当作安装前体验资产，而不是已安装工具或真实运行环境。

请严格输出四段：
1. 先问我 3 个必要问题。
2. 给出一段“体验剧本”：用 [安装前可预览]、[必须安装后验证]、[证据不足] 三种标签展示它可能如何引导工作流。
3. 给出安装后验证清单：列出哪些能力只有真实安装、真实宿主加载、真实项目运行后才能确认。
4. 给出谨慎建议：只能说“值得继续研究/试装”“先补充信息后再判断”或“不建议继续”，不得替项目背书。

硬性边界：
- 不要声称已经安装、运行、执行测试、修改文件或产生真实结果。
- 不要写“自动适配”“确保通过”“完美适配”“强烈建议安装”等承诺性表达。
- 如果描述安装后的工作方式，必须使用“如果安装成功且宿主正确加载 Skill，它可能会……”这种条件句。
- 体验剧本只能写成“示例台词/假设流程”：使用“可能会询问/可能会建议/可能会展示”，不要写“已写入、已生成、已通过、正在运行、正在生成”。
- Prompt Preview 不负责给安装命令；如用户准备试装，只能提示先阅读 Quick Start 和 Risk Card，并在隔离环境验证。
- 所有项目事实必须来自 supported claim、evidence_refs 或 source_paths；inferred/unverified 只能作风险或待确认项。

```

### 角色 / Skill 选择

- 目标：从项目里的角色或 Skill 中挑选最匹配的资产。
- 预期输出：候选角色或 Skill 列表，每项包含适用场景、证据路径、风险边界和是否需要安装后验证。

```text
请读取 role_skill_index，根据我的目标任务推荐 3-5 个最相关的角色或 Skill。每个推荐都要说明适用场景、可能输出、风险边界和 evidence_refs。
```

### 风险预检

- 目标：安装或引入前识别环境、权限、规则冲突和质量风险。
- 预期输出：环境、权限、依赖、许可、宿主冲突、质量风险和未知项的检查清单。

```text
请基于 risk_card、boundaries 和 quick_start_candidates，给我一份安装前风险预检清单。不要替我执行命令，只说明我应该检查什么、为什么检查、失败会有什么影响。
```

### 宿主 AI 开工指令

- 目标：把项目上下文转成一次对话开始前的宿主 AI 指令。
- 预期输出：一段边界明确、证据引用明确、适合复制给宿主 AI 的开工前指令。

```text
请基于 nextclaw 的 AI Context Pack，生成一段我可以粘贴给宿主 AI 的开工前指令。这段指令必须遵守 not_runtime=true，不能声称项目已经安装、运行或产生真实结果。
```

## 角色 / Skill 索引

- 共索引 96 个角色 / Skill / 项目文档条目。

- **autonomous-maintainability-campaign**（skill）：当用户希望这个仓库执行一次可跨上下文压缩、可整夜续跑、低人工监督的长期可维护性治理战役时使用，尤其适用于治理规则已经明确、主要挑战是稳定自治推进而不是一次性方案设计的场景。 激活提示：当用户任务与“autonomous-maintainability-campaign”描述的流程高度相关时，先用它做安装前体验，再决定是否安装。 证据：`.agents/skills/autonomous-maintainability-campaign/SKILL.md`
- **classic-software-design-principles**（skill）：当讨论或修改架构、模块职责、owner、生命周期、对象边界、状态归属、helper/service/class 拆分、抽象力度、重构方案、复杂性能瓶颈、方案对比、决策过程，或用户要求“简单优先”“简单第一”“编程原则”“最佳实践”“底层思想”“不要张口就来”“深入分析”时使用。用于先深挖用户真实意图与约束，再用 GRASP、SOLID、Tell Don't Ask、Law of Demeter、封装、高内聚低耦合等经典原则校准设计，避免空心 owner、假注入、乱兼容、重复职责和过度抽象。 激活提示：当用户任务与“classic-software-design-principles”描述的流程高度相关时，先用它做安装前体验，再决定是否安装。 证据：`.agents/skills/classic-software-design-principles/SKILL.md`
- **code-investigation-workflow**（skill）：当用户要求先研究代码、排查代码、看清楚现状、判断某个组件/函数/manager/文件是什么性质、该不该改、该怎么改，要求移植/对齐外部仓库、目录、主题或内容集合，或指出“不要我说一下你才注意一下”“主动发现所有问题”“顺着代码查完整”时使用。该 skill 只规定调查方法，不承载具体架构、拆分、命名、MVP、UI 或 owner 规范；具体判断必须转交对应专项 skill。 激活提示：当用户任务与“code-investigation-workflow”描述的流程高度相关时，先用它做安装前体验，再决定是否安装。 证据：`.agents/skills/code-investigation-workflow/SKILL.md`
- **code-review**（skill）：审查代码、diff、pull request 或拟议修复，重点识别缺陷、回归风险、行为漂移、测试缺口与可维护性压力。适用于用户提出代码 review、PR review、风险扫描、findings-first 审计，或希望判断某个修复是否足够安全且是否应先删减/简化再新增逻辑的场景。 激活提示：当用户任务与“code-review”描述的流程高度相关时，先用它做安装前体验，再决定是否安装。 证据：`.agents/skills/code-review/SKILL.md`
- **collapsible-feature-root-architecture**（skill）：用于定义或重构基于 feature 的代码组织架构，尤其适用于判断当前作用域应保持单 feature root、何时引入 features/ 聚合层、何时拆稳定子 feature、何时严格限制 shared 目录、如何处理可被其他 workspace 源码依赖的 package/SDK/shared library 的导入 alias，以及如何分别处理包内部结构与仓库级组织边界。 激活提示：当用户任务与“collapsible-feature-root-architecture”描述的流程高度相关时，先用它做安装前体验，再决定是否安装。 证据：`.agents/skills/collapsible-feature-root-architecture/SKILL.md`
- **contract-driven-delivery-campaign**（skill）：当用户希望在这个仓库里推进一次跨多轮、易漂移的复杂编码交付任务时使用，尤其适用于一开始要求明确、但任务容易做着做着偏离目标、半途误判完成或最后结果不符合预期的场景。 激活提示：当用户任务与“contract-driven-delivery-campaign”描述的流程高度相关时，先用它做安装前体验，再决定是否安装。 证据：`.agents/skills/contract-driven-delivery-campaign/SKILL.md`
- **delivering-delegated-linear-issues**（skill）：当用户要求从 Linear 领取、处理、批量清空或定时扫描带 Delegated to Agent 标签的 issue，讨论默认交付方式、ready PR、本地 master、脏工作区/WIP 安全合入、Agent 状态标签或定时扫描会话归属时使用。 激活提示：当用户任务与“delivering-delegated-linear-issues”描述的流程高度相关时，先用它做安装前体验，再决定是否安装。 证据：`.agents/skills/delivering-delegated-linear-issues/SKILL.md`
- **desktop-release-contract-guard**（skill）：Use when building, verifying, or releasing NextClaw desktop installers, DMGs, update bundles, update manifests, or one-command desktop beta/stable release automation. Enforces the packaged update public key contract, the required verification commands, and the rule that raw electron-builder output is not enough. 激活提示：当用户任务与“desktop-release-contract-guard”描述的流程高度相关时，先用它做安装前体验，再决定是否安装。 证据：`.agents/skills/desktop-release-contract-guard/SKILL.md`
- **directory-structure-governance-overview**（skill）：当用户要求目录结构治理概况、整体问题概况、结构热点、目录问题量化、下一步治理优先级、长期结构债务地图，或用“概况”“热点”“整体情况”指代当前 module-structure/app-l1/app-l2/app-l3 治理状态时使用。用于输出可复现的量化概览，而不是直接开始重构。 激活提示：当用户任务与“directory-structure-governance-overview”描述的流程高度相关时，先用它做安装前体验，再决定是否安装。 证据：`.agents/skills/directory-structure-governance-overview/SKILL.md`
- **file-naming-convention**（skill）：在 TypeScript/JavaScript 实现将新增、重命名、移动或触达文件前，前置校验 kebab-case、角色后缀和目录映射；也用于命名规范、文件重命名、模块化重构与命名治理。首次实质编辑前必须执行 planned-path preflight。 激活提示：当用户任务与“file-naming-convention”描述的流程高度相关时，先用它做安装前体验，再决定是否安装。 证据：`.agents/skills/file-naming-convention/SKILL.md`
- **file-organization-governance**（skill）：自动检测和改善代码库的文件组织结构，确保代码具有清晰的模块化和分层架构。使用模块化分割（按功能领域）和分层抽象（按职责分层）的双重策略，在每次代码修改后自动运行检测，或在目录文件数超过阈值时触发。 激活提示：当用户任务与“file-organization-governance”描述的流程高度相关时，先用它做安装前体验，再决定是否安装。 证据：`.agents/skills/file-organization-governance/SKILL.md`
- **frontend-code-optimization**（skill）：当用户要求前端代码优化、前端可维护性治理、组件拆分、逻辑拆分、视图逻辑解耦、MVP / presenter-manager-store 落地、prop 透传改造、页面/组件代码爆炸 review、React 组件职责收敛、前端重构优先级排序，或指出某个前端 Page/Component 可维护性爆炸时使用。用于把前端优化任务先诊断、排序，再按非新增功能净减约束实施。 激活提示：当用户任务与“frontend-code-optimization”描述的流程高度相关时，先用它做安装前体验，再决定是否安装。 证据：`.agents/skills/frontend-code-optimization/SKILL.md`
- **frontend-interaction-quality**（skill）：当设计、修改或评估前端交互体验、按钮与链接语义、URL 跳转、hover/focus/active/disabled 状态、tooltip、popover、菜单、键盘可达性、紧凑模式下的操作可理解性，用户要求“像 Windows / 某成熟产品”“体验对齐”“达到某产品级别”，或指出“这个操作不知道是什么”“体验不统一”“交互规范”时使用。 激活提示：当用户任务与“frontend-interaction-quality”描述的流程高度相关时，先用它做安装前体验，再决定是否安装。 证据：`.agents/skills/frontend-interaction-quality/SKILL.md`
- **frontend-style-encapsulation**（skill）：当修改前端样式、基础组件、展示组件、设置界面、设置行/分组表单、列表-详情设置页、响应式布局、紧凑模式、低边框视觉、Tailwind/CSS/container query、组件视觉状态，或用户质疑样式是否内聚、可移植、自洽时使用；尤其适用于 reusable UI package、shared component、跨宿主复用组件的样式 owner 判断。 激活提示：当用户任务与“frontend-style-encapsulation”描述的流程高度相关时，先用它做安装前体验，再决定是否安装。 证据：`.agents/skills/frontend-style-encapsulation/SKILL.md`
- **goal-mode**（skill）：当用户明确要求进入“目标模式”、要求持续推进直到目标完成、要求带目标锚点/锚点计数器，或要求在复杂任务中以目标完成作为停止条件时使用。 激活提示：当用户任务与“goal-mode”描述的流程高度相关时，先用它做安装前体验，再决定是否安装。 证据：`.agents/skills/goal-mode/SKILL.md`
- **goal-progress-anchor**（skill）：当复杂任务会跨多轮推进、容易偏航、容易遗忘原始目标或在讨论中逐步滑向新问题时使用。通过一个极短的 goal-progress 文件和回复计数器，强制周期性重新对齐目标、边界与下一步。 激活提示：当用户任务与“goal-progress-anchor”描述的流程高度相关时，先用它做安装前体验，再决定是否安装。 证据：`.agents/skills/goal-progress-anchor/SKILL.md`
- **integrating-http-agent-runtime**（skill）：Use when connecting Hermes or another external HTTP-backed agent runtime into NextClaw, especially when the AI must wire agents.runtimes.entries config, expose a selectable session type, validate end-to-end runtime behavior, and debug readiness, streaming, or adapter issues. 激活提示：当用户任务与“integrating-http-agent-runtime”描述的流程高度相关时，先用它做安装前体验，再决定是否安装。 证据：`.agents/skills/integrating-http-agent-runtime/SKILL.md`
- **integrating-narp-stdio-runtime**（skill）：当把 Codex、Claude Code、Hermes 或其他外部 agent runtime 通过 NARP stdio 接入 NextClaw，或讨论 narp-stdio runtime entries、stdio launcher、agent-side wrapper、迁移旧 agent-runtime 插件时使用。 激活提示：当用户任务与“integrating-narp-stdio-runtime”描述的流程高度相关时，先用它做安装前体验，再决定是否安装。 证据：`.agents/skills/integrating-narp-stdio-runtime/SKILL.md`
- **isolated-npm-release-worktree**（skill）：当用户要发布已经提交的 NPM 包，但当前工作区还有未完成、半吊子、staged/unstaged WIP，或用户明确要求“不要把未完成改动发上去”“隔离发布”“全部发布”“发布产物再合回 master”时使用。覆盖 git worktree 隔离发布、NPM stable/beta 全量或窄发布、保护当前 WIP、registry 验证、release commit/tag 回流本地目标分支。 激活提示：当用户任务与“isolated-npm-release-worktree”描述的流程高度相关时，先用它做安装前体验，再决定是否安装。 证据：`.agents/skills/isolated-npm-release-worktree/SKILL.md`
- **iteration-work-notes**（skill）：Use when a complex task or debugging effort will span multiple turns or sessions, context may be compressed or handed off, and you need structured working notes under the current docs/logs iteration work directory to preserve facts, evidence, decisions, and next steps. 激活提示：当用户任务与“iteration-work-notes”描述的流程高度相关时，先用它做安装前体验，再决定是否安装。 证据：`.agents/skills/iteration-work-notes/SKILL.md`
- **kernel-branch-owner-architecture**（skill）：当设计或重构主干/分支架构、kernel、desktop main、runtime host、presenter-manager-store、manager/store/presenter、生命周期装配、owner 依赖、贡献点 contribution，或用户指出最小传参、上层代读、factory/create/registry 过度抽象、稳定业务依赖被过度解耦、prop 透传或链路过长时使用。 激活提示：当用户任务与“kernel-branch-owner-architecture”描述的流程高度相关时，先用它做安装前体验，再决定是否安装。 证据：`.agents/skills/kernel-branch-owner-architecture/SKILL.md`
- **layered-root-cause-analysis**（skill）：当用户要求分析“根因”、追问“为什么”、指出“根因也分多层”、要求事故复盘、系统性缺口分析、理念沉淀，或需要从单点报错上升到写入路径、合同边界、韧性缺口、治理机制与产品架构层面的分层判断时使用。适用于普通 bug、运行事故、设计缺陷和流程失效；长链路排查仍由 long-chain-debugging 负责。 激活提示：当用户任务与“layered-root-cause-analysis”描述的流程高度相关时，先用它做安装前体验，再决定是否安装。 证据：`.agents/skills/layered-root-cause-analysis/SKILL.md`
- **learning-from-failures**（skill）：当用户指出同类错误反复发生、用反讽/夸张表扬/连续纠偏表达“你又没学到”、要求“反思”“总结教训”“从错误中学习”“怎么避免再次发生”“你学习了吗”，或用户给出明显更优的设计/删减/简化/职责收敛建议，或任务暴露出流程、规则、skill、验证机制缺口时使用。用于把失败、纠偏和高质量反馈转成可复用机制改进，并决定是否更新 AGENTS、已有 skill、新 skill、命令、治理脚本或验证流程。 激活提示：当用户任务与“learning-from-failures”描述的流程高度相关时，先用它做安装前体验，再决定是否安装。 证据：`.agents/skills/learning-from-failures/SKILL.md`
- **local-source-runtime-validation**（skill）：当用户要在本地验证当前源码构建出的 NextClaw 产品实例、restart/start/stop、避免跑到全局安装版 nextclaw、需要可复用本地安装态/构建态验证命令或 smoke harness 时使用。 激活提示：当用户任务与“local-source-runtime-validation”描述的流程高度相关时，先用它做安装前体验，再决定是否安装。 证据：`.agents/skills/local-source-runtime-validation/SKILL.md`
- **long-chain-debugging**（skill）：Use when a bug spans multiple hops, layers, runtimes, transports, or async boundaries and naive end-to-end debugging is slow. Applies to 长链路排查、根因定位、复现不稳、复现收益与成本权衡、链路切片、观察点设计、证据收敛与修后同链路验收。 激活提示：当用户任务与“long-chain-debugging”描述的流程高度相关时，先用它做安装前体验，再决定是否安装。 证据：`.agents/skills/long-chain-debugging/SKILL.md`
- **marketplace-skill-publisher**（skill）：在本仓库将本地 skill 发布或更新到 NextClaw marketplace 时使用。适用于新增 marketplace skill、从 SkillHub 继承 skill 到本项目 marketplace、补齐 marketplace.json 双语元数据、执行发布后远端校验与安装冒烟。 激活提示：当用户任务与“marketplace-skill-publisher”描述的流程高度相关时，先用它做安装前体验，再决定是否安装。 证据：`.agents/skills/marketplace-skill-publisher/SKILL.md`
- **mvp-view-logic-decoupling**（skill）：当设计或重构前端 MVP / presenter-manager-store 架构、Zustand store / persist、前端状态归属、view-logic 解耦、页面刷新状态恢复、localStorage/sessionStorage 替代、减少 prop drilling、业务组件内聚、自包含业务容器、业务编排层、多组件状态/动作协调、复杂 React hook/component 状态机、streaming/data-flow 协调或 RxJS 评估时使用。 激活提示：当用户任务与“mvp-view-logic-decoupling”描述的流程高度相关时，先用它做安装前体验，再决定是否安装。 证据：`.agents/skills/mvp-view-logic-decoupling/SKILL.md`
- **nextclaw-agent-instructions-governance**（skill）：Use when editing AGENTS.md, commands/commands.md, Rulebook or Project Rulebook content, project AI instructions, or deciding whether a rule belongs in AGENTS.md, a skill, or ordinary docs. Also use when the user says to remember a rule/principle/norm, or for /config-meta, /check-meta, /new-rule, and AGENTS token optimization. 激活提示：当用户任务与“nextclaw-agent-instructions-governance”描述的流程高度相关时，先用它做安装前体验，再决定是否安装。 证据：`.agents/skills/nextclaw-agent-instructions-governance/SKILL.md`
- **nextclaw-clean-implementation**（skill）：Use when implementing, refactoring, or designing source-level contracts in this repository, especially if a task touches frontend/backend i18n or user-facing copy, frontend base/display components, tool schemas, API/protocol parameters, shared contracts, compatibility paths, fallback-heavy logic, duplicate branches, weak abstractions, unclear file placement, ad-hoc helpers, or patch-style fixes that would turn into… 激活提示：当用户任务与“nextclaw-clean-implementation”描述的流程高度相关时，先用它做安装前体验，再决定是否安装。 证据：`.agents/skills/nextclaw-clean-implementation/SKILL.md`
- **nextclaw-dead-code-governance**（skill）：当用户要求扫描、识别、清理、常态化治理 NextClaw 仓库里的死代码、无用代码、unused files、unused exports、unused dependencies，尤其是核心包越来越臃肿、想删旧实现或做定期减债时使用。 激活提示：当用户任务与“nextclaw-dead-code-governance”描述的流程高度相关时，先用它做安装前体验，再决定是否安装。 证据：`.agents/skills/nextclaw-dead-code-governance/SKILL.md`
- **nextclaw-delivery-workflow**（skill）：用作 NextClaw 标准开发流程/交付流程的总 owner；当用户要求规范开发流程、实现、修复、重构、方案到实现、验证、提交、收尾、完成工作，或需要阶段化节奏与主动汇报时使用。 激活提示：当用户任务与“nextclaw-delivery-workflow”描述的流程高度相关时，先用它做安装前体验，再决定是否安装。 证据：`.agents/skills/nextclaw-delivery-workflow/SKILL.md`
- **nextclaw-iteration-log-governance**（skill）：Use when deciding, creating, or updating docs/logs iteration records; when the user asks to commit/提交/收尾 after changes; when changes touch code, scripts, tests, runtime config, large non-code governance/docs rewrites, NPM release records, root-cause fix notes, red-zone touch records, work notes, or goal-progress anchors. 激活提示：当用户任务与“nextclaw-iteration-log-governance”描述的流程高度相关时，先用它做安装前体验，再决定是否安装。 证据：`.agents/skills/nextclaw-iteration-log-governance/SKILL.md`
- **nextclaw-marketplace-skill-integration**（skill）：Use when evaluating, adapting, or creating a new skill for the NextClaw skill marketplace, especially when wrapping upstream skills, external tools, or external runtimes into a complete user-facing skill experience. 激活提示：当用户任务与“nextclaw-marketplace-skill-integration”描述的流程高度相关时，先用它做安装前体验，再决定是否安装。 证据：`.agents/skills/nextclaw-marketplace-skill-integration/SKILL.md`
- **nextclaw-release-notes-automation**（skill）：当用户要求提交、收尾、统一 NPM 发布、GitHub release、changelog、release notes、版本更新说明、产品更新笔记、X/社交媒体发布帖、变更汇总，或担心并行会话导致发布内容靠记忆整理时使用。适用于需要进入用户可见发布说明的 NextClaw workspace 包变更、Changesets 聚合、AI 撰写版本更新笔记、可拉取结构化 release notes JSON、minor 及以上版本宣发帖，以及 update manifest releaseNotesUrl 闭环。 激活提示：当用户任务与“nextclaw-release-notes-automation”描述的流程高度相关时，先用它做安装前体验，再决定是否安装。 证据：`.agents/skills/nextclaw-release-notes-automation/SKILL.md`
- **nextclaw-solution-design**（skill）：当用户要求技术方案、方案设计、设计文档、架构方案、实现前设计、交互/前端/后端方案，或开发流程进入“先设计再实现”的阶段时使用。用于产出可执行的方案设计合同，覆盖现状证据、owner、数据流、目录组织、可维护性、非目标、风险与验证标准；本 skill 是开发流程中的方案设计专项，不是完整开发 workflow owner。 激活提示：当用户任务与“nextclaw-solution-design”描述的流程高度相关时，先用它做安装前体验，再决定是否安装。 证据：`.agents/skills/nextclaw-solution-design/SKILL.md`
- **nextclaw-validation-workflow**（skill）：Use when running /validate, choosing validation commands after changes, closing code work, checking TypeScript/build/lint requirements, doing bugfix resolution verification, smoke testing, runtime startup/status log verification, maintainability guard/review, governance ratchets, release validation, or evaluating automated/unattended deployment credentials and production deploy paths. 激活提示：当用户任务与“nextclaw-validation-workflow”描述的流程高度相关时，先用它做安装前体验，再决定是否安装。 证据：`.agents/skills/nextclaw-validation-workflow/SKILL.md`
- **node-pnpm-locator**（skill）：Use when node/pnpm/npx/corepack are missing from PATH or build/test commands fail with "command not found" on macOS/Linux shells. 激活提示：当用户任务与“node-pnpm-locator”描述的流程高度相关时，先用它做安装前体验，再决定是否安装。 证据：`.agents/skills/node-pnpm-locator/SKILL.md`
- **npm-beta-release**（skill）：当用户要求“发布 beta”“统一 beta 发版”“发一个新的 NPM beta 版本”“一键 beta release”或希望直接复用 NextClaw 的 beta 发布闭环时使用。适用于 nextclaw 及其相关 workspace 包的 beta 发布，也适用于需要同时闭合 npm registry 与 NPM runtime update channel 的场景。 激活提示：当用户任务与“npm-beta-release”描述的流程高度相关时，先用它做安装前体验，再决定是否安装。 证据：`.agents/skills/npm-beta-release/SKILL.md`
- **npm-release-contract-guard**（skill）：Use when publishing NextClaw NPM packages or NPM runtime update channels, including beta/stable dist-tags, nextclaw@beta validation, runtime bundle manifests, packaged update public keys, and npm registry closure checks. 激活提示：当用户任务与“npm-release-contract-guard”描述的流程高度相关时，先用它做安装前体验，再决定是否安装。 证据：`.agents/skills/npm-release-contract-guard/SKILL.md`
- **post-edit-maintainability-guard**（skill）：在本仓库完成代码、脚本、测试或影响运行链路的配置改动后使用，用于自检可维护性漂移，重点发现超长文件和持续膨胀的文件。 激活提示：当用户任务与“post-edit-maintainability-guard”描述的流程高度相关时，先用它做安装前体验，再决定是否安装。 证据：`.agents/skills/post-edit-maintainability-guard/SKILL.md`
- **post-edit-maintainability-review**（skill）：Use when code changes are finished and a second-pass maintainability review is needed beyond lint or guard output, especially to judge deletion opportunities, simplification chances, abstraction fit, or whether non-feature changes added unjustified code 激活提示：当用户任务与“post-edit-maintainability-review”描述的流程高度相关时，先用它做安装前体验，再决定是否安装。 证据：`.agents/skills/post-edit-maintainability-review/SKILL.md`
- **predictable-behavior-first**（skill）：Use when a task involves fallbacks, backward compatibility, graceful degradation, environment-specific rescue paths, legacy retention, or "just in case" compatibility logic. Prefer explicit, clear, predictable behavior over hidden rescue paths, and require strict necessity plus exit conditions for any compatibility path. 激活提示：当用户任务与“predictable-behavior-first”描述的流程高度相关时，先用它做安装前体验，再决定是否安装。 证据：`.agents/skills/predictable-behavior-first/SKILL.md`
- **proactive-work-continuation**（skill）：当用户要求“主动干活”“继续推进”“不要停”“你怎么又停了”、指出任务未完成却停止、在复杂任务中追加纠偏/新约束，或需要判断是否可以收尾时使用。用于防止把阶段性回复、局部文档更新、单次验证通过或用户纠偏误当成暂停信号，要求吸收最新约束后继续推进到真实完成、真实阻塞或用户明确要求停止。 激活提示：当用户任务与“proactive-work-continuation”描述的流程高度相关时，先用它做安装前体验，再决定是否安装。 证据：`.agents/skills/proactive-work-continuation/SKILL.md`
- **product-blog-storytelling**（skill）：当用户要为 NextClaw 写产品博客、短文、官网文章、版本更新说明、宣传叙事、功能优势阐述、发布故事、配图建议，或要求把某个产品点讲清楚、写得更有传播力时使用。用于把产品愿景、真实证据、用户痛点、差异化判断和可发布文案收敛成可复用写作流程。 激活提示：当用户任务与“product-blog-storytelling”描述的流程高度相关时，先用它做安装前体验，再决定是否安装。 证据：`.agents/skills/product-blog-storytelling/SKILL.md`
- **project-knowledge-governance**（skill）：当用户要求沉淀、整理、归档、维护或分流项目想法、产品思考、讨论记录、PRD、设计、计划、路线图、TODO、docs/thoughts、docs/designs、docs/plans 或 docs/logs 迭代记录时使用。用于判断内容应进入 docs/TODO.md、docs/thoughts、docs/designs、docs/plans、docs/prd、docs/ROADMAP.md 还是 docs/logs，并维护它们之间的升级关系。 激活提示：当用户任务与“project-knowledge-governance”描述的流程高度相关时，先用它做安装前体验，再决定是否安装。 证据：`.agents/skills/project-knowledge-governance/SKILL.md`
- **project-os**（skill）：AI project OS for autonomous loop, automated orchestration, and rule-driven execution. 激活提示：当用户任务与“project-os”描述的流程高度相关时，先用它做安装前体验，再决定是否安装。 证据：`.agents/skills/project-os/SKILL.md`
- **react-rendering-lifecycle-safety**（skill）：当编写、修改或审查 React 组件类型、动态 renderer/component map、列表 key、条件包装、streaming UI、ReactMarkdown、自定义 render prop，或 iframe/canvas/editor/audio/video/Panel App 等必须保持实例状态的界面时使用；也适用于排查流式更新、受控 editor、beforeinput/composition/IME 输入法导致的焦点、文字选区、弹层或内嵌应用状态丢失。用于保证 React 元素身份、DOM 连续性和用户交互状态不被后台更新破坏。 激活提示：当用户任务与“react-rendering-lifecycle-safety”描述的流程高度相关时，先用它做安装前体验，再决定是否安装。 证据：`.agents/skills/react-rendering-lifecycle-safety/SKILL.md`
- **refresh-product-visual-assets**（skill）：当 NextClaw 产品更新后需要重生成、替换或检查官网、GitHub README、用户文档中的产品截图、真实会话截图、功能演示图、社区二维码或其它对外视觉资产时使用；也用于用户提出“更新截图”“重新截一批图”“用真实实例生成图片”“同步 landing 与仓库图片”“更新微信群二维码”或发布前检查图片是否受本次变化影响。负责按资产类型选择自动或精选流程、保持默认/雾蓝主题与真实代表性数据、同步镜像并完成尺寸、引用、隐私和展示质量验收。 激活提示：当用户任务与“refresh-product-visual-assets”描述的流程高度相关时，先用它做安装前体验，再决定是否安装。 证据：`.agents/skills/refresh-product-visual-assets/SKILL.md`
- **replicating-reference-skins**（skill）：Use when复刻外部主题、皮肤或界面参考图，尤其是要求整套产品、全部区域、组件与交互状态采用统一风格，或当前效果只像换背景、空状态通过但真实数据页失真、侧边栏与列表未适配、需要对比原图或持续预览时。 激活提示：当用户任务与“replicating-reference-skins”描述的流程高度相关时，先用它做安装前体验，再决定是否安装。 证据：`.agents/skills/replicating-reference-skins/SKILL.md`
- **role-first-file-organization**（skill）：用于整理 TypeScript/JavaScript 文件结构、判断文件职责角色、重命名模块、清理分层目录边界不清的问题。尤其适用于 service/store/utils/config/types 角色混乱、开始冒出假角色、习惯性添加 index.ts barrel，或把领域名误当成架构角色的场景。 激活提示：当用户任务与“role-first-file-organization”描述的流程高度相关时，先用它做安装前体验，再决定是否安装。 证据：`.agents/skills/role-first-file-organization/SKILL.md`
- **testing-local-extension-development-source**（skill）：当本仓库本地调试 NextClaw extension/channel extension、修改 packages/extensions/ 源码、调试 Claude Code NARP runtime、遇到 dev 运行旧 dist/main.js，或需要验证未发布 extension 源码时使用。 激活提示：当用户任务与“testing-local-extension-development-source”描述的流程高度相关时，先用它做安装前体验，再决定是否安装。 证据：`.agents/skills/testing-local-extension-development-source/SKILL.md`
- **unsigned-desktop-release-playbook**（skill）：Reusable playbook for shipping unsigned desktop builds on macOS and Windows with clear user-opening guidance, integrity checks, and GitHub pre-release notes. 激活提示：当用户任务与“unsigned-desktop-release-playbook”描述的流程高度相关时，先用它做安装前体验，再决定是否安装。 证据：`.agents/skills/unsigned-desktop-release-playbook/SKILL.md`
- **user-facing-content-boundary**（skill）：当写、重写或重新设计任何用户可见内容时使用，包括官网、首页、UI 文案、更新提示、release notes、changelog、README 对外说明、用户文档、产品介绍、营销内容、截图说明和社交分享元信息；尤其适用于隔离内部讨论与最终呈现、判断旧内容能否继续作为结构基线、区分能力说明与真实用例场景、校验截图数据源，以及检查中文文案是否自然。 激活提示：当用户任务与“user-facing-content-boundary”描述的流程高度相关时，先用它做安装前体验，再决定是否安装。 证据：`.agents/skills/user-facing-content-boundary/SKILL.md`
- **smoke-testing-ncp-chat**（skill）：Use when a running NextClaw service needs a real NCP chat smoke for a specific session type and model, especially when validating text replies, tool calls, reasoning events, or comparing runtimes with blind/isolated smoke tests. 激活提示：当用户任务与“smoke-testing-ncp-chat”描述的流程高度相关时，先用它做安装前体验，再决定是否安装。 证据：`.agents/skills/verifying-chat-capability/SKILL.md`
- **writing-beautiful-code**（skill）：当写代码前、给技术方案前，或讨论、审查、重构代码审美、代码是否干净、是否丑、是否优雅、是否简单优先、是否简单第一、代码/组件/函数/文件/模块该不该拆分、拆分价值与损失、是否过度防卫、是否过度抽象、是否像补丁堆叠，或用户明确要求提升代码审美、写出美丽代码时使用。 激活提示：当用户任务与“writing-beautiful-code”描述的流程高度相关时，先用它做安装前体验，再决定是否安装。 证据：`.agents/skills/writing-beautiful-code/SKILL.md`
- **x-twitter-bird**（skill）：Use when the user wants to read bookmarks, likes, threads, search X/Twitter, or draft/post/reply through bird CLI with reusable local credentials stored on this machine. 激活提示：当用户任务与“x-twitter-bird”描述的流程高度相关时，先用它做安装前体验，再决定是否安装。 证据：`.agents/skills/x-twitter-bird/SKILL.md`
- **agent-browser**（skill）：Use Agent Browser for real browser navigation, dynamic pages, and web interaction; also use it as a distinct browser-based path when web search is unavailable or fails. 激活提示：当用户任务与“agent-browser”描述的流程高度相关时，先用它做安装前体验，再决定是否安装。 证据：`packages/nextclaw-core/src/features/agent/shared/skills/agent-browser/SKILL.md`
- **automation-setup**（skill）：Turn a user request into a scheduled automation by configuring cron jobs, including session-bound follow-ups and periodic checks. 激活提示：当用户任务与“automation-setup”描述的流程高度相关时，先用它做安装前体验，再决定是否安装。 证据：`packages/nextclaw-core/src/features/agent/shared/skills/automation-setup/SKILL.md`
- **cron**（skill）：Schedule reminders and recurring tasks. 激活提示：当用户任务与“cron”描述的流程高度相关时，先用它做安装前体验，再决定是否安装。 证据：`packages/nextclaw-core/src/features/agent/shared/skills/cron/SKILL.md`
- **cross-channel-messaging**（skill）：Use when the user wants the AI to send, relay, or notify through another NextClaw session or chat channel, especially after work completes, including deciding between a normal reply and message, and resolving route/account details without guessing. 激活提示：当用户任务与“cross-channel-messaging”描述的流程高度相关时，先用它做安装前体验，再决定是否安装。 证据：`packages/nextclaw-core/src/features/agent/shared/skills/cross-channel-messaging/SKILL.md`
- **github**（skill）：Interact with GitHub using the gh CLI. Use gh issue , gh pr , gh run , and gh api for issues, PRs, CI runs, and advanced queries. 激活提示：当用户任务与“github”描述的流程高度相关时，先用它做安装前体验，再决定是否安装。 证据：`packages/nextclaw-core/src/features/agent/shared/skills/github/SKILL.md`
- **hermes-runtime**（skill）：Use when Hermes needs to become a formal NextClaw runtime entry, especially for setup, doctor, repair, readiness checks, and first-message smoke on the preferred narp-stdio acp path. 激活提示：当用户任务与“hermes-runtime”描述的流程高度相关时，先用它做安装前体验，再决定是否安装。 证据：`packages/nextclaw-core/src/features/agent/shared/skills/hermes-runtime/SKILL.md`
- **nextclaw-app-creator**（skill）：Create or update complete NextClaw lightweight apps, deciding whether the user needs a Panel App, a Service App, or a combined Panel + Service App. Use for NextClaw applets, small tools, dashboards, local file tools, AI-assisted UI tools, apps that may combine right-side UI with backend actions, or questions about what NextClaw/Panel apps can do and which app APIs/capabilities they can use. 激活提示：当用户任务与“nextclaw-app-creator”描述的流程高度相关时，先用它做安装前体验，再决定是否安装。 证据：`packages/nextclaw-core/src/features/agent/shared/skills/nextclaw-app-creator/SKILL.md`
- **nextclaw-autostart**（skill）：Use when the user asks about NextClaw autostart, auto-start on login or reboot, daemon/service registration, LaunchAgent, systemd, Windows Scheduled Task, service autostart, nextclaw start not surviving OS restart, or NPM install startup experience. 适用于开机自启动、系统重启后自动恢复、后台服务注册与自启动排查。 激活提示：当用户任务与“nextclaw-autostart”描述的流程高度相关时，先用它做安装前体验，再决定是否安装。 证据：`packages/nextclaw-core/src/features/agent/shared/skills/nextclaw-autostart/SKILL.md`
- **nextclaw-self-manage**（skill）：Self-manage NextClaw runtime via CLI guide. For install/start/status/doctor/service/channels/config/agents/projects/sessions/cron/remote/update operations, and for discovering local HTTP/API/webhook addresses. 激活提示：当用户任务与“nextclaw-self-manage”描述的流程高度相关时，先用它做安装前体验，再决定是否安装。 证据：`packages/nextclaw-core/src/features/agent/shared/skills/nextclaw-self-manage/SKILL.md`
- **nextclaw-skill-resource-hub**（skill）：Curate NextClaw skill resources, including OpenClaw and community sources. Use when expanding NextClaw skills, planning reuse/adaptation, or building a skill roadmap. 激活提示：当用户任务与“nextclaw-skill-resource-hub”描述的流程高度相关时，先用它做安装前体验，再决定是否安装。 证据：`packages/nextclaw-core/src/features/agent/shared/skills/nextclaw-skill-resource-hub/SKILL.md`
- **panel-app-creator**（skill）：Create or update the Panel App UI part of a NextClaw lightweight app. Use after nextclaw-app-creator selects Panel-only or Panel + Service, or when the user explicitly asks for a right-side Panel App UI, folder-based static panel, Service Actions UI, Agent-powered Panel App, React/Vite/Tailwind Panel App, or asks what a Panel App can do and which injected APIs/capabilities it can use. 激活提示：当用户任务与“panel-app-creator”描述的流程高度相关时，先用它做安装前体验，再决定是否安装。 证据：`packages/nextclaw-core/src/features/agent/shared/skills/panel-app-creator/SKILL.md`
- **panel-app-react-vite-creator**（skill）：Create or update an engineering-style NextClaw Panel App using pnpm, Vite, React, TypeScript, and Tailwind CSS, then build it into a static .panel directory. Use when the user asks for a modern frontend stack, React Panel App, Vite app, Tailwind UI, or reusable/buildable Panel App project, and when the requested Panel App has complex UI/state, AI chat or Agent Run workflows, charts, filters, forms, or needs TypeScri… 激活提示：当用户任务与“panel-app-react-vite-creator”描述的流程高度相关时，先用它做安装前体验，再决定是否安装。 证据：`packages/nextclaw-core/src/features/agent/shared/skills/panel-app-react-vite-creator/SKILL.md`
- **qq-group-speaker-distinction**（skill）：Use when integrating QQ group chat where users want one shared group session, but the assistant must still distinguish who said each message. 激活提示：当用户任务与“qq-group-speaker-distinction”描述的流程高度相关时，先用它做安装前体验，再决定是否安装。 证据：`packages/nextclaw-core/src/features/agent/shared/skills/qq-group-speaker-distinction/SKILL.md`
- **qq-url-guard**（skill）：Use when sending replies to QQ where URL-like text for example xx.xx, USER.md, markdown links, or http URLs may trigger code 40034028 and get blocked. 激活提示：当用户任务与“qq-url-guard”描述的流程高度相关时，先用它做安装前体验，再决定是否安装。 证据：`packages/nextclaw-core/src/features/agent/shared/skills/qq-url-guard/SKILL.md`
- **service-app-creator**（skill）：Create or update the Service App backend action part of a NextClaw lightweight app. Use after nextclaw-app-creator selects Service-only or Panel + Service, or when the user explicitly asks for workspace service-apps, MCP-compatible backend helpers, file access, external API calls, local commands, or privileged actions. 激活提示：当用户任务与“service-app-creator”描述的流程高度相关时，先用它做安装前体验，再决定是否安装。 证据：`packages/nextclaw-core/src/features/agent/shared/skills/service-app-creator/SKILL.md`
- **skill-creator**（skill）：Create or update AgentSkills. Use when designing, structuring, or packaging skills with scripts, references, and assets. 激活提示：当用户任务与“skill-creator”描述的流程高度相关时，先用它做安装前体验，再决定是否安装。 证据：`packages/nextclaw-core/src/features/agent/shared/skills/skill-creator/SKILL.md`
- **summarize**（skill）：Summarize or extract text/transcripts from URLs, podcasts, and local files great fallback for “transcribe this YouTube/video” . 激活提示：当用户任务与“summarize”描述的流程高度相关时，先用它做安装前体验，再决定是否安装。 证据：`packages/nextclaw-core/src/features/agent/shared/skills/summarize/SKILL.md`
- **tmux**（skill）：Remote-control tmux sessions for interactive CLIs by sending keystrokes and scraping pane output. 激活提示：当用户任务与“tmux”描述的流程高度相关时，先用它做安装前体验，再决定是否安装。 证据：`packages/nextclaw-core/src/features/agent/shared/skills/tmux/SKILL.md`
- **visualize-output**（skill）：Create clear, restrained visual presentations for answers and results by choosing among Markdown, tables, Mermaid, images, and self-contained inline HTML. Use when the user asks for a visualization, chart, diagram, comparison, timeline, status/result view, or when spatial layout would materially improve understanding in the current conversation; read this skill before any other visualization tool call. Use nextclaw-… 激活提示：当用户任务与“visualize-output”描述的流程高度相关时，先用它做安装前体验，再决定是否安装。 证据：`packages/nextclaw-core/src/features/agent/shared/skills/visualize-output/SKILL.md`
- **weather**（skill）：Get current weather and forecasts no API key required . 激活提示：当用户任务与“weather”描述的流程高度相关时，先用它做安装前体验，再决定是否安装。 证据：`packages/nextclaw-core/src/features/agent/shared/skills/weather/SKILL.md`
- **aigen-image-generation**（skill）：Use the local aigen CLI to generate images through configured providers such as OpenRouter or OpenAI. Use when the user asks to create, generate, or render images and wants files produced locally through an external CLI. 激活提示：当用户任务与“aigen-image-generation”描述的流程高度相关时，先用它做安装前体验，再决定是否安装。 证据：`skills/aigen-image-generation/SKILL.md`
- **bb-browser**（skill）：Use when the user wants browser-backed web data access, authenticated fetches, website adapters, or safe browser automation through a local bb-browser installation. 激活提示：当用户任务与“bb-browser”描述的流程高度相关时，先用它做安装前体验，再决定是否安装。 证据：`skills/bb-browser/SKILL.md`
- **browser-control**（skill）：Use the local browser-connector CLI to inspect and operate the user's current Chrome tabs through the Browser Connector extension and Native Host. Use when the user asks to list open browser pages, read a current page, capture a screenshot, or perform controlled browser interactions from NextClaw. 激活提示：当用户任务与“browser-control”描述的流程高度相关时，先用它做安装前体验，再决定是否安装。 证据：`skills/browser-control/SKILL.md`
- **claude-code-narp-runtime**（skill）：当用户希望把 Claude Code 作为 NextClaw 正式会话类型接入，尤其是通过 narp-stdio 配置、安装、修复、doctor、补齐 Runtime default 模型选项或真实冒烟时使用。 激活提示：当用户任务与“claude-code-narp-runtime”描述的流程高度相关时，先用它做安装前体验，再决定是否安装。 证据：`skills/claude-code-narp-runtime/SKILL.md`
- 其余 16 个条目见 `AI_CONTEXT_PACK.json`。

## 证据索引

- 共索引 176 条证据。

- **Logs**（documentation）：- docs/logs/v0.0.1-mvp/README.md - docs/logs/v0.1.0-headless/README.md 证据：`.agents/skills/project-os/assets/docs/logs/README.md`
- **2026-02-23 Config Watch Fix v0.8.7**（documentation）：迭代完成说明（改了什么） - 将配置热重载监听范围从配置目录缩小到 config.json 文件本身，避免递归监听导致 inotify watcher 耗尽。 - 发布版本更新： nextclaw@0.8.7 。 证据：`docs/logs/2026-02-23-config-watch-fix/v0.8.7-config-watch-scope/README.md`
- **2026-02-23 Cron UI 查看与删除**（documentation）：迭代完成说明（改了什么） - 新增 UI 端 Cron 定时任务页面：支持查看任务详情、筛选、刷新、启用/禁用、立即执行与删除。 - UI API 增加： - GET /api/cron / DELETE /api/cron/:id - PUT /api/cron/:id/enable （启用/禁用） - POST /api/cron/:id/run （立即执行，可强制） - UI 路由与侧边栏新增“定时任务”入口，完善国际化文案。 证据：`docs/logs/2026-02-23-cron-ui/v0.8.14-cron-ui/README.md`
- **2026-02-23 v0.6.32-discord-slash-commands**（documentation）：2026-02-23 v0.6.32-discord-slash-commands 证据：`docs/logs/2026-02-23-discord-slash-commands/v0.6.32-discord-slash-commands/README.md`
- **2026-02-23 v0.8.14-discord-slash-timeout-fix**（documentation）：2026-02-23 v0.8.14-discord-slash-timeout-fix 证据：`docs/logs/2026-02-23-discord-slash-commands/v0.8.14-discord-slash-timeout-fix/README.md`
- **2026-02-23 v0.8.15-discord-streaming-preview**（documentation）：2026-02-23 v0.8.15-discord-streaming-preview 证据：`docs/logs/2026-02-23-discord-streaming-preview/v0.8.15-discord-streaming-preview/README.md`
- **2026-02-23 v0.8.15-frontend-ui-refresh**（documentation）：2026-02-23 v0.8.15-frontend-ui-refresh 证据：`docs/logs/2026-02-23-frontend-ui-refresh/v0.8.15-frontend-ui-refresh/README.md`
- **2026-02-23 v0.8.9-ui-confirm-dialog-release**（documentation）：2026-02-23 v0.8.9-ui-confirm-dialog-release 证据：`docs/logs/2026-02-23-ui-confirm-dialog-release/v0.8.9-ui-confirm-dialog-release/README.md`
- **2026-02-23 v0.8.10-weather-query-stall-fix**（documentation）：2026-02-23 v0.8.10-weather-query-stall-fix 证据：`docs/logs/2026-02-23-weather-query-stall-fix/v0.8.10-weather-query-stall-fix/README.md`
- **2026-02-25 v0.8.16-frontend-release-command**（documentation）：2026-02-25 v0.8.16-frontend-release-command 证据：`docs/logs/2026-02-25-frontend-release-command/v0.8.16-frontend-release-command/README.md`
- **2026-02-25 v0.8.19-language-switcher-single-line**（documentation）：2026-02-25 v0.8.19-language-switcher-single-line 证据：`docs/logs/2026-02-25-language-switcher-single-line/v0.8.19-language-switcher-single-line/README.md`
- **2026-02-25 v0.8.20-nextclaw-self-manage-release-notes**（documentation）：2026-02-25 v0.8.20-nextclaw-self-manage-release-notes 证据：`docs/logs/2026-02-25-nextclaw-self-manage-release-notes/v0.8.20-nextclaw-self-manage-release-notes/README.md`
- **2026-02-25 v0.8.20-npm-readme-sync**（documentation）：- 新增 npm README 源文件： - docs/npm-readmes/nextclaw.md - docs/npm-readmes/nextclaw-ui.md - 新增 README 同步脚本： - scripts/sync-npm-readmes.mjs - 将源文件同步到发布包目录： - packages/nextclaw/README.md - packages/nextclaw-ui/README.md - 发布流程接入 README 自动同步与校验： - package.json 新增 release:sync-readmes / release:check-readmes - release:version 与 release:publish 默认执行 README 同步与一致性检查 - 更新发布流程文档： - docs/workflows/npm-release-process.md 增加 README 同步步骤与自动说明 证据：`docs/logs/2026-02-25-npm-readme-sync/v0.8.20-npm-readme-sync/README.md`
- **2026-02-25 v0.8.18-providers-tab-count**（documentation）：2026-02-25 v0.8.18-providers-tab-count 证据：`docs/logs/2026-02-25-providers-tab-count/v0.8.18-providers-tab-count/README.md`
- **2026-02-25 v0.8.17-ui-full-i18n**（documentation）：- 完成 UI 国际化基础设施升级： - packages/nextclaw-ui/src/lib/i18n.ts 新增语言状态、浏览器语言识别、localStorage 持久化、日期/数字格式化。 - 新增 packages/nextclaw-ui/src/components/providers/I18nProvider.tsx ，并在 packages/nextclaw-ui/src/main.tsx 接入全局 Provider。 - 在侧边栏新增语言下拉切换器（可扩展多语言），并将导航文案改为动态国际化。 - 语言切换策略调整为“切换后整页 reload”，确保当前页（含 Marketplace）与未来可能接入的后端语言配置一致生效。 - 将主要可见页面/弹窗文案统一接入 i18n： - Model / Providers / Channels / Runtime / Sessions / Marketplace - ConfirmDialog 默认按钮文案 - 表单占位文案、状态文案、错误提示文案 - 修复“模块顶层调用 t 导致切换语言不刷新”的问题： - Sidebar 、 StatusBadge 、 ChannelForm 改为渲染期取词条。 - 日期与数字显示跟随当前语言： - Sessions / Cron 时间显示 - Tabs 计数显示 证据：`docs/logs/2026-02-25-ui-full-i18n/v0.8.17-ui-full-i18n/README.md`
- **2026-02-26 v0.8.20-dev-docs-command**（documentation）：2026-02-26 v0.8.20-dev-docs-command 证据：`docs/logs/2026-02-26-dev-docs-command/v0.8.20-dev-docs-command/README.md`
- **2026-02-26 v0.0.1-docs-language-nav-dedup**（documentation）：2026-02-26 v0.0.1-docs-language-nav-dedup 证据：`docs/logs/2026-02-26-docs-language-nav-dedup/v0.0.1-docs-language-nav-dedup/README.md`
- **2026-02-26 v0.0.1-docs-nav-ia-adjust**（documentation）：2026-02-26 v0.0.1-docs-nav-ia-adjust 证据：`docs/logs/2026-02-26-docs-nav-ia-adjust/v0.0.1-docs-nav-ia-adjust/README.md`
- **2026-02-26 v0.0.1-docs-readme-i18n**（documentation）：- 文档站改为双语并采用单一真源目录： - 英文文档统一在 apps/docs/en/ 。 - 中文文档统一在 apps/docs/zh/ 。 - 根入口改为语言选择页 apps/docs/index.md 。 - 删除旧目录 apps/docs/guide/ ，不再保留历史兼容路径。 - 重构 VitePress 多语言配置（ apps/docs/.vitepress/config.ts ），导航/侧边栏按语言分别配置。 - README 增加双语入口： - 更新 README.md ，补英文文档链接与语言切换入口。 - 新增 README.zh-CN.md ，提供中文说明与中文文档入口。 - 新增 i18n 结构校验脚本 scripts/docs-i18n-check.mjs ，并在根 package.json 增加 docs:i18n:check 命令。 - 同步更新仓库内文档引用，统一指向新文档路径（ /en/... 、 /zh/... ）。 证据：`docs/logs/2026-02-26-docs-readme-i18n/v0.0.1-docs-readme-i18n/README.md`
- **2026-02-26 v0.0.1-docs-root-locale-redirect**（documentation）：2026-02-26 v0.0.1-docs-root-locale-redirect 证据：`docs/logs/2026-02-26-docs-root-locale-redirect/v0.0.1-docs-root-locale-redirect/README.md`
- **2026-02-26 v0.8.20-docs-single-source**（documentation）：2026-02-26 v0.8.20-docs-single-source 证据：`docs/logs/2026-02-26-docs-single-source/v0.8.20-docs-single-source/README.md`
- **2026-02-26 v0.0.1-landing-i18n**（documentation）：- landing 国际化从“同 URL 运行时切换”升级为“路由级 i18n”： - / 只做语言重定向（基于 localStorage nextclaw.landing.locale 和浏览器语言） - /en/ 、 /zh/ 为独立可索引页面 - 新增多入口构建配置与页面入口： - apps/landing/vite.config.ts - apps/landing/en/index.html - apps/landing/zh/index.html - 语言切换改为路由跳转（ /en/ /zh/ ），并保留语言持久化。 - 每个语言页面独立维护 SEO 元信息： - title 、 description 、 canonical - hreflang - og: 、 twitter: - application/ld+json - 补齐站点索引与 AI 入口信息： - apps/landing/public/sitemap.xml 增加 / 、 /en/ 、 /zh/ 与 hreflang - apps/landing/public/llm.txt 增加中英文 landing/docs 入口 证据：`docs/logs/2026-02-26-landing-i18n/v0.0.1-landing-i18n/README.md`
- **2026-02-26 v0.0.1-landing-seo-optimization**（documentation）：2026-02-26 v0.0.1-landing-seo-optimization 证据：`docs/logs/2026-02-26-landing-seo-optimization/v0.0.1-landing-seo-optimization/README.md`
- **2026-02-26 v0.0.1-marketplace-skill-plugin-separation**（documentation）：2026-02-26 v0.0.1-marketplace-skill-plugin-separation 证据：`docs/logs/2026-02-26-marketplace-skill-plugin-separation/v0.0.1-marketplace-skill-plugin-separation/README.md`
- **2026-02-26 v0.8.20-remove-docs-guides-ambiguity**（documentation）：2026-02-26 v0.8.20-remove-docs-guides-ambiguity 证据：`docs/logs/2026-02-26-remove-docs-guides-ambiguity/v0.8.20-remove-docs-guides-ambiguity/README.md`
- **2026-02-26 v0.0.1-ui-lazy-chunking**（documentation）：- UI 路由改为懒加载： /model 、 /providers 、 /channels 、 /runtime 、 /sessions 、 /cron 、 /marketplace 全部通过 React.lazy + Suspense 按路由加载。 - 保持现有路由结构不变，仅调整加载策略，避免一次性下载全部页面逻辑。 - Vite 构建启用 splitVendorChunkPlugin ，将 vendor 代码与入口代码拆分，降低首屏入口包体积。 - UI 服务端开启 gzip 压缩（ packages/nextclaw-server/src/ui/server.ts ），减少弱网下静态资源传输体积与耗时。 - 关键文件： - packages/nextclaw-ui/src/App.tsx - packages/nextclaw-ui/vite.config.ts - packages/nextclaw-ui/src/components/layout/AppLayout.tsx - packages/nextclaw-server/src/ui/server.ts 证据：`docs/logs/2026-02-26-ui-lazy-chunking/v0.0.1-ui-lazy-chunking/README.md`
- **2026-02-26 v0.0.1-ui-theme-switcher**（documentation）：2026-02-26 v0.0.1-ui-theme-switcher 证据：`docs/logs/2026-02-26-ui-theme-switcher/v0.0.1-ui-theme-switcher/README.md`
- **2026-02-27 v0.0.1-backend-marketplace-hard-decouple**（documentation）：2026-02-27 v0.0.1-backend-marketplace-hard-decouple 证据：`docs/logs/2026-02-27-backend-marketplace-hard-decouple/v0.0.1-backend-marketplace-hard-decouple/README.md`
- **2026-02-27 v0.0.1-doc-browser-locale-sync**（documentation）：2026-02-27 v0.0.1-doc-browser-locale-sync 证据：`docs/logs/2026-02-27-doc-browser-locale-sync/v0.0.1-doc-browser-locale-sync/README.md`
- **v0.0.1-marketplace-anthropic-doc-skills**（documentation）：v0.0.1-marketplace-anthropic-doc-skills 证据：`docs/logs/2026-02-27-marketplace-anthropic-doc-skills/v0.0.1-marketplace-anthropic-doc-skills/README.md`
- **2026-02-27 v0.0.1-marketplace-bird-name-fix**（documentation）：2026-02-27 v0.0.1-marketplace-bird-name-fix 证据：`docs/logs/2026-02-27-marketplace-bird-name-fix/v0.0.1-marketplace-bird-name-fix/README.md`
- **2026-02-27 v0.0.1-marketplace-bird-slug-fix**（documentation）：2026-02-27 v0.0.1-marketplace-bird-slug-fix 证据：`docs/logs/2026-02-27-marketplace-bird-slug-fix/v0.0.1-marketplace-bird-slug-fix/README.md`
- **2026-02-27 v0.0.1-marketplace-bird-su-skill**（documentation）：2026-02-27 v0.0.1-marketplace-bird-su-skill 证据：`docs/logs/2026-02-27-marketplace-bird-su-skill/v0.0.1-marketplace-bird-su-skill/README.md`
- **2026-02-27 v0.0.1-marketplace-cloudflare-deploy-skill**（documentation）：2026-02-27 v0.0.1-marketplace-cloudflare-deploy-skill 证据：`docs/logs/2026-02-27-marketplace-cloudflare-deploy-skill/v0.0.1-marketplace-cloudflare-deploy-skill/README.md`
- **2026-02-27 v0.0.1-marketplace-copy-alignment**（documentation）：2026-02-27 v0.0.1-marketplace-copy-alignment 证据：`docs/logs/2026-02-27-marketplace-copy-alignment/v0.0.1-marketplace-copy-alignment/README.md`
- **2026-02-27 v0.0.1-marketplace-dual-catalog-files**（documentation）：2026-02-27 v0.0.1-marketplace-dual-catalog-files 证据：`docs/logs/2026-02-27-marketplace-data-file-split/v0.0.1-marketplace-dual-catalog-files/README.md`
- **2026-02-27 v0.0.1-marketplace-data-split**（documentation）：2026-02-27 v0.0.1-marketplace-data-split 证据：`docs/logs/2026-02-27-marketplace-data-split/v0.0.1-marketplace-data-split/README.md`
- **2026-02-27 v0.0.1-marketplace-full-layer-split**（documentation）：2026-02-27 v0.0.1-marketplace-full-layer-split 证据：`docs/logs/2026-02-27-marketplace-full-layer-split/v0.0.1-marketplace-full-layer-split/README.md`
- **v0.0.1-marketplace-git-skild-install**（documentation）：v0.0.1-marketplace-git-skild-install 证据：`docs/logs/2026-02-27-marketplace-git-skild-install/v0.0.1-marketplace-git-skild-install/README.md`
- **2026-02-27 v0.0.1-marketplace-install-nonblocking**（documentation）：2026-02-27 v0.0.1-marketplace-install-nonblocking 证据：`docs/logs/2026-02-27-marketplace-install-nonblocking/v0.0.1-marketplace-install-nonblocking/README.md`
- **2026-02-27 v0.0.1-marketplace-no-cross-type-switch**（documentation）：2026-02-27 v0.0.1-marketplace-no-cross-type-switch 证据：`docs/logs/2026-02-27-marketplace-no-cross-type-switch/v0.0.1-marketplace-no-cross-type-switch/README.md`
- **2026-02-27 v0.0.1-marketplace-workflow-install-fix**（documentation）：2026-02-27 v0.0.1-marketplace-workflow-install-fix 证据：`docs/logs/2026-02-27-marketplace-workflow-install-fix/v0.0.1-marketplace-workflow-install-fix/README.md`
- **2026-02-27 v0.0.1-max-tool-iterations-default-1000**（documentation）：2026-02-27 v0.0.1-max-tool-iterations-default-1000 证据：`docs/logs/2026-02-27-max-tool-iterations-default-1000/v0.0.1-max-tool-iterations-default-1000/README.md`
- **2026-02-27 v0.0.1-nextclaw-skill-resource-hub**（documentation）：2026-02-27 v0.0.1-nextclaw-skill-resource-hub 证据：`docs/logs/2026-02-27-nextclaw-skill-resource-hub/v0.0.1-nextclaw-skill-resource-hub/README.md`
- **2026-02-27 v0.0.1-nextclaw-skill-resource-openai**（documentation）：2026-02-27 v0.0.1-nextclaw-skill-resource-openai 证据：`docs/logs/2026-02-27-nextclaw-skill-resource-openai/v0.0.1-nextclaw-skill-resource-openai/README.md`
- **v0.8.29-skill-reinstall-json-fix**（documentation）：迭代完成说明 - 修复 UI 中 skill 在“安装 - 卸载 - 再安装”场景下报错： failed to parse skild --json output 。 - 根因处理： - skild --json 在已有本地安装状态下可能返回 null ，原实现仅接受对象，导致解析报错。 - 卸载流程此前只删除 workspace/skills/ ，未清理 workspace/.agents/skills/ ，造成 skild 误判已安装。 - 具体改动： - installGitMarketplaceSkill 增加 null 自愈逻辑：首次返回 null 时自动追加 --force 重试。 - uninstallMarketplaceSkill 同步清理 workspace/skills/ 与 workspace/.agents/skills/ 。 - parseSkildJsonOutput 支持 null 与数组格式（数组时提取首个对象）。 证据：`docs/logs/2026-02-27-skill-reinstall-fix/v0.8.29-skill-reinstall-json-fix/README.md`
- **2026-02-27 v0.0.1-slogan-cross-doc-alignment**（documentation）：2026-02-27 v0.0.1-slogan-cross-doc-alignment 证据：`docs/logs/2026-02-27-slogan-cross-doc-alignment/v0.0.1-slogan-cross-doc-alignment/README.md`
- **v0.0.1-chat-delete-session-button-alignment**（documentation）：v0.0.1-chat-delete-session-button-alignment 证据：`docs/logs/2026-02-28-chat-delete-session-button-alignment/v0.0.1-chat-delete-session-button-alignment/README.md`
- **v0.8.40-chat-event-seq-render**（documentation）：- Chat 会话存储改为 单写事件日志 （append-only event jsonl），不再以 message 行作为持久化主格式。 - SessionManager 新增事件模型（ seq/type/timestamp/data ）并保持 session.messages 投影兼容，支持从历史 message jsonl 自动投影迁移。 - Agent/UI 流式链路打通 session event ： - runtime 在写入 user / assistant tool call / tool result / assistant final 时同步推送事件。 - /api/chat/turn/stream 新增 event: session event SSE 帧。 - Chat 前端渲染从“消息后处理合并”切换为“事件时间线渲染”： - 按 seq 保序渲染。 - 工具调用结果按 callId 依附到调用卡片。 - 工具结果后的紧随 assistant 文本/思考并入同一 assistant flow 卡片。 - 保留真实文本流式（ delta ），并与 session event 并行工作。 证据：`docs/logs/2026-02-28-chat-event-seq-render/v0.8.40-chat-event-seq-render/README.md`
- **v0.8.38-chat-queue-channel-filter**（documentation）：- Chat 发送交互对齐 openclaw： - AI 流式回复期间，输入框保持可编辑。 - 忙时点击发送不阻塞，消息进入前端队列顺序发送（Queue）。 - 工具消息展示增强： - 工具调用结果后紧跟的 assistant 解释文本，合并到同一消息卡片展示，减少“工具卡 + 解释卡”割裂感。 - Chat 会话列表新增渠道过滤： - 复用会话管理同源规则，从 sessionKey 解析渠道并支持 All + channel 过滤。 - Chat 顶部 header 布局优化： - 改为更紧凑的网格布局，减少在常见宽度下换成 3 行的问题。 证据：`docs/logs/2026-02-28-chat-queue-channel-filter/v0.8.38-chat-queue-channel-filter/README.md`
- **v0.8.36-chat-real-stream-sse**（documentation）：- 完成 UI 对话“真实流式”闭环（非前端模拟）： - Provider 层新增 chatStream 能力，OpenAI Chat Completions 使用 stream: true 实时产出 token/delta。 - Agent Loop 新增可选 onAssistantDelta 回调，将真实增量从模型层透传到上层。 - CLI runtime pool 与 UI chat runtime 打通流式回调链路。 - UI Server 新增 POST /api/chat/turn/stream （SSE），输出 ready/delta/final/error/done 事件。 - 前端 Chat 页面改为消费 SSE 真实流，不再使用任何“字符渐进模拟”。 - openclaw 对照结论： - openclaw 已有真实流式机制（通过网关事件 delta/final 驱动 UI），本次 nextclaw 在 UI API 侧采用 SSE 实现同等级真实流式。 证据：`docs/logs/2026-02-28-chat-real-stream-sse/v0.8.36-chat-real-stream-sse/README.md`
- **v0.8.41-chat-stream-stability-fix**（documentation）：- 修复 UI 新会话“消息被吞/回复空白”的根因： - nextclaw 流式转发逻辑此前在遇到首个非 delta 事件（常见是 session event ）时会提前结束生成器，导致后续终止事件被截断。 - 现改为仅在 final 或 error 时结束流， session event 将持续保序透传。 - 修复 Chat 页面历史加载与首条消息显示稳定性： - useSessionHistory 关闭重试，避免新建会话历史 404 时长时间 loading 覆盖实时流。 - 新增 optimistic user event，确保新会话发送后本地立即可见，不等待服务端回写。 - 修复流式收尾 UI 抖动： - 增加 isAwaitingAssistantOutput 状态，typing 指示器仅在“等待首个 assistant 输出”阶段显示。 - 消除“流结束瞬间闪一下 AI 正在回复”的视觉闪烁。 证据：`docs/logs/2026-02-28-chat-stream-stability-fix/v0.8.41-chat-stream-stability-fix/README.md`
- **v0.8.35-chat-tool-merge-streaming**（documentation）：- 系统性升级 Chat 工具渲染体验： - 新增消息预处理 combineToolCallAndResults ，按 tool call id 将工具调用与工具结果合并。 - 工具卡从“调用卡/结果卡分离”升级为“单卡展示调用 + 输出结果”。 - 对无法匹配到调用的 tool 消息保留兜底结果卡，避免信息丢失。 - 增强会话线程渲染： - 在分组前执行工具消息合并，减少冗余消息气泡，提升可读性。 - 增强低成本流式体验（前端渐进流式）： - 在 POST /api/chat/turn 返回后，对 reply 做字符渐进渲染预览。 - 渲染完成后自动回落到真实历史数据，保持数据一致性。 证据：`docs/logs/2026-02-28-chat-tool-merge-stream/v0.8.35-chat-tool-merge-streaming/README.md`
- **v0.8.33-chat-markdown-tool-grouping**（documentation）：v0.8.33-chat-markdown-tool-grouping 证据：`docs/logs/2026-02-28-chat-ux-upgrade/v0.8.33-chat-markdown-tool-grouping/README.md`
- **2026-02-28 Claw 竞品下载与双报告交付（v0.0.1）**（documentation）：- 已将竞品仓库下载到临时目录（按你的要求， openclaw 不重复下载）： - /tmp/nextclaw-competitors-20260228/nanobot - /tmp/nextclaw-competitors-20260228/nanoclaw - /tmp/nextclaw-competitors-20260228/zeroclaw - /tmp/nextclaw-competitors-20260228/picoclaw - 已基于本地源码快照产出两份报告： - report-01-claw-landscape-comparison.md ：综合性生态对比（包含 nextclaw） - report-02-nextclaw-advantages-horizontal.md ：nextclaw 全优势 + 维度横向对比 - 报告均注明了对比对象、commit 基线与证据来源路径。 证据：`docs/logs/2026-02-28-claw-competition-analysis/v0.0.1-claw-competition-analysis/README.md`
- **v0.8.46-deepseek-default-base-no-v1**（documentation）：v0.8.46-deepseek-default-base-no-v1 证据：`docs/logs/2026-02-28-deepseek-default-base-fix/v0.8.46-deepseek-default-base-no-v1/README.md`
- **v0.8.49-non-gateway-default-api-base**（documentation）：v0.8.49-non-gateway-default-api-base 证据：`docs/logs/2026-02-28-deepseek-routing-fix/v0.8.49-non-gateway-default-api-base/README.md`
- **v0.0.1-installer-release-assets**（documentation）：- 调整安装器工作流 .github/workflows/installer-build.yml ： - 触发条件增加 push tags v ，推送版本 tag 时可自动创建/更新 Release 并上传安装器。 - 触发条件改为 release.published （发布 Release 后自动运行）。 - workflow dispatch 新增 release tag 输入，支持对已存在 Release 手动补传安装器。 - 安装器构建改为直接使用 nextclaw@ （npm registry）作为输入，不再依赖仓库内 pnpm install + pnpm build ，降低 CI 失败面并显著缩短时长。 - 构建与发布拆分为两阶段：矩阵 job 只产出 artifacts， publish-release-assets 单 job 汇总并上传到 Release，避免并发上传冲突。 - Windows 构建步骤改为 pwsh 执行，避免 bash 环境下工具链路径兼容问题。 - Windows 构建命令参数统一显式字符串化，避免 @ 字符在 PowerShell 下的解析歧义。 - Windows 包规格改为环境变量 NEXTCLAW INSTALLER PACKAGE SPEC 传递，进一步规避 PowerShell 参数解析差异。 - 调整安装器脚本 scripts/installer/build-installer.mjs ： - Windows 默认临时工作目录改为用户可写短路径（ %USERPROFILE%\nci- ），降低长路径与权限导致的依赖安装失… 证据：`docs/logs/2026-02-28-installer-release-assets/v0.0.1-installer-release-assets/README.md`
- **v0.0.1-installer-windows-ci-fix**（documentation）：- 修复并加固 Windows 安装器构建链路： - scripts/installer/build-installer.mjs 新增 makensis 定位兜底逻辑，按顺序尝试 PATH 、 C:\\Program Files x86 \\NSIS\\makensis.exe 、 C:\\Program Files\\NSIS\\makensis.exe 以及 Chocolatey 常见目录。 - 找不到 makensis 时抛出明确错误并打印当前 PATH ，避免“静默失败”。 - NSIS 参数 APP NAME 改为无空格值（ NextClaw-Beta ），避免 Windows 下参数分词差异导致编译失败。 - 对 --package-spec=nextclaw@x.y.z 的版本读取改为优先本地解析，并优先从 npm registry tarball URL 直接下载包，绕开 Windows runner 上 npm view / npm pack 的非确定性失败。 - Windows 默认临时目录前缀从 nci- 改为 zci- ，规避路径中 \\n 片段对 npm 命令参数解析的潜在干扰。 - 命令失败日志增强：安装依赖失败时同时输出 stdout/stderr，保证 CI 能直接看到 npm 错误根因而不是只有 exit code。 - 当 npm install 失败时，自动附带 npm cache 的最新 debug log 末尾内容，进一步提升可诊断性。 - npm debug log 路径探测兼容 NPM CONFIG CACHE / LOCALAP… 证据：`docs/logs/2026-02-28-installer-windows-ci-fix/v0.0.1-installer-windows-ci-fix/README.md`
- **v0.0.1-lightweight-installers**（documentation）：- 新增统一安装器构建脚本 scripts/installer/build-installer.mjs ： - 支持 darwin/win32 + x64/arm64 四种目标。 - 自动下载 Node Runtime（默认 22.20.0 ）。 - 打包本地 nextclaw 产物，安装依赖后删除 sourcemap 以减小包体。 - 自动写入启动器： - macOS： Start NextClaw.command + nextclaw - Windows： Start NextClaw.cmd + nextclaw.cmd - 自动输出安装器与构建清单（manifest JSON）。 - 安装器文件名统一增加 -beta- 标识，明确当前为 Beta 分发。 - 新增 Windows NSIS 模板 scripts/installer/windows-installer.nsi ： - 用户态安装到 $LOCALAPPDATA\Programs\NextClaw 。 - 自动创建桌面与开始菜单快捷方式。 - 生成卸载入口并注册到 Windows 卸载列表。 - 新增 CI 工作流 .github/workflows/installer-build.yml ： - 并行构建四类安装器（mac arm64/x64 + win x64/arm64）。 - 构建后上传安装器与 manifest 为 artifacts。 - 更新安装文档： - README.md / README.zh-CN.md 增加“桌面安装包”入口。 - docs/USAGE.md Quick Start… 证据：`docs/logs/2026-02-28-lightweight-installers/v0.0.1-lightweight-installers/README.md`
- 其余 116 条证据见 `AI_CONTEXT_PACK.json` 或 `EVIDENCE_INDEX.json`。

## 宿主 AI 必须遵守的规则

- **把本资产当作开工前上下文，而不是运行环境。**：AI Context Pack 只包含证据化项目理解，不包含目标项目的可执行状态。 证据：`.agents/skills/project-os/assets/docs/logs/README.md`, `docs/logs/2026-02-23-config-watch-fix/v0.8.7-config-watch-scope/README.md`, `docs/logs/2026-02-23-cron-ui/v0.8.14-cron-ui/README.md`
- **回答用户时区分可预览内容与必须安装后才能验证的内容。**：安装前体验的消费者价值来自降低误装和误判，而不是伪装成真实运行。 证据：`.agents/skills/project-os/assets/docs/logs/README.md`, `docs/logs/2026-02-23-config-watch-fix/v0.8.7-config-watch-scope/README.md`, `docs/logs/2026-02-23-cron-ui/v0.8.14-cron-ui/README.md`

## 用户开工前应该回答的问题

- 你准备在哪个宿主 AI 或本地环境中使用它？
- 你只是想先体验工作流，还是准备真实安装？
- 你最在意的是安装成本、输出质量、还是和现有规则的冲突？

## 验收标准

- 所有能力声明都能回指到 evidence_refs 中的文件路径。
- AI_CONTEXT_PACK.md 没有把预览包装成真实运行。
- 用户能在 3 分钟内看懂适合谁、能做什么、如何开始和风险边界。

---

## Doramagic Context Augmentation

下面内容用于强化 Repomix/AI Context Pack 主体。Human Manual 只提供阅读骨架；踩坑日志会被转成宿主 AI 必须遵守的工作约束。

## Human Manual 骨架

使用规则：这里只是项目阅读路线和显著性信号，不是事实权威。具体事实仍必须回到 repo evidence / Claim Graph。

宿主 AI 硬性规则：
- 不得把页标题、章节顺序、摘要或 importance 当作项目事实证据。
- 解释 Human Manual 骨架时，必须明确说它只是阅读路线/显著性信号。
- 能力、安装、兼容性、运行状态和风险判断必须引用 repo evidence、source path 或 Claim Graph。

- **项目概览**：importance `high`
  - source_paths: README.md, apps/companion/package.json, apps/competitive-leaderboard/package.json, apps/desktop/README.md, apps/desktop/package.json
- **Lib 模块**：importance `high`
  - source_paths: packages/nextclaw-core/src/shared/lib/core-utils/features/openai/index.ts, packages/nextclaw-core/src/shared/lib/core-utils/features/openai/utils/response.utils.ts, packages/nextclaw-core/src/shared/lib/core-utils/features/openai/utils/responses-payload.utils.ts, packages/nextclaw-core/src/shared/lib/core-utils/features/openai/utils/responses-stream-state.utils.ts, packages/nextclaw-core/src/shared/lib/core-utils/features/openai/utils/responses-stream.utils.ts
- **Lib 模块**：importance `high`
  - source_paths: apps/landing/src/shared/lib/desktop-release/desktop-release.utils.ts, apps/landing/src/shared/lib/desktop-release/index.ts, apps/landing/src/shared/lib/landing-content/index.ts, apps/landing/src/shared/lib/landing-content/landing-comparison-content.config.ts, apps/landing/src/shared/lib/landing-content/landing-content.types.ts
- **Lib 模块**：importance `high`
  - source_paths: packages/nextclaw-agent-chat-ui/src/lib/input-surface/index.ts, packages/nextclaw-agent-chat-ui/src/lib/input-surface/input-surface-plugin.utils.ts, packages/nextclaw-agent-chat-ui/src/lib/input-surface/input-surface.types.ts
- **Lib 模块**：importance `medium`
  - source_paths: apps/competitive-leaderboard/src/lib/leaderboard-format.utils.ts
- **Lib 模块**：importance `medium`
  - source_paths: apps/maintainability-console/src/lib/maintainability-format.utils.ts
- **Lib 模块**：importance `medium`
  - source_paths: apps/platform-admin/src/lib/utils.ts

## Repo Inspection Evidence / 源码检查证据

- repo_clone_verified: true
- repo_inspection_verified: true
- repo_commit: `d9e24d2009fa44c8174d9a5813c39998e78a1fd0`
- inspected_files: `README.md`, `package.json`, `pnpm-lock.yaml`, `docs/ARCHITECTURE.md`, `docs/ROADMAP.md`, `docs/TODO.md`, `docs/USAGE.md`, `docs/VISION.md`, `docs/designs/2026-02-12-ui-frontend-handoff.md`, `docs/designs/2026-02-12-ui-gateway-api.md`, `docs/designs/2026-02-12-ui-gateway.md`, `docs/designs/2026-02-18-plugins-true-hotplug-lifecycle.plan.md`, `docs/designs/2026-02-19-nextclaw-openclaw-channel-plugin-align.plan.md`, `docs/designs/2026-02-21-openclaw-alignment-gap-report.md`, `docs/designs/2026-02-23-hot-plugin-runtime-v1-checklist.md`, `docs/designs/2026-03-09-codex-integration-protocol-plan.md`, `docs/designs/2026-03-10-chat-runtime-agent-align.md`, `docs/designs/2026-03-11-ncp-universal-endpoint-implementation.plan.md`, `docs/designs/2026-03-11-universal-communication-protocol-brainstorm.md`, `docs/designs/2026-03-15-ncp-agent-app-building-block-principles.md`

宿主 AI 硬性规则：
- 没有 repo_clone_verified=true 时，不得声称已经读过源码。
- 没有 repo_inspection_verified=true 时，不得把 README/docs/package 文件判断写成事实。
- 没有 quick_start_verified=true 时，不得声称 Quick Start 已跑通。

## Doramagic Pitfall Constraints / 踩坑约束

这些规则来自 Doramagic 发现、验证或编译过程中的项目专属坑点。宿主 AI 必须把它们当作工作约束，而不是普通说明文字。

### Constraint 1: 来源证据：Telegram 开启时，若 `providers.groq` 缺失，`nextclaw start` 会在启动阶段崩溃

- Trigger: GitHub 社区证据显示该项目存在一个安装相关的待验证问题：Telegram 开启时，若 `providers.groq` 缺失，`nextclaw start` 会在启动阶段崩溃
- Host AI rule: 来源显示可能已有修复、规避或版本变化，说明书中必须标注适用版本。
- Why it matters: 可能影响升级、迁移或版本选择。
- Evidence: community_evidence:github | https://github.com/Peiiii/nextclaw/issues/4 | 来源讨论提到 node 相关条件，需在安装/试用前复核。
- Hard boundary: 不要把这个坑点包装成已解决、已验证或可忽略，除非后续验证证据明确证明它已经关闭。

### Constraint 2: 可能修改宿主 AI 配置

- Trigger: 项目面向 Claude/Cursor/Codex/Gemini/OpenCode 等宿主，或安装命令涉及用户配置目录。
- Host AI rule: 列出会写入的配置文件、目录和卸载/回滚步骤。
- Why it matters: 安装可能改变本机 AI 工具行为，用户需要知道写入位置和回滚方法。
- Evidence: capability.host_targets | https://github.com/Peiiii/nextclaw | host_targets=claude_code, claude
- Hard boundary: 不要把这个坑点包装成已解决、已验证或可忽略，除非后续验证证据明确证明它已经关闭。

### Constraint 3: 能力判断依赖假设

- Trigger: README/documentation is current enough for a first validation pass.
- Host AI rule: 将假设转成下游验证清单。
- Why it matters: 假设不成立时，用户拿不到承诺的能力。
- Evidence: capability.assumptions | https://github.com/Peiiii/nextclaw | README/documentation is current enough for a first validation pass.
- Hard boundary: 不要把这个坑点包装成已解决、已验证或可忽略，除非后续验证证据明确证明它已经关闭。

### Constraint 4: 维护活跃度未知

- Trigger: 未记录 last_activity_observed。
- Host AI rule: 补 GitHub 最近 commit、release、issue/PR 响应信号。
- Why it matters: 新项目、停更项目和活跃项目会被混在一起，推荐信任度下降。
- Evidence: evidence.maintainer_signals | https://github.com/Peiiii/nextclaw | last_activity_observed missing
- Hard boundary: 不要把这个坑点包装成已解决、已验证或可忽略，除非后续验证证据明确证明它已经关闭。

- Trigger: no_demo
- Evidence: downstream_validation.risk_items | https://github.com/Peiiii/nextclaw | no_demo; severity=medium
- Hard boundary: 不要把这个坑点包装成已解决、已验证或可忽略，除非后续验证证据明确证明它已经关闭。

### Constraint 6: 存在安全注意事项

- Trigger: No sandbox install has been executed yet; downstream must verify before user use.
- Host AI rule: 转成明确权限清单和安全审查提示。
- Why it matters: 用户安装前需要知道权限边界和敏感操作。
- Evidence: risks.safety_notes | https://github.com/Peiiii/nextclaw | No sandbox install has been executed yet; downstream must verify before user use.
- Hard boundary: 不要把这个坑点包装成已解决、已验证或可忽略，除非后续验证证据明确证明它已经关闭。

### Constraint 7: 存在评分风险

- Trigger: no_demo
- Why it matters: 风险会影响是否适合普通用户安装。
- Evidence: risks.scoring_risks | https://github.com/Peiiii/nextclaw | no_demo; severity=medium
- Hard boundary: 不要把这个坑点包装成已解决、已验证或可忽略，除非后续验证证据明确证明它已经关闭。

### Constraint 8: 来源证据：[Bug] Marked as degraded after start

- Trigger: GitHub 社区证据显示该项目存在一个安全/权限相关的待验证问题：[Bug] Marked as degraded after start
- Host AI rule: 来源显示可能已有修复、规避或版本变化，说明书中必须标注适用版本。
- Why it matters: 可能影响授权、密钥配置或安全边界。
- Evidence: community_evidence:github | https://github.com/Peiiii/nextclaw/issues/6 | 来源讨论提到 node 相关条件，需在安装/试用前复核。
- Hard boundary: 不要把这个坑点包装成已解决、已验证或可忽略，除非后续验证证据明确证明它已经关闭。

### Constraint 9: issue/PR 响应质量未知

- Trigger: issue_or_pr_quality=unknown。
- Host AI rule: 抽样最近 issue/PR，判断是否长期无人处理。
- Why it matters: 用户无法判断遇到问题后是否有人维护。
- Evidence: evidence.maintainer_signals | https://github.com/Peiiii/nextclaw | issue_or_pr_quality=unknown
- Hard boundary: 不要把这个坑点包装成已解决、已验证或可忽略，除非后续验证证据明确证明它已经关闭。

### Constraint 10: 发布节奏不明确

- Trigger: release_recency=unknown。
- Host AI rule: 确认最近 release/tag 和 README 安装命令是否一致。
- Why it matters: 安装命令和文档可能落后于代码，用户踩坑概率升高。
- Evidence: evidence.maintainer_signals | https://github.com/Peiiii/nextclaw | release_recency=unknown
- Hard boundary: 不要把这个坑点包装成已解决、已验证或可忽略，除非后续验证证据明确证明它已经关闭。