phuc-nt/kiro-agent-kit

phuc-nt-Profil

Letzte erfasste Quellaktivität: 6. September 2026 um 15:18

SkillsMP-Katalog aktualisiert: 17. Oktober 2026 um 00:09

gesammelte Skills: 60

GitHub-Stars: 0
GitHub-Forks: 0

README des Repositorys

README-Quelldatei: README.md

README-Quelldatei lesen

Vollständige README anzeigen

# My Agent Kit Lite — Kiro edition Bản chuyển thể của [my-agent-kit-lite](../my-agent-kit-lite/) (v2.6.1) để dùng với **Kiro CLI** (đã test thật với `kiro-cli 2.21.1`, agent engine **v2** mặc định, free plan). Sinh tự động từ bản lite bằng `build_kiro_kit.py`; phần chỉnh tay nằm trong `templates/`. Báo cáo kiểm chứng chi tiết (bằng chứng từ session log của Kiro): [docs/kiro-verification-report.md](docs/kiro-verification-report.md). ## Cài đặt ```bash python3 build_kiro_kit.py # sinh lại kit/ từ ../my-agent-kit-lite (nếu cần) ./kiro-init.sh /path/to/project # copy .claude/ .kiro/ AGENTS.md (+ đặt mk làm default agent của workspace) cd /path/to/project kiro-cli chat # = kiro-cli chat --agent mk nhờ .kiro/settings/cli.json ``` `kiro-init.sh` flags: `--force` (ghi đè kit nhưng **giữ** `.claude/.mk.json`, `.claude/hooks/.logs`, `.kiro/settings/cli.json`), `--no-default` (không đặt default agent), `--dry-run`. Vì sao cần default agent: hooks v2 chỉ sống trong agent config, nên `kiro-cli chat` với agent `kiro_default` vẫn thấy steering + skills nhưng **không chạy hook nào**, và không báo gì. Kit ship `.kiro/settings/cli.json = {"chat.defaultAgent": "mk"}` (workspace-scoped, không ảnh hưởng thư mục khác). Steering `mk-kit.md` còn dặn model tự báo nếu không nhận được context của hook. ## Kiến trúc ``` project/ ├── AGENTS.md ← Kiro đọc natively (từ templates/AGENTS.md) ├── .claude/ ← "runtime home" của kit — Kiro KHÔNG đọc, kit tự đọc │ ├── skills/<name>/SKILL.md ← 30 skill đầy đủ (namespace mk: → mk-) │ ├── rules/ ← 5 rule gốc (session-init trỏ tới đây) │ ├── hooks/*.cjs + lib/ ← 7 hook gốc, KHÔNG sửa │ ├── hooks/adapters/kiro.cjs ← adapter: payload Kiro ⇄ contract Claude Code, session id, transcript, router │ ├── hooks/.logs/ ← hook-log.jsonl, kiro-session.json, kiro-transcript-*.jsonl (5 gần nhất) │ ├── .mk.json / .mkignore ← config kit └── .kiro/ ├── skills/mk-<name>/SKILL.md ← 30 wrapper: 9 skill tier-1 inline toàn văn, còn lại → "đọc .claude/skills/<name>/SKILL.md" ├── steering/mk-*.md ← 4 rule + mk-kit.md (cơ chế kit dưới Kiro, checklist, self-check) ├── agents/<name>.json ← 12 subagent + mk (orchestrator), prompt qua file://./prompts/<name>.md ├── settings/cli.json ← chat.defaultAgent = mk (workspace) └── hooks/mk-hooks.json ← format v3/IDE — CHƯA kiểm chứng được (xem giới hạn) ``` ## Khác gì bản lite (Claude Code)? | Thành phần | Claude Code edition | Kiro edition | |---|---|---| | Rules | `.claude/rules/` + CLAUDE.md | Giữ `.claude/rules/`, thêm bản copy `.kiro/steering/mk-*.md` (CLI nạp toàn bộ steering, bỏ qua `inclusion`) | | Skills (30) | `.claude/skills/`, tên `mk:cook` | Giữ nguyên nội dung; wrapper `.kiro/skills/mk-cook/SKILL.md` để Kiro discover + slash `/mk-cook`. Tên phải `[a-z0-9-]` nên `mk:` → `mk-`; `archify` giữ tên. 9 skill tier-1 (scout, test, fix, cook, docs, git, ship, plan, code-review) được **inline** toàn văn vào wrapper → 1 tool call thay vì 2 (`--no-inline` để tắt) | | Skill auto-trigger | Claude tự chọn skill theo description | Kiro không tự kích hoạt → adapter thêm **Kit hint** ở userPromptSubmit (keyword → `mk-fix`/`mk-test`/`mk-plan`/…; tắt bằng `MK_KIRO_NO_ROUTER=1`) | | Slash commands | Tự động từ skill | `/mk-*` chỉ chạy ở **chế độ interactive** (v2). Headless (`--no-interactive`) phải nói "Use the mk-scout skill…" | | Agents (12) | markdown frontmatter | JSON v2 (`.kiro/agents/*.json`), tools → tag `read/write/shell/web_fetch/web_search/subagent`; thân prompt sang `prompts/<name>.md` kèm ghi chú map tool. Model: `haiku` → `claude-haiku-4.5`, `sonnet` → `claude-sonnet-4.5`, `opus/fable/inherit` → Kiro `auto` (không có opus) | | Hooks (7) | `settings.json` | Toàn bộ 7 hook **chạy được** qua `adapters/kiro.cjs`, đăng ký trong khối `hooks` của từng agent JSON. Chặn = exit 2 + stderr | | Gates (simplify, workflow-artifact) | mặc định tắt | Như lite: tắt mặc định. Bật trong `.claude/.mk.json` (`simplify.gate.enabled: true`, `hooks.workflow-artifact-gate: true`) | | Task/TaskCreate/TodoWrite | có | Kiro không có → `Task(agent)` = `use_subagent`. Checklist: model viết `- [x]`/`- [ ]`/`- [~]` cuối reply (hoặc `plans/checklist.md`); adapter ghi thành transcript JSONL giả lập (TodoWrite/Task) để session-state điền "What Worked / What's Left" y như Claude Code. Đã test resume qua session mới | | Session id | Claude cấp | Kiro **không gửi** → adapter tự cấp (`.claude/hooks/.logs/kiro-session.json`, mint ở session-init) | | statusline, .env.example, .mcp.json | có | bỏ | ## Mapping hook (adapter) | Kiro (v2, trong agent JSON) | Payload Claude sinh ra | Hook kit | |---|---|---| | `agentSpawn` | SessionStart `{source:"startup"}` / SubagentStart `{agent_type}` | session-init / subagent-init | | `userPromptSubmit` | UserPromptSubmit `{prompt}` | dev-rules-reminder, simplify-gate, workflow-artifact-gate | | `preToolUse` (mọi tool) | PreToolUse, `fs_read→Read`, `fs_write→Write`, `execute_bash→Bash`, `glob/grep`, `use_subagent→Task`; trong subagent `read/write/shell/summary` | scout-block | | `postToolUse` matcher `use_subagent`, `fs_write` | PostToolUse Task / Write (+ ghi transcript: Task, TodoWrite từ `*checklist.md`) | session-state | | `stop` | Stop / SubagentStop `{agent_type}` | session-state → `~/.claude/session-states/<hash>/latest.md` | Env: `MK_KIRO_SOFT_BLOCK=1` biến block thành cảnh báo (workaround bug Kiro bên dưới, **luôn bật trong CI**), `MK_KIRO_NO_ROUTER=1` tắt Kit hint, `MK_KIRO_DEBUG=1` dump payload thô vào `.logs/kiro-raw.jsonl`, `MK_SIMPLIFY_DISABLED=1`, `MK_WORKFLOW_ARTIFACT_GATE_DISABLED=1` như bản gốc. Kiro đặt output hook ở 2 chỗ khác nhau: `userPromptSubmit` → `additional_context` của turn (lưu trong sqlite, kèm preamble "you must follow"); `agentSpawn` → tới model nhưng **không lưu** trong sqlite. Muốn xem session-init đã nói gì, đọc `.claude/hooks/.logs/`, đừng tìm trong DB của Kiro. ## Giới hạn đã biết (đã thử) - **Kiro 2.21.1 headless crash** khi hook chặn 1 call trong batch tool song song (`Bedrock … Expected toolResult blocks`). Interactive tự hồi phục. Steering đã làm model tự tránh `node_modules`/`dist` nên hiếm gặp; nếu gặp dùng `MK_KIRO_SOFT_BLOCK=1`. - **Engine v3 (`--v3`)**: agent JSON v2 bị từ chối ("needs upgrading… using default"), `.kiro/hooks/*.json` không bắn. Kit này = v2. Khi Kiro chuyển v3 mặc định cần build lại agents (.md) — `templates/` và `build_kiro_kit.py` là chỗ sửa. - Matcher hook v2 chỉ khớp **tên tool chính xác** (regex `a|b` không bắn) → dùng 1 entry không matcher cho `preToolUse`, adapter tự lọc. - Tag `web` không tồn tại ở v2 → builder dùng `web_fetch`, `web_search`. - `session-state` ghi vào `~/.claude/session-states/` (global, dùng chung với Claude Code). - Kit hint là regex từ khóa, có thể gợi ý sai (ví dụ "outline a plan" → `mk-plan` dù user chỉ muốn gọi planner); hint tự ghi "ignore if the user clearly wants something else". - Mỗi tool call tốn ~2 tiến trình node (≈50–100 ms) cho hook. - Skill scripts Python/Node trong `.claude/skills/*/scripts` chưa test trên Kiro. ## Rebuild từ lite mới hơn ```bash python3 build_kiro_kit.py bash ../my-agent-kit-lite/claude/skills/strip-identity/scripts/verify.sh kit/.claude # RESULT: clean bash ../my-agent-kit-lite/claude/skills/strip-identity/scripts/verify.sh kit/.kiro cd kit && for f in .kiro/agents/*.json; do kiro-cli agent validate --path "$f"; done # im lặng = OK ```

README des Repositorys wird geladen…

Skills in diesem Repository

Softwareentwickler Projektmanagementspezialisten Softwarequalitätssicherungsanalysten und -tester Grafikdesigner

10 Berufskategorien · 100% klassifiziert

Skill

Beruf

Beschreibung

Aktualisiert

mk-observe

Softwareentwickler

Collect, score and browse agent activity across Claude Code, opencode and Kiro CLI — four honest dimensions (acceptance, success, autonomy, reliability) with formulas and provenance, token usage per model (raw counts, no price guessing), kit adoption (which…

Quellsprache: Englisch

2026-09-06

Grafikdesigner

Quellsprache: Englisch

2026-09-06

ghpm

Projektmanagementspezialisten

GitHub project management for humans and AI agents. Use for issue/task planning, Projects boards, handoff status, gh/API automation, and CI-driven work tracking.

Quellsprache: Englisch

2026-09-06

mk-brainstorm

Projektmanagementspezialisten

Quellsprache: Englisch

2026-09-06

Softwareentwickler

Fix bugs, errors, test failures, and CI/CD issues with intelligent routing. Use for type errors, lint issues, log errors, UI bugs, code problems.

Quellsprache: Englisch

2026-09-06

Es werden 40 von 60 gesammelten Skills angezeigt.

Mit einem KI-Assistenten installieren

Diesen Prompt kopieren und in den verwendeten KI-Assistenten einfügen.

Follow https://skillsmp.com/skill-install/prompt.md to install Agent Skills from https://github.com/phuc-nt/kiro-agent-kit.