AgentKit
Tài liệuBộ kitTham chiếu CLIỨng dụng Desktop

Skill

Xây dựng knowledge graph có thể review với ak:graphify

Biến code hoặc document set có giới hạn thành graph artifact có thể query, đồng thời giữ relationship extracted, inferred và ambiguous tách biệt.

Dùng ak:graphify để biến code, document, paper, image hoặc local media thành relationship graph có thể query. Skill ghi visualization, report, JSON và cache artifact dùng lại được để bạn khám phá cấu trúc trước khi plan hay edit.

Chọn ak:graphify để khám phá relationship

Dùng ak:graphify khi

  • Bạn cần high-level map của codebase hoặc document collection chưa quen.
  • Bạn muốn khám phá dependency, connected concept, central node hoặc path.
  • Bạn cần persistent graph artifact có thể query qua MCP server tùy chọn.

Chọn workflow khác khi

  • Bạn cần go-to-definition hoặc find-usages ở mức symbol. Dùng ak:gkg.
  • Bạn chỉ cần bounded file map. Dùng ak:scout.
  • Bạn cần đóng gói raw context thay vì relationship extraction.
  • Bạn không thể gửi document hoặc image tới configured model provider và cũng không thể loại chúng khỏi input.

Chuẩn bị input và runtime

Cài Python 3.10 trở lên cùng package graphifyy được phân phối riêng. Chọn input path nhỏ nhất, review ignored cùng generated content, ước lượng disk và provider use, rồi quyết định ongoing watch process có được phép không.

RuntimeCách gọiRanh giới khả dụng
Claude Code/ak:graphify ...Phân phối native có thể chạy CLI, kiểm tra generated artifact và dùng MCP server được cấu hình rõ.
Cursor/ak:graphify ...Cách gọi slash đã được người dùng xác minh; CLI, provider và MCP parity chưa được thiết lập.
Codex$ak:graphify ...Native discovery được hỗ trợ; Python package, provider credential, persistent process và MCP access phụ thuộc session.

Chạy Skill

/ak:graphify ./src --report "Map module dependencies, keep EXTRACTED and INFERRED edges separate, exclude secrets and generated files, and do not start a watch process or MCP server."
Input hoặc optionTác dụngRanh giới
<path>Xây graph từ folder đã chọnGhi graphify-out/ tương đối với run location
--reportNhấn mạnh generated graph reportReport claim vẫn cần source review
--watchRebuild tăng dần khi file thay đổiBắt đầu observation liên tục và repeated write
--mcpCho MCP-backed query dùng persistent graphServer installation và configuration là yêu cầu riêng
Full package extrasThêm document, media, community hoặc database featureCó thể thêm dependency lớn cùng provider hoặc storage requirement

Hiểu các giai đoạn có thể quan sát

  1. Resolve scope: inventory file đã chọn, exclusion, media type và repository instruction trước processing.
  2. Extract structure: parse code được hỗ trợ bằng tree-sitter và gắn tag EXTRACTED cho import, call hoặc inheritance trực tiếp.
  3. Process media khác: transcribe audio hoặc video được hỗ trợ cục bộ khi có component cần thiết.
  4. Extract semantic: gửi document hoặc image đã chọn tới configured model provider và gắn INFERRED hoặc AMBIGUOUS cho relationship dẫn xuất.
  5. Assemble artifact: ghi graph JSON, interactive HTML, report và incremental cache dưới graphify-out/.
  6. Review hoặc serve: kiểm tra surprising path cùng confidence tag; chỉ khởi động MCP server khi được cấp quyền riêng.

Giới hạn privacy và graph claim

Input type làm thay đổi data boundary

Code AST extraction và supported media transcription được mô tả là local. Document cùng image đã chọn được gửi tới configured model provider để semantic extraction. Loại file nhạy cảm hoặc xin approval trước transfer đó.

  • Không đưa secret store, credential, private customer material, build output hoặc archive không liên quan vào chỉ vì chúng nằm dưới input path.
  • Edge EXTRACTED là parser evidence, không chứng minh runtime behavior hoặc architectural intent. Edge INFERRED là model interpretation và cần source review. Edge AMBIGUOUS phải giữ trạng thái chưa resolve rõ ràng.
  • Cài graphifyy hoặc extras làm thay đổi Python environment. Lệnh upstream graphify install không cần để cài AgentKit Skill.
  • Khởi động watch hoặc MCP mode không cấp quyền persistent background service, network exposure hoặc edit client configuration.
  • Review content graphify-out/ hiện có trước overwrite hoặc clean; cache có thể là evidence về cách graph trước đó được tạo.

Xác minh output và evidence

Một lần chạy đầy đủ nên nêu input root, exclusion, file type đã process, stage local so với provider-backed, error hoặc skipped file và artifact chính xác:

  • graphify-out/graph.html để interactive exploration.
  • graphify-out/GRAPH_REPORT.md cho prominent node và suggested question.
  • graphify-out/graph.json cho persistent query hoặc MCP serving.
  • graphify-out/cache/ cho incremental file-hash state.

Mở HTML cùng report, đối chiếu sample node quan trọng với source và xác nhận JSON giữ provenance tag. Không báo graph đầy đủ khi vẫn có unsupported file, provider failure hoặc ambiguous relationship.

Xử lý sự cố an toàn

Triệu chứngBước tiếp theo an toàn
Thiếu graphifyCài distribution graphifyy đã duyệt trong environment dự kiến và xác minh executable.
First build chậm hoặc lớnThu hẹp path, loại generated material và ghi partial coverage thay vì âm thầm tăng resource.
Document hoặc image extraction lỗiGiữ local AST result, báo provider gap và không tạo semantic edge không có bằng chứng.
Graph chứa connection bất ngờKiểm tra provenance cùng source node; hạ mức hoặc bỏ unsupported inference.
Watch mode tiếp tục ghiDừng process, kiểm tra changed artifact và rerun one-shot nếu không định continuous monitoring.
MCP không query được graphXác nhận graph.json đã chọn, optional MCP package, process và client configuration.
Runtime không tìm thấy SkillXác nhận target cùng scope, restart session, rồi làm theo Runtime không tìm thấy Skill hoặc Agent.

Biết các giới hạn hiện tại

  • Language parsing, semantic extraction, transcription, clustering và MCP feature phụ thuộc package extra được cài riêng.
  • Chất lượng model-derived graph phụ thuộc provider cùng model đã chọn; graph proximity không chứng minh causation hay ownership.
  • Release evidence mô tả shipped workflow nhưng không thiết lập current upstream package behavior hoặc end-to-end runtime parity.
  • Stable và beta chứa source ak:graphify giống nhau.

Tiếp tục với ak:gkg để symbol navigation hoặc ak:plan để biến graph evidence đã xác minh thành delivery roadmap.

Điều hướng code theo semantic với ak:gkg

Index Git repository bằng GitLab Knowledge Graph, query definition và reference, rồi định chuẩn impact claim theo language support.

Điều tra threat intelligence công khai với ak:cti-expert

Chạy CTI hoặc OSINT case có giới hạn, giữ bằng chứng về nguồn và confidence, rồi xuất report có thể review mà không coi inference là fact.

On this page

Chọn ak:graphify để khám phá relationshipDùng ak:graphify khiChọn workflow khác khiChuẩn bị input và runtimeChạy SkillHiểu các giai đoạn có thể quan sátGiới hạn privacy và graph claimXác minh output và evidenceXử lý sự cố an toànBiết các giới hạn hiện tại