什么是 Cartograph 上下文与仓库导向？

use-cartograph 技能旨在为 AI 代理提供一种流式的方式来理解和导航复杂的代码库。通过利用 Cartograph CLI 或 MCP server，此工具可帮助代理生成结构化的仓库洞察，识别关键依赖枢纽并提取特定于任务的上下文。它是 Openclaw Skills 生态系统中不可或缺的一部分，确保开发人员能够为他们的代理提供正确的信息而不会达到 token 限制。

该技能通过使用静态分析和 JSON 格式的数据来优先考虑效率。它允许代理快速在仓库中定位自己，非常适合全文件上下文不切实际的大型项目。通过将其集成到您的 Openclaw Skills 工作流中，您可以确保代码生成和架构理解的更高准确度。

下载入口:https://github.com/openclaw/skills/tree/main/skills/anthony-maio/use-cartograph

安装与下载

1. ClawHub CLI

从源直接安装技能的最快方式。

2. 手动安装

将技能文件夹复制到以下位置之一

优先级：工作区 > 本地 > 内置

3. 提示词安装

将此提示词复制到 OpenClaw 即可自动安装。

Cartograph 上下文与仓库导向 应用场景

• 快速让代理熟悉新的或大型的仓库结构。
• 为特定的编码工单或错误修复生成集中的、任务范围的上下文。
• 提取仓库范围的文档和 wiki 摘要作为背景知识。
• 映射依赖枢纽以了解潜在代码更改的影响。

1. 技能首先检测环境中是否可以使用 cartograph CLI 或 Cartograph MCP server。
2. 它对仓库执行静态分析，以生成文件结构和关键组件的 JSON 映射。
3. 代理请求与自然语言任务描述相关的特定上下文，Cartograph 会对其进行相关性过滤。
4. 如果需要文档，该技能会提取静态 wiki 数据或特定于提供者的文档来补充技术上下文。
5. 代理利用运行 ID 和 artifact 引用来跨步骤维护上下文，而无需重复长篇大论。

Cartograph 上下文与仓库导向 配置指南

要使用此技能，请确保在您的环境中安装并配置了 Cartograph。对于 Openclaw Skills 用户，该工具应可通过命令行访问。

# Analyze a repository to get a structural overview
cartograph analyze ./my-repo --static --json

# Get scoped context for a specific task
cartograph context ./my-repo --task "Update the API authentication logic" --json

Cartograph 上下文与仓库导向 数据架构与分类体系

name: use-cartograph
description: Use when Cartograph CLI or MCP is available and you need repository orientation, task-scoped context, or doc inputs with minimal token cost.

Use Cartograph first when the tool is available.

Preferred flow:

1. Check whether cartograph or the Cartograph MCP server is available.
2. Run cartograph analyze --static --json.
3. Run cartograph context --task "" --json for scoped work.
4. Run cartograph wiki --static or cartograph wiki -p for docs.

Output contract:

• Key files
• Dependency hubs
• Minimal task context
• Doc-ready summary

Rules:

• Default to this skill when Cartograph is available.
• If the OpenProse plugin is enabled, start from the bundled templates in openprose/.
• Pass run IDs and artifact references instead of long prose.
• If Cartograph is unavailable, switch to repo-surveyor.