Tóm tắt nhanh / Lệnh

Bộ Engineer

/ak:graphify

Graphify dựng đồ thị tri thức

Biến code, docs, paper, image, audio hoặc video thành đồ thị truy vấn được bằng AST local, transcription local, semantic extraction, report và MCP query.

01

Chọn mục tiêu

02

Cài đúng package

03

Dựng đồ thị

04

Đọc đầu ra

Nguyên tắc 01

Dùng đồ thị để điều hướng quan hệ, không thay thế việc kiểm tra source.

Nguyên tắc 02

Bắt đầu từ report và visualization, rồi truy vấn graph.json cho đường cụ thể.

Nguyên tắc 03

Tách facts được trích xuất khỏi quan hệ suy luận hoặc còn mơ hồ.

Bản đồ thực thi

Các nhánh chính từ đầu vào đến kết quả, bám theo cách command chạy khi dùng thật.

01

Khởi động

Đầu vào, phạm vi, route

  1. 1 Chọn mục tiêu Chọn path khi cần hiểu kiến trúc, quan hệ cross-file, god node hoặc điều hướng tiết kiệm token.
  2. 2 Cài đúng package Dùng package PyPI graphifyy nếu runtime thiếu; đừng nhầm với các package graphify không liên quan.
02

Xử lý

Agent / skill thực thi

  1. 3 Dựng đồ thị Chạy graphify . hoặc graphify /path/to/project để tạo artifact trong graphify-out.
  2. 4 Đọc đầu ra Xem graph.html để trực quan hóa, GRAPH_REPORT.md để thấy god node và câu hỏi gợi ý, graph.json để truy vấn lâu dài, và cache/ cho trạng thái incremental.
03

Kiểm chứng

Gate, review, xác thực

  1. 5 Truy vấn qua MCP Khi cần MCP, serve graphify-out/graph.json bằng python -m graphify.serve và dùng query_graph, get_node, get_neighbors hoặc shortest_path.
  2. 6 Kết hợp scout Dùng Graphify cho cấu trúc cấp cao và /ak:scout để tìm file cụ thể.
04

Đóng

Báo cáo, bàn giao, artifact

  1. 7 Cập nhật tăng dần Chạy lại sau thay đổi; cache SHA256 giúp chỉ xử lý file đã đổi.
  2. 8 Nêu ranh giới riêng tư Báo rõ AST code và transcript audio/video chạy local, còn docs/images dùng provider model đã cấu hình để semantic extraction.

Cú pháp, đối số, subcommand

Cách gọi skill: cú pháp, đối số vị trí, option dùng chung, rồi từng subcommand với cú pháp và kết quả riêng.

Cú pháp

/ak:graphify [path] [--mcp|--report|--watch]

Đối số

[path]

Đường dẫn đầu vào

Thư mục hoặc tập tài liệu có giới hạn cần dựng graph. Chọn phạm vi nhỏ nhất đủ dùng; lệnh ghi graphify-out/ tương đối với nơi chạy và không tự động đưa secret, build output hoặc archive không liên quan vào.

/ak:graphify ./src --report

Option dùng chung

--report

Nhấn mạnh report

Tập trung kết quả vào phát hiện trong GRAPH_REPORT.md như node nổi bật, quan hệ bất ngờ và câu hỏi gợi ý. Claim trong report vẫn cần đối chiếu source.

/ak:graphify ./src --report
--watch

Theo dõi rebuild

Rebuild tăng dần khi file thay đổi. Tùy chọn này bắt đầu theo dõi liên tục và ghi lặp lại; không cho phép process nền ngoài lần chạy đã yêu cầu.

/ak:graphify . --watch
--mcp

Truy vấn graph qua MCP

Chuẩn bị graphify-out/graph.json cho các tool truy vấn qua MCP như query_graph, get_node, get_neighbors và shortest_path. Việc cài server và cấu hình client vẫn là yêu cầu riêng.

/ak:graphify . --mcp

Prompt mẫu

Ví dụ gọi command theo từng flag, subcommand, mode hoặc route dùng được trong workflow thực tế.

Dựng graph hiện tại Khuyến nghị
/ak:graphify .
Dùng khi:
Khi cần bản đồ kiến trúc đầu tiên của repo lạ trước khi lập kế hoạch.
Kết quả:
Tạo graphify-out/graph.html, GRAPH_REPORT.md, graph.json và cache, rồi dùng report để nêu god node, liên kết bất ngờ và câu hỏi follow-up hữu ích.
Phân tích tập trung vào report
/ak:graphify src --report
Dùng khi:
Khi chủ yếu cần tóm tắt GRAPH_REPORT.md cho kiến trúc, chuỗi phụ thuộc và rà soát god-node.
Kết quả:
Chạy Graphify trên src và tập trung câu trả lời vào phát hiện trong GRAPH_REPORT.md: khái niệm liên kết nhiều nhất, quan hệ bất ngờ và câu hỏi gợi ý để kiểm tra source.
Chuẩn bị truy vấn MCP
/ak:graphify . --mcp
Dùng khi:
Khi muốn Claude truy vấn graph đã tạo qua các công cụ MCP graph giữa nhiều phiên.
Kết quả:
Tạo graphify-out/graph.json và chuẩn bị dùng MCP bằng python -m graphify.serve để query_graph, get_node, get_neighbors và shortest_path kiểm tra quan hệ.
Theo dõi rebuild tăng dần
/ak:graphify . --watch
Dùng khi:
Khi đang sửa file trong lúc khám phá và muốn graph được làm mới theo thay đổi của dự án.
Kết quả:
Chạy watch mode và dựa vào hash SHA256 trong graphify-out/cache để rebuild chỉ xử lý file đã đổi trong khi giữ graph output luôn cập nhật.

Phạm vi xử lý

  • Khám phá kiến trúc
  • Quan hệ cross-file
  • Phân tích god-node
  • Truy vấn graph qua MCP
  • Bản đồ ngữ cảnh tiết kiệm token

Artifact tạo ra

Artifact Graphify

Mẫu đường dẫn

graphify-out/graph.html, GRAPH_REPORT.md, graph.json, cache/.

Dùng report để định hướng, HTML để khám phá và graph.json/MCP cho truy vấn lặp lại được.

Skill liên quan

Tiếp theo