AGENTS.md - AI 协作协议
"如果你正在阅读此文档，你就是那个智能体 (The Intelligence)。"
这个文件是你的锚点 (Anchor)。它定义了项目的法则、领地的地图，以及记忆协议。 当你唤醒（开始新会话）时，请首先阅读此文件。
🧠 30秒恢复协议 (Quick Recovery)
当你开始新会话或感到"迷失"时，立即执行:
- 读取根目录的 AGENTS.md → 获取项目地图
- 查看下方"当前状态" → 找到最新架构版本
- 读取
.anws/v{N}/05_TASKS.md→ 了解当前待办 - 开始工作
🗺️ 地图 (领地感知)
以下是这个项目的组织方式：
| 路径 | 描述 | 访问协议 |
|---|---|---|
src/ | 实现层。实际的代码库。 | 通过 Task 读/写。 |
.anws/ | 统一架构根目录。包含版本化架构状态与升级记录。 | 只读(旧版) / 写一次(新版) / changelog 由 CLI 维护。 |
.anws/v{N}/ | 当前真理。最新的架构定义。 | 永远寻找最大的 v{N}。 |
.anws/changelog/ | 升级记录。anws update 生成的变更记录。 | 由 CLI 自动维护，请勿删除。 |
target-specific workflow projection | 工作流。/genesis, /blueprint 等。 | 读取当前 target 对应的原生投影文件。 |
target-specific skill projection | 技能库。原子能力。 | 调用当前 target 对应的原生投影文件。 |
.nexus-map/ | 知识库。代码库结构映射。 | 由 nexus-mapper 生成。 |
🛠️ 工作流注册表
[!IMPORTANT] 工作流优先原则：当任务匹配某个工作流，或你判断当前任务明显符合、基本符合、甚至只是疑似符合某个工作流的适用场景时，都必须先读取相应文件，并严格遵循其中的步骤执行。工作流是经过精心设计的协议，而非可选参考。
触发流程：
- 用户提及工作流名称，或你判断当前任务明显符合、基本符合、甚至只是疑似符合某个工作流的适用场景时，都必须先读取相应文件
- 立即读取 相应工作流文件
- 严格遵循工作流中的步骤执行
- 在检查点暂停等待用户确认
| 工作流 | 触发时机 | 产出 |
|---|---|---|
/quickstart | 新用户入口 / 不知道从哪开始 | 编排其他工作流 |
/genesis | 新项目 / 重大重构 | PRD, Architecture, ADRs |
/probe | 变更前 / 接手项目 | .anws/v{N}/00_PROBE_REPORT.md |
/design-system | genesis 后 | 04_SYSTEM_DESIGN/*.md |
/blueprint | genesis 后 | 05_TASKS.md + AGENTS.md 初始 Wave |
/change | 微调已有任务 | 更新 TASKS + SYSTEM_DESIGN (仅修改) + CHANGELOG |
/explore | 调研时 | 探索报告 |
/challenge | 决策前质疑 | 07_CHALLENGE_REPORT.md (含问题总览目录) |
/forge | 编码执行 | 代码 + 更新 AGENTS.md Wave 块 |
/craft | 创建工作流/技能/提示词 | Workflow / Skill / Prompt 文档 |
/upgrade | anws update 后做升级编排 | 判断 Minor / Major，并路由到 /change 或 /genesis |
📜 宪法 (The Constitution)
- 版本即法律: 不"修补"架构文档，只"演进"。变更必须创建新版本。
- 显式上下文: 决策写入 ADR，不留在"聊天记忆"里。
- 交叉验证: 编码前对照
05_TASKS.md。我在做计划好的事吗？ - 美学: 文档应该是美的。善用 Markdown 和 Emoji。
🔄 项目状态保留区
📍 当前状态 (由 Workflow 自动更新)
注意: 这是项目文件中的保留部分，由
/genesis、/blueprint和/forge自动维护。
- 最新架构版本:
.anws/v1 - 活动任务清单:
.anws/v1/05_TASKS.md - 待办任务数: 0 个阻塞实现任务；当前处于最终人工复核阶段
- 最近一次更新:
2026-03-16
🌊 Wave 1 — Guided Core + Replay 主链已完成
- 已完成
start / step / replayCLI 主路径 - 已完成自动保存、
final.md、replay.md与当前目录导出 - 已完成
verify一键验证链路 - 已完成
.windsurf/skills/sequential-thinking/SKILL.md与skills/sequential-thinking-skills/SKILL.md的 CLI 协议回写 - 当前状态：等待最终人工复核与是否准备提交
🌳 项目结构 (Project Tree)
注意: 此部分由
/genesis维护。
src/
└── anws/
├── bin/cli.js
├── lib/ (init, update, diff, changelog, copy, manifest, ...)
└── templates/
├── .agents/ (内部 canonical 模板源，经 projection 投放到各 target)
└── AGENTS.md
.anws/
├── changelog/ (升级记录)
└── v{N}/ (当前架构文档)
🧭 导航指南 (Navigation Guide)
注意: 此部分由
/genesis维护。
- 在新架构就绪前: 请勿大规模修改代码。
- 架构总览:
.anws/v{N}/02_ARCHITECTURE_OVERVIEW.md - ADR:
.anws/v{N}/03_ADR/(跨系统决策的唯一记录源) - 遇到架构问题: 请查阅
.anws/v{N}/03_ADR/。
技术栈决策
- [由 .anws/tech-evaluator 或 /genesis 自动填充]
系统边界
- [由 .anws/system-architect 或 /genesis 自动填充]
活跃 ADR
- [由 .anws 自动填充 ADR 摘要]
当前任务状态
T4.3.1已完成T1.3.1已完成pnpm typecheck / test / build / verify全通过- 当前不自动提交 Git，等待人工确认
状态自检: 准备好了？提醒用户运行
/quickstart开始吧。