用途:map 是 agent-toolkit 的入口技能,面向需要 CONTEXT.md 层级的棕地(既有)代码库。它从现有代码逆向梳理系统与组件架构,产出可维护的 CONTEXT.md 文档,使 architect、triage、verify 可用。它只记录现状(含技术债),不做设计或重构建议。
主要能力:先做 intake,明确目标与可观察结果、影响范围、约束与反目标、需求成熟度,只梳理支撑该 intake 所需范围。随后分阶段执行:发现阶段运行 node "$SKILL_DIR/scripts/context-discover.mjs" 查找已有 CONTEXT.md,并用 explore 子代理分别了解系统级结构、构建与测试基础设施、各顶层组件;再生成根 CONTEXT.md 与各组件 CONTEXT.md;进行有效性检查;最后用 git rev-parse HEAD 标记 provenance。
使用方式:脚本位于技能自身 scripts/ 目录,需先设置 SKILL_DIR 为技能绝对路径,再从项目根目录运行,脚本操作项目的 .changes/ 与 CONTEXT.md。脚手架命令为 node "$SKILL_DIR/scripts/context-scaffold.mjs" --path . --name "<Project Name>" --root,组件级用 --path <component-dir>。不要引用 packages/build/。
适用场景:需要为既有代码库建立架构上下文文档、供后续智能体会话使用的团队。
限制:不提出架构改进、不创建变更清单、不运行测试,也不保证 CONTEXT.md 完整,仅为尽力推导;接缝默认标为 soft,仅在有外部契约证据时标 firm;技术需求须有证据。缺失信息暂未提供。