@buiducnhat/agent-skills 0.5.0 → 0.5.2

package/README.vi.md

@@ -0,0 +1,247 @@
+# agent-skills
+
+Cài đặt các workflow skill chuẩn hóa cho AI agent và các tài nguyên cấu hình vào bất kỳ repository nào chỉ với một lệnh duy nhất.
+
+Hỗ trợ **39 AI coding agent** bao gồm Claude Code, Cursor, Windsurf, Copilot, Cline, Roo Code và nhiều hơn nữa.
+
+---
+
+**Ngôn ngữ:** [English](README.md) | Tiếng Việt
+
+---
+
+## Tính năng
+
+Khi chạy trình cài đặt:
+
+1. Cho phép **chọn agent** cần cấu hình (tự động phát hiện các agent đã cài)
+2. Cài đặt **9 workflow skill** vào thư mục skills của từng agent thông qua [Vercel skills CLI](https://github.com/vercel-labs/skills)
+3. Chèn **hướng dẫn dùng chung cho agent** (`AGENTS.md`) vào file rules của từng agent sử dụng marker idempotent
+4. Sao chép **cài đặt Claude Code** (`.claude/`) vào project của bạn
+
+## Cài đặt
+
+### Tương tác (khuyến nghị)
+
+```bash
+npx @buiducnhat/agent-skills
+```
+
+Hướng dẫn từng bước qua việc chọn agent và chế độ cài đặt (symlink hoặc copy).
+
+### Không tương tác (CI / tự động hóa)
+
+```bash
+npx @buiducnhat/agent-skills --non-interactive
+```
+
+Bỏ qua tất cả các bước hỏi và cài đặt skill cho tất cả agent.
+
+### Qua shell script
+
+```bash
+curl -fsSL https://raw.githubusercontent.com/buiducnhat/agent-skills/main/install.sh | bash
+```
+
+Kiểm tra Node.js 18+ và chạy trình cài đặt tự động.
+
+### Cài đặt toàn cục
+
+```bash
+npx @buiducnhat/agent-skills --global
+```
+
+Cài đặt skill vào thư mục home (`~/<agent>/skills/`) để dùng được trên tất cả các project.
+
+## Hướng dẫn tương tác
+
+```
+┌  Agent Skills Installer
+│
+◇  Select agents to install skills for:
+│  ◼ Claude Code  ◼ Cursor  ◻ Windsurf  ...
+│
+◇  How should the skills be installed?
+│  ● Symlink (recommended)  ○ Copy
+│
+◇  Installing skills via skills CLI...
+│
+◇  Installation complete!
+│
+│  What was set up:
+│    .claude/              - Claude Code settings
+│    CLAUDE.md             - updated
+│
+│  Agent configurations updated for:
+│    - claude-code
+│    - cursor
+│
+└  Done! Your AI agent skills are ready.
+```
+
+## Tùy chọn CLI
+
+| Flag                | Mô tả                                                      |
+| ------------------- | ---------------------------------------------------------- |
+| `--non-interactive` | Bỏ qua các bước hỏi; cài đặt tất cả skill cho tất cả agent |
+| `--copy`            | Sao chép file skill thay vì tạo symlink                    |
+| `-g, --global`      | Cài vào `~/` thay vì thư mục hiện tại                      |
+| `-h, --help`        | Hiển thị trợ giúp                                          |
+| `-v, --version`     | Hiển thị phiên bản                                         |
+
+## Workflow skill
+
+Chín workflow skill có thể tái sử dụng được cài đặt vào mỗi agent:
+
+| Skill             | Mô tả                                                                |
+| ----------------- | -------------------------------------------------------------------- |
+| `ask`             | Đặt câu hỏi làm rõ để thu thập yêu cầu và ngữ cảnh                   |
+| `bootstrap`       | Thiết lập cấu trúc project, tài liệu và quy ước cho project mới      |
+| `brainstorm`      | Khám phá ý tưởng và phân tích vấn đề phức tạp trước khi lên kế hoạch |
+| `docs`            | Khởi tạo (`--init`) hoặc cập nhật (`--update`) tài liệu project      |
+| `execute-plan`    | Thực thi kế hoạch đã viết theo từng giai đoạn với các điểm kiểm tra  |
+| `fix`             | Chẩn đoán và sửa lỗi                                                 |
+| `quick-implement` | Triển khai nhanh cho các task nhỏ hoặc sửa lỗi đơn giản              |
+| `review`          | Review các thay đổi chưa commit với ngữ cảnh codebase                |
+| `write-plan`      | Tạo kế hoạch triển khai chi tiết theo từng giai đoạn                 |
+
+### Chuỗi workflow khuyến nghị
+
+---
+
+#### Tác vụ phức tạp hoặc chưa rõ ràng
+
+```
+brainstorm → write-plan → execute-plan
+```
+
+Dùng khi yêu cầu chưa rõ hoặc có nhiều hướng tiếp cận khả thi.
+
+```
+# Bước 1 — khám phá và xác định thiết kế
+/brainstorm thêm chế độ dark mode
+
+# Agent làm rõ yêu cầu, đề xuất các hướng tiếp cận, tạo file:
+#   docs/brainstorms/260306-1430-dark-mode/SUMMARY.md
+# Sau đó hỏi: "Tiến hành write-plan không?"
+
+# Bước 2 — tạo kế hoạch triển khai theo giai đoạn
+/write-plan
+
+# Agent đọc brainstorm, tạo:
+#   docs/plans/260306-1445-dark-mode/SUMMARY.md
+#   docs/plans/260306-1445-dark-mode/phase-01-tokens.md
+#   docs/plans/260306-1445-dark-mode/phase-02-components.md
+# Kết thúc với: "Dùng /clear rồi /execute-plan docs/plans/... để thực thi"
+
+# Bước 3 — thực thi kế hoạch đã duyệt trong context mới
+/clear
+/execute-plan docs/plans/260306-1445-dark-mode/SUMMARY.md
+```
+
+---
+
+#### Tính năng rõ ràng hoặc refactor lớn
+
+```
+write-plan → execute-plan
+```
+
+Dùng khi task rõ ràng nhưng quá lớn hoặc có rủi ro để triển khai trực tiếp.
+
+```
+# Bước 1 — lên kế hoạch
+/write-plan chuyển đổi auth sang JWT
+
+# Agent tạo:
+#   docs/plans/260306-1020-jwt-auth/SUMMARY.md
+#   docs/plans/260306-1020-jwt-auth/phase-01-schema.md
+#   docs/plans/260306-1020-jwt-auth/phase-02-middleware.md
+# Kết thúc với: "Dùng /clear rồi /execute-plan docs/plans/... để thực thi"
+
+# Bước 2 — thực thi trong context mới
+/clear
+/execute-plan docs/plans/260306-1020-jwt-auth/SUMMARY.md
+```
+
+---
+
+#### Tác vụ nhỏ và sửa nhanh
+
+```
+quick-implement
+```
+
+Dùng cho các thay đổi nhỏ, phạm vi rõ ràng mà không cần kế hoạch chính thức.
+
+```
+# Triển khai trực tiếp — không cần kế hoạch
+/quick-implement thêm tooltip cho nút submit
+```
+
+---
+
+#### Sửa lỗi
+
+```
+fix
+```
+
+Dùng khi có lỗi cụ thể, test thất bại hoặc hành vi không mong muốn cần chẩn đoán.
+
+```
+/fix TypeError: Cannot read properties of undefined at checkout.ts:42
+
+# Lỗi đơn giản: agent chẩn đoán, áp dụng fix, kiểm tra
+# Lỗi phức tạp: agent dừng lại và chuyển sang write-plan
+```
+
+## Agent được hỗ trợ
+
+<details>
+<summary>Xem tất cả 39 agent được hỗ trợ</summary>
+
+AdaL, Amp, Antigravity, Augment, Claude Code, Cline, CodeBuddy, Codex, Command Code, Continue, Cortex Code, Crush, Cursor, Droid, Gemini CLI, GitHub Copilot, Goose, iFlow CLI, Junie, Kilo Code, Kimi Code CLI, Kiro CLI, Kode, MCPJam, Mistral Vibe, Mux, Neovate, OpenClaw, OpenCode, OpenHands, Pi, Pochi, Qoder, Qwen Code, Replit, Roo Code, Trae, Trae CN, Windsurf, Zencoder
+
+</details>
+
+## Yêu cầu
+
+- Node.js 18+
+- `git` có trong `PATH`
+- Kết nối mạng (để clone template từ GitHub)
+
+## Chạy lại trình cài đặt
+
+Chạy lại hoàn toàn an toàn. Việc chèn rules là idempotent — nội dung giữa các marker sẽ được thay thế mà không bị trùng lặp. Có thể thêm agent mới vào cài đặt hiện có bất cứ lúc nào.
+
+## Phát hành
+
+Các tag push khớp với `v*` sẽ kích hoạt GitHub Actions workflow `.github/workflows/release.yml` để tự động publish `@buiducnhat/agent-skills` lên npm.
+
+### Hướng dẫn cho maintainer
+
+```bash
+# 1) Tăng phiên bản CLI package
+cd packages/cli
+npm version <major|minor|patch>
+
+# 2) Push commit và tag
+git push origin main --follow-tags
+
+# 3) Theo dõi workflow
+# GitHub Actions → "Release CLI to npm"
+```
+
+**Điều kiện tiên quyết:**
+
+- Repository secret `NPM_TOKEN` có quyền publish lên `@buiducnhat/agent-skills`
+- Phiên bản trong `packages/cli/package.json` đã được tăng lên phiên bản chưa publish
+- Format tag là `vX.Y.Z`
+
+## Tài liệu
+
+- [Product PDR](docs/project-pdr.md)
+- [Kiến trúc](docs/architecture.md)
+- [Bản đồ Codebase](docs/codebase.md)
+- [Tiêu chuẩn Code](docs/code-standard.md)

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@buiducnhat/agent-skills",
-	"version": "0.5.0",
+	"version": "0.5.2",
 	"description": "Install AI agent workflow skills for coding assistants",
 	"type": "module",
 	"bin": {
@@ -31,19 +31,62 @@
 	"publishConfig": {
 		"access": "public"
 	},
+	"keywords": [
+		"cli",
+		"workflow",
+		"agent-skills",
+		"skills",
+		"ai-agents",
+		"amp",
+		"antigravity",
+		"augment",
+		"claude-code",
+		"openclaw",
+		"cline",
+		"codebuddy",
+		"codex",
+		"command-code",
+		"continue",
+		"cortex",
+		"crush",
+		"cursor",
+		"droid",
+		"gemini-cli",
+		"github-copilot",
+		"goose",
+		"junie",
+		"iflow-cli",
+		"kilo",
+		"kimi-cli",
+		"kiro-cli",
+		"kode",
+		"mcpjam",
+		"mistral-vibe",
+		"mux",
+		"opencode",
+		"openhands",
+		"pi",
+		"qoder",
+		"qwen-code",
+		"replit",
+		"roo",
+		"trae",
+		"trae-cn",
+		"windsurf",
+		"zencoder",
+		"neovate",
+		"pochi",
+		"adal",
+		"universal"
+	],
+	"homepage": "https://github.com/buiducnhat/agent-skills#readme",
+	"bugs": {
+		"url": "https://github.com/buiducnhat/agent-skills/issues"
+	},
 	"repository": {
 		"type": "git",
 		"url": "https://github.com/buiducnhat/agent-skills.git",
 		"directory": "packages/cli"
 	},
-	"keywords": [
-		"ai",
-		"agent",
-		"skills",
-		"workflow",
-		"claude",
-		"copilot",
-		"cursor"
-	],
 	"license": "MIT"
 }

package/README.md

@@ -1,32 +0,0 @@
-# @buiducnhat/agent-skills
-
-## Quick start
-
-### Run with npx
-
-```bash
-npx @buiducnhat/agent-skills
-```
-
-### Select agents non-interactively
-
-```bash
-npx @buiducnhat/agent-skills --agents claude,cursor,copilot
-```
-
-## CLI options
-
-- `--agents <list>`: comma-separated agent IDs (also enables non-interactive mode)
-- `--non-interactive`: skip prompts and use defaults
-- `-h, --help`: show help
-- `-v, --version`: show version
-
-## Requirements
-
-- Node.js `>=18`
-- `git` available in your environment
-
-## Repository
-
-- Source: https://github.com/buiducnhat/agent-skills
-- Issues: https://github.com/buiducnhat/agent-skills/issues