Các Loại Hook và Trigger#

Cấu hình#

Hooks được đặt trong .kiro/hooks.yaml tại thư mục gốc dự án:

1
hooks:
2
  # Khi lưu: tái tạo unit tests cho component đã thay đổi
3
  - trigger: on_save
4
    pattern: "src/components/**/*.tsx"
5
    action: "Tạo lại unit tests cho component này trong tests/components/"
6

7
  # Khi lưu: type-check file TypeScript đã thay đổi
8
  - trigger: on_save
9
    pattern: "src/**/*.ts"
10
    action: "Chạy TypeScript type checker trên file đã thay đổi và sửa lỗi type"
11

12
  # Khi commit: quét hardcoded secrets
13
  - trigger: on_commit
14
    action: "Quét tất cả staged files để tìm API keys, password, tokens hardcoded. Báo cáo chính xác file và dòng."
15

16
  # Khi commit: kiểm tra convention commit message
17
  - trigger: on_commit
18
    action: "Xác thực commit message theo định dạng conventional commits (type(scope): description). Nếu không đúng, gợi ý format chính xác."
19

20
  # Khi API thay đổi: cập nhật tài liệu
21
  - trigger: on_api_change
22
    pattern: "src/routes/**/*.ts"
23
    action: "Cập nhật tài liệu API trong docs/api/ phản ánh routes đã thay đổi"
24

25
  # Khi build: kiểm tra bảo mật
26
  - trigger: on_build
27
    action: "Chạy npm audit trên package.json. Nếu có lỗ hổng, phân loại theo mức độ nghiêm trọng và đề xuất cách sửa."
28

29
  # Khi PR mở: tạo mô tả
30
  - trigger: on_pr_open
31
    action: "Phân tích diff giữa branch này và main. Tạo mô tả PR gồm: tóm tắt thay đổi, file bị ảnh hưởng, breaking changes, và hướng dẫn kiểm thử."

Cách Hooks Thực thi#

Khi một trigger kích hoạt (ví dụ: bạn lưu file), Kiro:

1. Khớp trigger — kiểm tra file thay đổi có khớp pattern glob không
2. Đọc context — tải file hiện tại, thay đổi gần đây, và cấu trúc dự án
3. Thực thi action — diễn giải hướng dẫn ngôn ngữ tự nhiên và thực hiện công việc
4. Báo cáo kết quả — hiển thị thông báo trong IDE (thành công, cảnh báo, hoặc cờ)

Hook thực thi bất đồng bộ và chạy song song với công việc của bạn. Bạn sẽ thấy một indicator nhẹ rằng hook đang chạy, nhưng nó sẽ không chặn việc chỉnh sửa của bạn.

Tham số Pattern#

Trường pattern là glob giới hạn file nào kích hoạt hook:

1
# Chỉ kích hoạt khi file TypeScript source thay đổi
2
pattern: "src/**/*.ts"
3

4
# Chỉ kích hoạt khi file API route thay đổi
5
pattern: "src/routes/**/*.ts"
6

7
# Chỉ kích hoạt khi file test thay đổi
8
pattern: "**/*.test.ts"
9

10
# Kích hoạt trên bất kỳ file JavaScript/TypeScript nào
11
pattern: "src/**/*.{js,ts,jsx,tsx}"

Không có pattern, hook kích hoạt cho bất kỳ file thay đổi nào khớp trigger.

Safety: Tại sao Ngôn ngữ Tự nhiên > Scripts#

Git hooks truyền thống là shell scripts — hook pre-commit chạy npm test hoặc pass hoặc fail. Hooks ngôn ngữ tự nhiên của Kiro thông minh hơn:

1
# Thay vì: "run eslint on src/"
2
# Bạn viết:
3
- trigger: on_save
4
  pattern: "src/**/*.ts"
5
  action: "Kiểm tra file đã lưu cho các vấn đề coding phổ biến: unused imports, thiếu xử lý lỗi, hardcoded values lẽ ra nên là config. Sửa trực tiếp."

Agent hiểu cái gì bạn muốn kiểm tra, không chỉ lệnh nào để chạy. Nó có thể:

• Phân biệt giữa secret thật và test placeholder
• Hiểu rằng một import thiếu có thể là cố ý trong file WIP
• Áp dụng conventions dự án cụ thể từ steering file

Điều này làm cho hooks ít fragile hơn đáng kể so với shell scripts.

Cách Powers Hoạt động#

Mỗi Power bao gồm:

• MCP server (implementation công cụ thực tế)
• Cấu hình riêng Kiro (steering file snippets, hook templates, spec patterns)
• Thiết lập Auth (OAuth flow, quản lý API key)
• Ví dụ sử dụng (prompt templates tối ưu cho công cụ này)

Danh mục Powers#

Kiro có hơn 100 Powers. Dưới đây là các danh mục ảnh hưởng nhất:

Spotlight: Figma Power#

Figma Power là một trong những Power ấn tượng nhất của Kiro — nó kết nối file Figma với code generation:

1
# Cách hoạt động:
2
# 1. Thả Figma URL vào Kiro spec
3
# 2. Kiro lấy design qua Figma MCP
4
# 3. Nó hiểu: component hierarchy, design tokens, layout, interactions
5
# 4. Tạo code khớp tech stack của bạn (React/Tailwind/TypeScript)
6
# 5. Dùng Code Connect để map Figma components vào component có sẵn

Điều này khác cơ bản so với các công cụ “screenshot to code”. Figma Power hiểu design system của bạn, không chỉ vị trí pixel.

Kích hoạt Power#

Từ Kiro IDE:

1. Mở tab Powers (thanh bên trái)
2. Duyệt hoặc tìm kiếm — thử “PostgreSQL” để xem database Powers
3. Nhấn vào card Power → xem permissions và yêu cầu auth
4. Nhấn Add
5. Hoàn tất luồng auth (OAuth, nhập API key)

Power đã được kích hoạt. Kiro sẽ tự động dùng công cụ của nó trong quá trình tạo spec và thực thi task.

Cấu hình#

Sửa .kiro/kiro.json trong thư mục gốc dự án:

1
{
2
  "mcpServers": {
3
    "internal-api-docs": {
4
      "command": "node",
5
      "args": ["/path/to/mcp-server/index.js"],
6
      "env": {
7
        "API_DOCS_URL": "${INTERNAL_API_URL}"
8
      }
9
    },
10
    "pagerduty": {
11
      "command": "npx",
12
      "args": ["-y", "@pagerduty/mcp-server"],
13
      "env": {
14
        "PAGERDUTY_API_KEY": "${PAGERDUTY_TOKEN}"
15
      }
16
    }
17
  }
18
}

Quy tắc Bảo mật cho MCP#

1. Không bao giờ hardcode token — dùng biến môi trường hoặc secret store của Kiro
2. Read-only tokens trước — bắt đầu với API keys read-only; nâng cấp khi cần
3. Giới hạn phạm vi — Kiro có thể kết nối tối đa 5 MCP server đồng thời; nhiều hơn = tiêu thụ token nhiều hơn + planning chậm hơn
4. Kiểm tra quyền token — xem mỗi MCP server token có thể truy cập gì

MCP trong Autonomous Agent#

Khi bạn chạy autonomous agent (giao diện Web), tích hợp MCP có sẵn trong quá trình thực thi task. Agent có thể truy vấn API bên ngoài, kiểm tra tài liệu, và gọi dịch vụ — tất cả trong sandbox cách ly.

Khác biệt chính so với IDE MCP: autonomous agent có thể dùng MCP tools xuyên nhiều repo trong một task duy nhất, duy trì ngữ cảnh xuyên suốt.