用途
本技能围绕指定仓库 sebastianbrzustowicz/Agentic-GraphRAG-Blueprint 提供操作辅助，目标是对该仓库的代码、配置与本地运行方式进行检查和排障，而不是作为通用的 GraphRAG 实现教程使用。技能附带固定提交的上游资料，能力描述须以实际检出的版本为准。
主要能力
- 预检校验：提供独立的 Python 标准库脚本 preflight.py。在仓库根目录执行
python3 .agent-skills/agentic-graphrag-blueprint/scripts/preflight.py --repo /absolute/nonsymlink/checkout --json可核对固定文件的 SHA-256，并检查 PATH 中命令名是否存在（仅名称，不检查版本）。退出码 0 表示输入有效且选定文件校验通过，1 表示文件缺失或不匹配，2 表示输入有误。未提供 --repo 时仅报告未验证清单。 - 路由检查范围：可检查获取/摄取流程与本地 Compose 堆栈；仅在用户询问云部署时才查看 Azure/Terraform 相关内容；通用的记忆系统选型应转向 agent-memory-architecture。
- 边界区分：帮助区分本地 Compose 与 README 中 Azure 架构参考，避免将前者误认为会创建 Azure 资源，或把当前检出版本误判为可部署状态。
使用方式
脚本需在 POSIX 环境运行，Python 3.10+；Windows 原生环境会失败关闭，建议使用 WSL2。脚本不发起子进程、网络调用、写入操作或读取密钥。仓库场景下 --repo 必须为显式绝对且非符号链接目录。实际操作前应确认仓库与提交信息，并优先进行只读的代码与配置检查。
适用场景
- 检查该仓库的 GraphRAG 摄取流程而不实际运行。
- 判断 Compose 文件是否会启动 Azure 部署。
- 在用户明确批准文档集、提供商、成本与写入目标后，再执行摄取。
限制与注意事项
preflight 只校验选定源文件哈希，不能称为运行时测试；它不比较 Git HEAD 或完整修订，也不验证运行时。启动服务、上传文档、使用模型提供商、产生费用、创建云资源或变更图/向量/会话数据前，须针对具体操作和目标获得批准。检查 FORCE_RESET 与目标路径，避免输出密钥值。报告时应说明确切修订、已检查文件、实际执行的操作、数据是否留在本地、提供商或成本暴露情况，以及哪些内容未做运行时验证。