NextClaw 开发阶段专项路由
共享 development-* Skill 负责阶段与通用方法。本文件只拥有 NextClaw 产品、环境和发布的条件路由;每次只读取当前阶段命中的条目,不一次加载所有链接。项目授权和高层硬约束仍以根 AGENTS.md 为准。
Lifecycle 与任务理解
- 意图宏命中时按
commands/commands.md的对应条目展开;解释或引用不执行。 - 完整开发或授权发布默认读取任务遥测方法;限定单阶段任务仅在需要阶段追踪、Token/耗时、模型对比或本地 dashboard 时读取。
- 切入 worktree、迁移草稿或主线并发时,读取Worktree 合同。
- 大型交付启动即按迭代日志治理建立持续记录,日期前缀优先、兼容版本号。新建恢复入口为
docs/work/YYYY-MM-DD-<slug>/current-state.md;已有迭代内笔记沿用,避免双份当前状态。普通跨轮笔记不强制建日志。 - 用户明确要求扫描、识别或清理死代码时,读取NextClaw 死代码治理。
- 长链路复现固定隔离的
NEXTCLAW_HOME、session、project root、provider/model/runtime 和 skill 集;按流式事件顺序、server/persisted/rendered truth、配置加载/保存快照及 skill 可用/实际选择定位第一个违约边界。 - Loop 设计归
docs/loops,执行批次、状态和证据归docs/logs,按迭代日志治理记录;设计与运行状态分离。
Design
- NextClaw kernel/runtime host/manager/store/presenter 主干依赖:读取Kernel Owner 架构。
- 前端状态和 view logic:读取View Logic 解耦。
- 目录、角色、命名:读取文件组织治理。
- fallback、兼容、恢复:读取可预测行为优先。
- 前端系统性重构、控件交互、参考皮肤或页面级挑刺:分别选择前端代码优化、交互质量、参考皮肤复刻或UI 设计挑刺中的一个。挑刺侧重删减、信息层级和空间效率;控件行为仍归交互质量。
- Hermes HTTP 或 NARP stdio runtime 接入:分别读取HTTP runtime 接入或NARP stdio 接入。
- 用户可见内容边界:读取用户内容边界。
- Marketplace skill 的评估与集成设计:读取Marketplace skill 集成的 design 分支。
Implementation
- 样式封装读取前端样式封装;动态组件、列表 key、streaming UI 或需保持实例状态的界面读取React 渲染生命周期安全。
- 只有
node/pnpm/npx/corepack无法从 PATH 解析,或实际 Node 与仓库.nvmrc不一致时,才读取Node/pnpm 环境恢复。
Validation
- 触达用户可见界面时按交互质量合同分级选渲染证据;纯逻辑及不影响呈现的文案免审。
- 用户已在真实实例复现,或任务触达冷/热启动、重复状态转换、journal/projection/hydrate、accepted run handle 或启动恢复时,读取真实运行实例验证。
- 需要隔离全局安装版验证时,按 diff 过构建资格门并读取本地源码运行验证;纯前端不得触发未变化的 Runtime/Cargo/CLI 构建。
- 验证
packages/extensions/*未发布源码时读取本地 Extension 源码验证。 - 触达 Desktop 内嵌 Runtime 的文件集合、native resources、bundle 复制规则或产物预算时,开发收尾先在当前平台运行一次
pnpm -C apps/desktop bundle:build -- --channel stable,通过后才运行远端多平台 Desktop 验证。 - 对指定 session/model 执行真实 NCP chat 时读取NCP Chat 冒烟。
- L4 发布与不可逆变更读取发布验证;runtime update 再读取Runtime Update 验证。
- 新增/移动/重命名文件、改变 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 方法。
- 重要交付、跨模块长链路、红区和发布留痕:迭代记录治理。
- 有独立用户任务、可核查证据和公开叙事价值的产品成果:
nextclaw-product-blog-storytelling。 - NextClaw NPM package、runtime channel、真实安装和分支闭环:NPM 发布方法。
- NextClaw Desktop installer、DMG、update manifest、发布和恢复:Desktop 发布方法。
- Marketplace skill 发布:Marketplace skill 集成的 publishing 分支。
项目发布语义、内容候选、人工介入计数和 Git 主线闭合只在实际交付或发布时读取NextClaw 交付合同。