One-Toolkit

CLI hỗ trợ phát triển phần mềm với AI theo quy trình có cấu trúc.

Tính năng

• 🎯 Quy trình 5 giai đoạn: Requirements → Design → Planning → Implementation → Testing
• 🤖 Hỗ trợ nhiều AI Tools: Cursor, Antigravity (Google), Claude Code, GitHub Copilot...
• 🇻🇳 Tiếng Việt: Templates và thông báo bằng tiếng Việt với flag --vi
• � Cấu trúc chuẩn: Tự động tạo docs/agent/ với templates cho từng giai đoạn
• ⚡ Slash Commands: Các lệnh tắt để tương tác với AI

Cài đặt

# Dùng npx (không cần cài)
npx one-toolkit init

# Hoặc cài global
npm install -g one-toolkit

Bắt đầu nhanh

# Khởi tạo đầy đủ với tiếng Việt
one-toolkit init --all --vi

# Hoặc chọn môi trường cụ thể
one-toolkit init -e cursor --all
one-toolkit init -e antigravity --all --vi

Cấu trúc sau khi khởi tạo

your-project/
├── .one-toolkit.json         # File cấu hình
├── AGENTS.md                 # Context rules cho AI
├── .cursor/                  # (nếu chọn Cursor)
│   ├── commands/             # Slash commands
│   └── rules/                # Coding rules
├── .agent/                   # (nếu chọn Antigravity)
│   └── workflows/            # Workflows
└── docs/agent/
    ├── requirements/         # Thu thập yêu cầu
    ├── design/               # Thiết kế hệ thống
    ├── planning/             # Lập kế hoạch
    ├── implementation/       # Hướng dẫn triển khai
    └── testing/              # Chiến lược kiểm thử

Các giai đoạn phát triển

| Giai đoạn | Mô tả | |-----------|-------| | Requirements | Thu thập yêu cầu, user stories, tiêu chí thành công | | Design | Thiết kế kiến trúc, data models, API design | | Planning | Phân chia tasks, milestones, timeline | | Implementation | Ghi chú triển khai, patterns, xử lý lỗi | | Testing | Chiến lược test, coverage, test cases |

Slash Commands

Sử dụng trong Cursor hoặc Antigravity:

| Command | Mô tả | |---------|-------| | /new-requirement | Bắt đầu feature mới | | /execute-plan | Thực thi kế hoạch từng task | | /code-review | Review code trước khi push | | /writing-test | Viết tests | | /debug | Debug vấn đề | | /update-planning | Cập nhật kế hoạch | | /check-implementation | Kiểm tra triển khai | | /review-design | Review thiết kế | | /review-requirements | Review yêu cầu | | /capture-knowledge | Ghi lại kiến thức |

AI Environments được hỗ trợ

| Environment | Trạng thái | Command Path | |-------------|------------|--------------| | Cursor | ✅ Full | .cursor/commands/ | | Antigravity (Google) | ✅ Full | .agent/workflows/ | | Claude Code | ✅ Full | .claude/commands/ | | GitHub Copilot | ✅ | .github/prompts/ | | Google Gemini CLI | ✅ | .gemini/ | | Windsurf | 🚧 Testing | - | | KiloCode | 🚧 Testing | - | | AMP | 🚧 Testing | - |

CLI Commands

one-toolkit init

Khởi tạo toolkit trong project.

# Interactive mode
one-toolkit init

# Đầy đủ với tiếng Việt
one-toolkit init --all --vi

# Chọn môi trường
one-toolkit init -e cursor --all
one-toolkit init -e antigravity --all

# Chọn phases cụ thể
one-toolkit init -p requirements,design,planning

Options:

• -e, --environment <env>: Môi trường AI (cursor, antigravity, claude...)
• -a, --all: Khởi tạo tất cả phases
• -p, --phases <phases>: Danh sách phases (comma-separated)
• --vi: Sử dụng templates tiếng Việt

one-toolkit phase [name]

Thêm phase template mới.

one-toolkit phase requirements
one-toolkit phase testing

Quy trình làm việc

1. Khởi tạo: one-toolkit init --all --vi
2. Bắt đầu feature: Gõ /new-requirement trong AI chat
3. Review yêu cầu: /review-requirements
4. Thiết kế: Điền docs/agent/design/feature-*.md
5. Lập kế hoạch: /update-planning
6. Thực thi: /execute-plan
7. Viết tests: /writing-test
8. Review code: /code-review

File cấu hình

.one-toolkit.json:

{
  "version": "0.4.2",
  "initializedPhases": [
    "requirements",
    "design",
    "planning",
    "implementation",
    "testing"
  ],
  "environments": ["cursor", "antigravity"]
}

Development

# Clone repo
git clone https://github.com/nhh0718/one-toolkit.git
cd one-toolkit

# Cài dependencies
npm install

# Build
npm run build

# Test locally
npm link
one-toolkit --help

License

MIT

Happy coding with AI! 🚀

Quick Reference

| Task | Command | |------|---------| | Khởi tạo đầy đủ | npx one-toolkit init --all --vi | | Chọn Cursor | npx one-toolkit init -e cursor --all | | Thêm phase | one-toolkit phase testing | | Bắt đầu feature | /new-requirement | | Thực thi kế hoạch | /execute-plan | | Viết tests | /writing-test | | Help | one-toolkit --help |