peiiii / nextclaw-development-routes

NextClaw 开发阶段专项路由

共享 development-* Skill 负责阶段与通用方法。本文件只拥有 NextClaw 产品、环境和发布的条件路由；每次只读取当前阶段命中的条目，不一次加载所有链接。项目授权和高层硬约束仍以根 AGENTS.md 为准。

Lifecycle 与任务理解

• 意图宏命中时按 commands/commands.md 的对应条目展开；解释或引用不执行。
• 完整开发或授权发布默认读取[任务遥测方法](../development-task-telemetry/SKILL.md)；限定单阶段任务仅在需要阶段追踪、Token/耗时、模型对比或本地 dashboard 时读取。
• 切入 worktree、迁移草稿或主线并发时，读取[Worktree 合同](../../../../skills/development-lifecycle/references/parallel-worktree-development.md)。
• 大型交付启动即按[迭代日志治理](../../governance/nextclaw-iteration-log-governance/SKILL.md)建立持续记录，日期前缀优先、兼容版本号。新建恢复入口为 docs/work/YYYY-MM-DD-<slug>/current-state.md；已有迭代内笔记沿用，避免双份当前状态。普通跨轮笔记不强制建日志。
• 用户明确要求扫描、识别或清理死代码时，读取[NextClaw 死代码治理](../../operations/nextclaw-dead-code-governance/SKILL.md)。
• 长链路复现固定隔离的 NEXTCLAW_HOME、session、project root、provider/model/runtime 和 skill 集；按流式事件顺序、server/persisted/rendered truth、配置加载/保存快照及 skill 可用/实际选择定位第一个违约边界。
• Loop 设计归 docs/loops，执行批次、状态和证据归 docs/logs，按[迭代日志治理](../../governance/nextclaw-iteration-log-governance/SKILL.md)记录；设计与运行状态分离。

Design

• NextClaw kernel/runtime host/manager/store/presenter 主干依赖：读取[Kernel Owner 架构](../../../../skills/development-design/references/nextclaw-kernel-owner-architecture.md)。
• 前端状态和 view logic：读取[View Logic 解耦](../../frontend/mvp-view-logic-decoupling/SKILL.md)。
• 目录、角色、命名：读取[文件组织治理](../../governance/file-organization-governance/SKILL.md)。
• fallback、兼容、恢复：读取[可预测行为优先](../../architecture/predictable-behavior-first/SKILL.md)。
• 前端系统性重构、控件交互、参考皮肤或页面级挑刺：分别选择[前端代码优化](../../frontend/frontend-code-optimization/SKILL.md)、[交互质量](../../frontend/frontend-interaction-quality/SKILL.md)、[参考皮肤复刻](../../frontend/replicating-reference-skins/SKILL.md)或[UI 设计挑刺](../../frontend/ui-design-critique/SKILL.md)中的一个。挑刺侧重删减、信息层级和空间效率；控件行为仍归交互质量。
• Hermes HTTP 或 NARP stdio runtime 接入：分别读取[HTTP runtime 接入](../../architecture/nextclaw-http-agent-runtime-integration/SKILL.md)或[NARP stdio 接入](../../architecture/nextclaw-narp-stdio-runtime-integration/SKILL.md)。
• 用户可见内容边界：读取[用户内容边界](../../content/user-facing-content-boundary/SKILL.md)。
• Marketplace skill 的评估与集成设计：读取[Marketplace skill 集成](../../operations/nextclaw-marketplace-skill-integration/SKILL.md)的 design 分支。

Implementation

• 样式封装读取[前端样式封装](../../frontend/frontend-style-encapsulation/SKILL.md)；动态组件、列表 key、streaming UI 或需保持实例状态的界面读取[React 渲染生命周期安全](../../frontend/react-rendering-lifecycle-safety/SKILL.md)。
• 只有 node/pnpm/npx/corepack 无法从 PATH 解析，或实际 Node 与仓库 .nvmrc 不一致时，才读取[Node/pnpm 环境恢复](../../../../skills/development-implementation/references/node-pnpm-environment.md)。

Validation

• 触达用户可见界面时按[交互质量合同](../../frontend/frontend-interaction-quality/SKILL.md)分级选渲染证据；纯逻辑及不影响呈现的文案免审。
• 用户已在真实实例复现，或任务触达冷/热启动、重复状态转换、journal/projection/hydrate、accepted run handle 或启动恢复时，读取[真实运行实例验证](../../../../skills/development-validation/references/runtime-instance-validation.md)。
• 需要隔离全局安装版验证时，按 diff 过构建资格门并读取[本地源码运行验证](../../../../skills/development-validation/references/local-source-runtime.md)；纯前端不得触发未变化的 Runtime/Cargo/CLI 构建。
• 验证 packages/extensions/* 未发布源码时读取[本地 Extension 源码验证](../../../../skills/development-validation/references/local-extension-source.md)。
• 触达 Desktop 内嵌 Runtime 的文件集合、native resources、bundle 复制规则或产物预算时，开发收尾先在当前平台运行一次 pnpm -C apps/desktop bundle:build -- --channel stable，通过后才运行远端多平台 Desktop 验证。
• 对指定 session/model 执行真实 NCP chat 时读取[NCP Chat 冒烟](../../../../skills/development-validation/references/ncp-chat-smoke.md)。
• L4 发布与不可逆变更读取[发布验证](../../../../skills/development-validation/references/release-validation.md)；runtime update 再读取[Runtime Update 验证](../../../../skills/development-validation/references/runtime-update-validation.md)。
• 新增/移动/重命名文件、改变 owner/目录/跨包依赖、触达治理敏感规则或提交前才运行 lint:new-code:governance；治理规则、baseline、相关脚本变化或提交/发布闭环才运行 check:governance-backlog-ratchet。

Review

源码、脚本、测试或运行链路配置改动先运行一次 node .agents/skills/development-review/scripts/check-maintainability.mjs；范围明确时用 --paths <touched-files...>。--non-feature 只用于明确要求非测试净增 <= 0 的治理/减债任务，不是普通 bugfix、refactor 或 cleanup 的默认选项。脚本结果与人工 Review 分开报告。

Delivery

每个决策只进入当前需要的一个 owner：

• 提交范围、changeset、版本笔记和用户可见更新摘要：[Release Notes 方法](../../operations/nextclaw-release-notes/SKILL.md)。
• 重要交付、跨模块长链路、红区和发布留痕：[迭代记录治理](../../governance/nextclaw-iteration-log-governance/SKILL.md)。
• 有独立用户任务、可核查证据和公开叙事价值的产品成果：nextclaw-product-blog-storytelling。
• NextClaw NPM package、runtime channel、真实安装和分支闭环：[NPM 发布方法](../../operations/nextclaw-npm-release/SKILL.md)。
• NextClaw Desktop installer、DMG、update manifest、发布和恢复：[Desktop 发布方法](../../operations/nextclaw-desktop-release/SKILL.md)。
• Marketplace skill 发布：[Marketplace skill 集成](../../operations/nextclaw-marketplace-skill-integration/SKILL.md)的 publishing 分支。

项目发布语义、内容候选、人工介入计数和 Git 主线闭合只在实际交付或发布时读取[NextClaw 交付合同](references/delivery.md)。

Retrospective

• 流程、方法、宏、AGENTS 或模型补丁改进由 nextclaw-agent-instructions-governance 读取[规则资产生命周期](../../../../skills/nextclaw-agent-instructions-governance/references/rule-asset-lifecycle.md)；共享受管文件的改进回到独立仓库，再同步到本项目。
• 有独立交付意义的重要批次留痕读取[迭代记录治理](../../governance/nextclaw-iteration-log-governance/SKILL.md)。