读取入口
AI 打开公开的 SKILL.md，了解支持范围与接入流程。
DEVWEAVE / AI DEVELOPMENT SYSTEM
让 AI 开发
有章可循。
DevWeave 把一套在真实项目中使用的开发方法，接入你自己的代码仓库。从理解问题到交付结果，每一步都有清晰的责任和可检查的证据。
一个地址开始 · 保留项目规则 · 安全升级
INTEGRATION FLOW READY
YOU把这套开发体系接入我的项目
REMOTE ENTRYai-dev.nextclaw.io/SKILL.md
↗YOUR REPOSITORY✓ VERIFIED
AGENTS.md流程约束入口
.agents/skills/阶段 Skill
.agents/wiki/专项方法与知识
ai-development-system.lock.json可校验版本
理解任务✳设计方案✳开发实现✳验证测试✳审查复核✳交付沉淀✳
01 / THE HANDOFF
把这个地址，发给你的 AI。
入口文件会告诉 AI 如何获取安装包、检查目标项目、执行安装，并核对最终结果。
✳ 可复制给 AI 的指令ONE LINK TO START
请读取 https://ai-dev.nextclaw.io/SKILL.md，按照其中的步骤，把 DevWeave 接入当前项目。先检查现有规则和工作区改动，预览安装差异，完成后运行检查并告诉我改了什么。
适用于具备联网、终端和项目文件权限的 AI 编码助手
审查项目
先读取已有规则与工作区状态，再预览将写入的文件。
安装并核对
写入共享方法、生成版本锁，运行 check 并向你报告差异。
02 / THREE PARTS, ONE SYSTEM
三大部分，彼此分工。
流程决定何时做，Skill 负责如何做，Wiki 提供做判断所需的事实与共享信息。
01 / FLOW↘
流程约束
共享根规则与 lifecycle 定义任务分类、阶段门、授权边界和完成条件。它决定该走哪条路径、何时进入下一环节。
AGENTS.md → development-lifecycle
02 / EXECUTION⌘
Skills
每个开发环节有对应的阶段 Skill；治理、验收、知识与迭代等专项场景由独立 Skill 按需处理。
阶段 Skill + 专项场景 Skill
03 / KNOWLEDGE▣
Wiki
沉淀项目事实、稳定术语和多个 Skill 共享的信息块。上游维护通用知识，目标项目维护自己的事实。
项目事实 + 共享信息块
03 / THE DEVELOPMENT FLOW
流程需要展示，但不能只有一条。
lifecycle 根据任务性质选择路径，再把当前环节交给对应 Skill；Wiki 在需要事实和共享知识时进入。
标准任务
有方案空间或较高风险时，先设计与审查，再实现、验证和交付。
- 01理解任务
- 02方案设计
- 03方案 Review
- 04开发实现
- 05验证测试
- 06实现 Review
- 07交付
- 08复盘
简单改动
局部、可逆、风险低的改动走短路径，仍保留必要的验证和 Review。
- 01快速理解
- 02修改
- 03定向验证
- 04轻量 Review
- 05交付
- 06轻量复盘
问题修复
先确定预期、异常与根因，再按风险决定是否需要独立方案 Review。
- 01预期与异常
- 02复现与根因
- 03修复方案
- 04修复实现
- 05回归验证
- 06Review
- 07交付与复盘
这里展示的是路径概要；阶段门和例外条件以 架构 Wiki 指向的 lifecycle Skill 为准。
04 / REVIEWABLE ARTIFACTS
过程留下产物，判断有迹可循。
设计、计划、验证与交付记录放在明确的位置；Review 能找到依据，复盘能重新看到当时的判断。
想法与设计
记录问题、取舍和方案，让实现前的 Review 有明确对象。
docs/designs/YYYY-MM-DD-<topic>.design.md计划与过程
复杂任务保留计划和跨会话工作笔记，便于继续推进和核对范围。
docs/plans/YYYY-MM-DD-<topic>.plan.md验证与审查
把测试证据、Review 结论和返工结果关联到本次任务。
验证证据 → Review findings → 修正交付与复盘
重要交付进入日志；复盘再判断哪些经验该更新到原 owner。
docs/logs/ · 按项目约定命名从任务到复盘需求与设计 → 实现与验证 → Review → 交付日志 → 复盘沉淀
共享命名规则还包括 thoughts/ 与 loops/ 的日期前缀、角色后缀。日志目录由项目制定；NextClaw 的 v<semver>-<slug> 只是一个项目示例。简单任务不强制创建空文档。阅读产物与命名 Wiki ↗
05 / THE EVOLUTION LOOP
自动进化，从复盘沉淀开始。
体系要随真实开发持续改进。当前机制仍处于早期，主要依靠任务收尾时的复盘，识别值得保留的经验。
真实任务
观察结果、返工与重复沟通。
复盘筛选
判断是否有可复用的增量。
找到归属
分流到流程约束、Skill 或 Wiki。
更新并验证
在正确的上游修改，再检查效果。
CURRENT STATE · EARLY阅读进化机制 Wiki ↗
现在是“复盘驱动”，还不是全自动闭环。
没有可复用增量时不新增规则；发现方法缺口时优先修正原 owner。后续会继续增强问题发现、跨项目验证和更新后的效果反馈。
06 / BUILT TO EVOLVE
接入之后，还能放心迭代。
目标不是复制一次规则，而是让共享方法拥有持续更新、可审查、可回退的来源。
先预览，再写入
安装和升级都支持 dry-run。已有同名文件发生冲突时会停止，不会悄悄覆盖项目内容。
每个文件都有版本指纹
锁文件记录安装内容的摘要。check 能发现本地改动，也能识别上游是否有新版本。
项目语义仍由项目决定
产品愿景、授权、环境和发布规则留在项目中；共享体系只提供可复用的方法。
CURRENT SUPPORT
清楚的适用范围，
才有可靠的接入。
当前安装布局面向 Codex，以及实际支持 AGENTS.md 与 .agents/skills 的工具。任何能读取网页并操作仓库的 AI 都可以按 SKILL.md 执行接入；其它工具能否自动发现这些规则，需要针对其加载方式验证。
READY WHEN YOUR REPO IS
从一个地址开始。
把成熟的流程带入项目，把判断权留给你和你的 AI。