@neyugn/agent-kits 0.4.0 → 0.5.1

package/README.md

@@ -17,6 +17,7 @@
 
 <p align="center">
   <a href="#-quick-start">Quick Start</a> •
+  <a href="#-cli-commands">CLI Commands</a> •
   <a href="#-important-notes">Important Notes</a> •
   <a href="#-features">Features</a> •
   <a href="#-kits">Kits</a> •
@@ -60,6 +61,29 @@ That's it! The interactive installer will guide you through:
 
 <br/>
 
+## 🖥️ CLI Commands
+
+```bash
+npx @neyugn/agent-kits              # Start interactive setup wizard
+npx @neyugn/agent-kits --check-updates  # Check for new version
+npx @neyugn/agent-kits --version        # Show current version
+npx @neyugn/agent-kits --help            # Show help
+```
+
+**Example output when update is available:**
+
+```
+╭─────────────────────────╮
+│  agent-kits v0.5.0     │
+│  Latest:   v0.6.0      │
+╰─────────────────────────╯
+
+  ⚠ Update available! Run below to update:
+  npx @neyugn/agent-kits@latest
+```
+
+<br/>
+
 ## 📌 Important Notes
 
 ### Slash commands not appearing in IDE dropdown
@@ -81,36 +105,6 @@ If `.agent/` (or `.cursor/`, `.opencode/`, etc.) is listed in `.gitignore`, some
 
 <br/>
 
-### 🎯 One Command, Any Tool
-
-```bash
-npx @neyugn/agent-kits@latest
-```
-
-```
-  ╭──────────────────────────────────────────────────────────────────────────────╮
-  │                                                                          │
-  │        _     ____  _____  _   _  _____   _  __ ___  _____  ____          │
-  │       / \   / ___|| ____|| \ | ||_   _| | |/ /|_ _||_   _|/ ___|         │
-  │      / _ \ | |  _ |  _|  |  \| |  | |   | ' /  | |   | |  \___ \         │
-  │     / ___ \| |_| || |___ | |\  |  | |   | . \  | |   | |   ___) |        │
-  │    /_/   \_\\____||_____||_| \_|  |_|   |_|\_\|___|  |_|  |____/         │
-  │                                                                          │
-  │           ⚡  The Universal AI Agent Toolkit  ⚡                           │
-  │                                                                          │
-  ╰──────────────────────────────────────────────────────────────────────────────╯
-
-  SETUP WIZARD
-
-◆  🤖 Which AI assistant are you using?
-│  ● Antigravity (.agent/)
-│  ○ Cursor (.cursor/)
-
-◆  📂 Where should we install?
-│  ● Workspace (Project)
-│  ○ Global (System)
-```
-
 ### 🌍 Global vs Workspace Installation
 
 | Mode         | Location      | Use Case                       |
@@ -166,78 +160,69 @@ Works on **Windows**, **macOS**, and **Linux** with automatic path adaptation:
 
 <br/>
 
-## 🔍 Filter Skill
+## 🔍 Smart Filter (Workspace Analysis)
 
-The **Filter Skill** solves the "skill overload" problem by automatically detecting your project's techstack and enabling only relevant skills.
+The **Filter** feature is the "brain" of Agent Kits, ensuring your AI assistant stays sharp and focused. Instead of overwhelming the AI with dozens of irrelevant instructions (skills), the system automatically analyzes your workspace to enable only what’s necessary.
 
-### Usage
+### Why use Filtering?
 
-```bash
-/filter
-```
+As projects grow complex, providing too many instructions (System Prompts) to an AI can lead to:
+- **Context Bloat**: Makes AI prone to confusion and slower responses.
+- **Lost Focus**: AI might suggest patterns from one framework for another (e.g., suggesting Tailwind v4 patterns in a project using CSS Modules).
+- **Token Waste**: Sending redundant instructions increases API costs.
 
-### How It Works
+### How `/filter` Works
 
-| Phase                 | Description                                                                 |
-| --------------------- | --------------------------------------------------------------------------- |
-| **1. Detection**      | Scans for config files (`package.json`, `pubspec.yaml`, `Dockerfile`, etc.) |
-| **2. Recommendation** | Maps detected techstack to required skills                                  |
-| **3. Confirmation**   | Presents changes and asks about future techstack plans                      |
-| **4. Persistence**    | Saves profile to `.agent/profile.json`                                      |
+The system uses a multi-layered scanning mechanism to provide the best recommendations:
 
-### Example
+1.  **Techstack Detection**: Scans project identifiers (`package.json`, `go.mod`, `requirements.txt`, `composer.json`, `Cargo.toml`, etc.).
+2.  **Structural Analysis**: Checks for characteristic directories (`src/app` for Next.js App Router, `android/` for Mobile, etc.).
+3.  **Agent & Skill Mapping**: Matches the detected techstack against the Agent Kits library to select the most relevant Specialists (Agents) and capabilities (Skills).
+4.  **Profile Tuning**: Creates or updates a `.agent/profile.json` file to precisely configure what the AI can access.
+
+### Example Analysis Report
 
 ```markdown
-## 🔍 Workspace Analysis Complete
+## 🔍 Workspace Analysis: E-commerce Project (Next.js + NestJS)
 
 **Detected Techstack:**
-| Category | Technology |
-| --------- | ----------------------- |
-| Language | TypeScript |
-| Framework | Next.js 14 (App Router) |
-| Styling | Tailwind CSS v4 |
-| Database | PostgreSQL (Prisma) |
-
-**Skills to ENABLE:**
-| Skill | Reason |
-| ----------------- | ------------------------ |
-| react-patterns | Next.js detected |
-| tailwind-patterns | tailwind.config.js found |
-| postgres-patterns | Prisma + PostgreSQL |
+- Frontend: `Next.js 14`, `Tailwind CSS`, `Zustand`
+- Backend: `NestJS`, `PostgreSQL`, `Prisma`
+- DevOps: `Docker`, `GitHub Actions`
 
-**Skills to DISABLE:**
-| Skill | Reason |
-| ---------------- | ------------------------ |
-| flutter-patterns | No pubspec.yaml found |
-| mobile-design | No mobile setup detected |
+**✅ Activated Agents (Specialists):**
+- `frontend-specialist`: Optimized for Next.js and Tailwind.
+- `backend-specialist`: Expert in NestJS architecture.
+- `database-specialist`: Advanced Prisma query optimization.
+- `devops-engineer`: Manages Docker and CI/CD pipelines.
 
-**Questions:**
+**🧩 Loaded Skills:**
+- `react-patterns`, `tailwind-patterns`, `nodejs-best-practices`, `postgres-patterns`, `docker-patterns`.
 
-1. Do you agree with the changes? (yes/no/customize)
-2. Are there any techstacks you plan to add in the future?
+**🚫 Hidden Skills (To reduce noise):**
+- `flutter-patterns`, `mobile-design`, `aws-patterns` (Not used in this project).
 ```
 
-### Commands
+### Control Commands
 
 ```bash
-/filter                           # Analyze and filter skills
-/filter --force-enable ai-rag     # Force enable specific skill
-/filter --force-disable mobile    # Force disable specific skill
-/filter --reset                   # Reset to default (enable all)
+/filter                           # Re-scan workspace and auto-update
+/filter --force-enable ai-rag     # Always enable RAG skill regardless of techstack
+/filter --force-disable mobile    # Always disable mobile-related skills
+/filter --reset                   # Reset to default state (enable all)
 ```
 
-### Core Skills (Never Disabled)
+### Core Skills (Always Ready)
 
-These skills are always enabled regardless of techstack:
+Certain fundamental skills and core Agents are never disabled to maintain system-level reasoning:
 
-| Skill                   | Description                   |
-| ----------------------- | ----------------------------- |
-| `clean-code`            | Pragmatic coding standards    |
-| `brainstorming`         | Socratic questioning protocol |
-| `plan-writing`          | Task breakdown and WBS        |
-| `systematic-debugging`  | 4-phase debugging             |
-| `testing-patterns`      | Testing pyramid patterns      |
-| `security-fundamentals` | OWASP 2025 security           |
+| Skill | Value Proposition |
+| :--- | :--- |
+| `clean-code` | Ensures code is clean and maintainable. |
+| `brainstorming` | Activates Socratic reasoning for complex problem solving. |
+| `plan-writing` | Detailed planning before any code implementation. |
+| `systematic-debugging` | 4-step evidence-based debugging process. |
+| `security-fundamentals` | OWASP 2025 compliant security checks. |
 
 <br/>
 

package/README.vi.md

@@ -51,6 +51,29 @@ npx @neyugn/agent-kits@latest
 
 <br/>
 
+## 🖥️ Các lệnh CLI
+
+```bash
+npx @neyugn/agent-kits                  # Khởi động installer tương tác
+npx @neyugn/agent-kits --check-updates  # Kiểm tra phiên bản mới
+npx @neyugn/agent-kits --version        # Hiện phiên bản hiện tại
+npx @neyugn/agent-kits --help           # Hiện trợ giúp
+```
+
+**Ví dụ output khi có phiên bản mới:**
+
+```
+╭─────────────────────────╮
+│  agent-kits v0.5.0     │
+│  Latest:   v0.6.0      │
+╰─────────────────────────╯
+
+  ⚠ Update available! Run below to update:
+  npx @neyugn/agent-kits@latest
+```
+
+<br/>
+
 ## 📌 Lưu ý quan trọng
 
 ### Slash commands không hiện trong dropdown của IDE
@@ -68,47 +91,17 @@ Nếu `.agent/` (hoặc `.cursor/`, `.opencode/`, v.v.) bị thêm vào `.gitign
 !.agent/workflows/**
 ```
 
-> **Khuyến nghị:** Xóa thư mục kit khỏi `.gitignore` và commit nó vào repo. Đây là cách tiếp cận được khuyến nghị cho cài đặt workspace.
+> **Khuyến nghị:** Xóa thư mục kit khỏi `.gitignore` và commit nó cùng với code của bạn.
 
 <br/>
 
 ## ✨ Tính năng
 
-### 🎯 Một lệnh, mọi công cụ
-
-```bash
-npx @neyugn/agent-kits@latest
-```
-
-```
-  ╭──────────────────────────────────────────────────────────────────────────────╮
-  │                                                                          │
-  │        _     ____  _____  _   _  _____   _  __ ___  _____  ____          │
-  │       / \   / ___|| ____|| \ | ||_   _| | |/ /|_ _||_   _|/ ___|         │
-  │      / _ \ | |  _ |  _|  |  \| |  | |   | ' /  | |   | |  \___ \         │
-  │     / ___ \| |_| || |___ | |\  |  | |   | . \  | |   | |   ___) |        │
-  │    /_/   \_\\____||_____||_| \_|  |_|   |_|\_\|___|  |_|  |____/         │
-  │                                                                          │
-  │           ⚡  The Universal AI Agent Toolkit  ⚡                           │
-  │                                                                          │
-  ╯──────────────────────────────────────────────────────────────────────────────╯
-
-  SETUP WIZARD
-
-◆  🤖 Bạn đang sử dụng công cụ AI nào?
-│  ● Antigravity (.agent/)
-│  ○ Cursor (.cursor/)
-
-◆  📂 Bạn muốn cài đặt ở đâu?
-│  ● Workspace (Dự án hiện tại)
-│  ○ Global (Tất cả dự án)
-```
-
 ### 🌍 Global vs Workspace
 
 | Chế độ      | Vị trí        | Use Case                      |
 | ----------- | ------------- | ----------------------------- |
-| � Workspace | `./{{tool}}/` | Cấu hình riêng cho từng dự án |
+| 📁 Workspace | `./{{tool}}/` | Cấu hình riêng cho từng dự án |
 | 🌍 Global   | `~/{{tool}}/` | Dùng chung cho tất cả dự án   |
 
 **Đường dẫn Global theo công cụ:**
@@ -157,35 +150,69 @@ Hoạt động trên **Windows**, **macOS**, và **Linux** với đường dẫn
 
 <br/>
 
-## 🔍 Filter Skill (Tính năng lọc Skills)
+## 🔍 Tính năng Filter thông minh (Phân tích Workspace)
 
-**Filter Skill** giải quyết vấn đề "quá tải skills" bằng cách tự động phát hiện techstack của dự án và chỉ bật các skills liên quan.
+Tính năng **Filter** là "trái tim" giúp Agent Kits trở nên mạnh mẽ và thông minh. Thay vì bắt AI phải đọc hàng chục file hướng dẫn (skills) không liên quan, hệ thống sẽ tự động phân tích workspace của bạn để bật đúng những gì cần thiết.
 
-### Cách sử dụng
+### Tại sao cần Filter?
 
-```bash
-/filter
-```
+Khi một dự án trở nên phức tạp, việc cung cấp quá nhiều chỉ dẫn (System Prompt) cho AI sẽ dẫn đến:
+- **Quá tải ngữ cảnh (Context Bloat)**: Khiến AI dễ bị nhầm lẫn và phản hồi chậm.
+- **Mất tập trung**: AI có thể gợi ý các pattern của framework này cho framework khác (ví dụ gợi ý Tailwind trong dự án đang dùng CSS Modules).
+- **Tốn token**: Gửi các instruction dư thừa làm tăng chi phí sử dụng API.
 
-### Quy trình hoạt động
+### Cơ chế hoạt động của `/filter`
 
-| Phase            | Mô tả                                                                     |
-| ---------------- | ------------------------------------------------------------------------- |
-| **1. Phát hiện** | Quét các file config (`package.json`, `pubspec.yaml`, `Dockerfile`, etc.) |
-| **2. Đề xuất**   | Map techstack đã phát hiện với các skills cần thiết                       |
-| **3. Xác nhận**  | Hiển thị thay đổi và hỏi về kế hoạch techstack tương lai                  |
-| **4. Lưu trữ**   | Lưu profile vào `.agent/profile.json`                                     |
+Hệ thống sử dụng cơ chế quét đa tầng để đưa ra đề xuất tối ưu nhất:
 
-### Ví dụ
+1.  **Phát hiện Techstack**: Quét các file định danh dự án (`package.json`, `go.mod`, `requirements.txt`, `composer.json`, `Cargo.toml`, v.v.).
+2.  **Phân tích Cấu trúc**: Kiểm tra sự hiện diện của các thư mục đặc trưng (`src/app` cho Next.js App Router, `android/` cho Mobile, v.v.).
+3.  **Lập bản đồ Agent & Skill**: Đối chiếu techstack với kho dữ liệu Agent Kits để chọn ra các chuyên gia (Agents) và kỹ năng (Skills) phù hợp nhất.
+4.  **Tinh chỉnh Profile**: Tạo hoặc cập nhật file `.agent/profile.json` để cấu hình chính xác những gì AI được phép truy cập.
+
+### Ví dụ về báo cáo phân tích
 
 ```markdown
-## 🔍 Phân tích Workspace hoàn tất
+## 🔍 Phân tích Workspace: Dự án E-commerce (Next.js + NestJS)
+
+**Techstack được phát hiện:**
+- Frontend: `Next.js 14`, `Tailwind CSS`, `Zustand`
+- Backend: `NestJS`, `PostgreSQL`, `Prisma`
+- DevOps: `Docker`, `GitHub Actions`
+
+**✅ Các Agent được kích hoạt (Specialists):**
+- `frontend-specialist`: Tối ưu cho Next.js và Tailwind.
+- `backend-specialist`: Am hiểu cấu trúc NestJS.
+- `database-specialist`: Hỗ trợ tối ưu Prisma queries.
+- `devops-engineer`: Quản lý Docker và CI/CD.
+
+**🧩 Các Skill được load:**
+- `react-patterns`, `tailwind-patterns`, `nodejs-best-practices`, `postgres-patterns`, `docker-patterns`.
+
+**🚫 Các Skill bị ẩn (Để giảm nhiễu):**
+- `flutter-patterns`, `mobile-design`, `aws-patterns` (Dự án không sử dụng).
+```
+
+### Các lệnh điều khiển
+
+```bash
+/filter                           # Quét lại workspace và tự động cập nhật
+/filter --force-enable ai-rag     # Luôn bật skill RAG bất kể techstack
+/filter --force-disable mobile    # Luôn tắt các skill liên quan đến mobile
+/filter --reset                   # Quay lại trạng thái mặc định (bật tất cả)
+```
+
+### Core Skills (Luôn luôn sẵn sàng)
+
+Một số kỹ năng nền tảng và Agent cốt lõi sẽ không bao giờ bị tắt để đảm bảo khả năng tư duy hệ thống:
 
-**Techstack đã phát hiện:**
-| Danh mục | Công nghệ |
-| --------- | ----------------------- |
-| Ngôn ngữ | TypeScript |
-| Framework | Next.js 14 (App Router) |
+| Skill | Giá trị mang lại |
+| :--- | :--- |
+| `clean-code` | Đảm bảo code sạch, dễ bảo trì. |
+| `brainstorming` | Kích hoạt tư duy Socratic để giải quyết vấn đề phức tạp. |
+| `plan-writing` | Lập kế hoạch chi tiết trước khi bắt đầu viết code. |
+| `systematic-debugging` | Quy trình gỡ lỗi 4 bước có bằng chứng rõ ràng. |
+| `security-fundamentals` | Kiểm tra bảo mật theo tiêu chuẩn OWASP 2025. |
 | Styling | Tailwind CSS v4 |
 | Database | PostgreSQL (Prisma) |
 

package/README.zh.md

@@ -51,6 +51,29 @@ npx @neyugn/agent-kits@latest
 
 <br/>
 
+## 🖥️ CLI 命令
+
+```bash
+npx @neyugn/agent-kits              # 启动交互式安装向导
+npx @neyugn/agent-kits --check-updates  # 检查新版本
+npx @neyugn/agent-kits --version        # 显示当前版本
+npx @neyugn/agent-kits --help           # 显示帮助
+```
+
+**有新版本时的输出示例：**
+
+```
+╭─────────────────────────╮
+│  agent-kits v0.5.0     │
+│  Latest:   v0.6.0      │
+╰─────────────────────────╯
+
+  ⚠ Update available! Run below to update:
+  npx @neyugn/agent-kits@latest
+```
+
+<br/>
+
 ## 📌 重要说明
 
 ### IDE 下拉菜单中不显示斜杠命令
@@ -68,42 +91,12 @@ npx @neyugn/agent-kits@latest
 !.agent/workflows/**
 ```
 
-> **推荐：** 将 kit 文件夹从 `.gitignore` 中完全移除并提交它。这是工作区安装的推荐做法。
+> **推荐：** 将 kit 文件夹从 `.gitignore` 中完全移除并提交它。
 
 <br/>
 
 ## ✨ 功能特性
 
-### 🎯 一条命令，任何工具
-
-```bash
-npx @neyugn/agent-kits@latest
-```
-
-```
-  ╭──────────────────────────────────────────────────────────────────────────────╮
-  │                                                                          │
-  │        _     ____  _____  _   _  _____   _  __ ___  _____  ____          │
-  │       / \   / ___|| ____|| \ | ||_   _| | |/ /|_ _||_   _|/ ___|         │
-  │      / _ \ | |  _ |  _|  |  \| |  | |   | ' /  | |   | |  \___ \         │
-  │     / ___ \| |_| || |___ | |\  |  | |   | . \  | |   | |   ___) |        │
-  │    /_/   \_\\____||_____||_| \_|  |_|   |_|\_\|___|  |_|  |____/         │
-  │                                                                          │
-  │           ⚡  The Universal AI Agent Toolkit  ⚡                           │
-  │                                                                          │
-  ╯──────────────────────────────────────────────────────────────────────────────╯
-
-  SETUP WIZARD
-
-◆  🤖 您正在使用哪个 AI 工具？
-│  ● Antigravity (.agent/)
-│  ○ Cursor (.cursor/)
-
-◆  📂 您想安装在哪里？
-│  ● Workspace（当前项目）
-│  ○ Global（所有项目）
-```
-
 ### 🌍 Global vs Workspace 安装
 
 | 模式         | 位置          | 使用场景     |
@@ -141,7 +134,6 @@ npx @neyugn/agent-kits@latest
 | Claude Code | `.claude/skills/` | `~/.claude/` | 🔜 即将推出 |
 | Gemini CLI  | `.gemini/skills/` | `~/.gemini/` | 🔜 即将推出 |
 | Codex CLI   | `.codex/skills/`  | `~/.codex/`  | 🔜 即将推出 |
-| 自定义      | 可配置            | `~/.ai/`     | 🔜 即将推出 |
 
 > **注意：** 标记为 🔜 即将推出的工具已纳入未来版本计划。基础架构已就绪，但这些工具需要额外的测试和配置。
 
@@ -157,78 +149,69 @@ npx @neyugn/agent-kits@latest
 
 <br/>
 
-## 🔍 Filter Skill（技能过滤功能）
+## 🔍 智能过滤功能 (工作区分析)
 
-**Filter Skill** 通过自动检测项目的技术栈并只启用相关技能来解决"技能过载"问题。
+**Filter** 功能是 Agent Kits 的 "大脑"，旨在确保您的 AI 助手始终保持敏锐和专注。系统会自动分析您的工作区，仅启用必要的技能，而不是让 AI 处理数十个无关的指令（技能）。
 
-### 使用方法
+### 为什么需要过滤？
 
-```bash
-/filter
-```
+随着项目的复杂化，向 AI 提供过多的指令（系统提示词）会导致：
+- **上下文膨胀 (Context Bloat)**：导致 AI 容易混淆且响应变慢。
+- **注意力分散**：AI 可能会推荐一种框架的模式到另一种框架中（例如在正在使用 CSS Modules 的项目中推荐 Tailwind v4 模式）。
+- **Token 浪费**：发送冗余指令会增加 API 使用成本。
+
+### `/filter` 的工作机制
 
-### 工作原理
+系统采用多层扫描机制来提供最佳建议：
 
-| 阶段          | 描述                                                            |
-| ------------- | --------------------------------------------------------------- |
-| **1. 检测**   | 扫描配置文件（`package.json`、`pubspec.yaml`、`Dockerfile` 等） |
-| **2. 推荐**   | 将检测到的技术栈映射到所需技能                                  |
-| **3. 确认**   | 显示更改并询问未来的技术栈计划                                  |
-| **4. 持久化** | 将配置保存到 `.agent/profile.json`                              |
+1.  **技术栈检测**：扫描项目标识文件（`package.json`、`go.mod`、`requirements.txt`、`composer.json`、`Cargo.toml` 等）。
+2.  **结构分析**：检查特征目录（如 Next.js App Router 的 `src/app`、移动端的 `android/` 等）。
+3.  **代理与技能映射**：将检测到的技术栈与 Agent Kits 库进行对比，选出最相关的专家级代理 (Agents) 和核心能力 (Skills)。
+4.  **配置文件优化**：创建或更新 `.agent/profile.json` 文件，精准配置 AI 可以访问的内容。
 
-### 示例
+### 分析报告示例
 
 ```markdown
-## 🔍 工作区分析完成
+## 🔍 工作区分析：电商项目 (Next.js + NestJS)
 
 **检测到的技术栈：**
-| 类别 | 技术 |
-| --------- | ----------------------- |
-| 语言 | TypeScript |
-| 框架 | Next.js 14 (App Router) |
-| 样式 | Tailwind CSS v4 |
-| 数据库 | PostgreSQL (Prisma) |
-
-**建议启用的技能：**
-| 技能 | 原因 |
-| ----------------- | ------------------------ |
-| react-patterns | 检测到 Next.js |
-| tailwind-patterns | 发现 tailwind.config |
-| postgres-patterns | Prisma + PostgreSQL |
-
-**建议禁用的技能：**
-| 技能 | 原因 |
-| ---------------- | ------------------------ |
-| flutter-patterns | 未找到 pubspec.yaml |
-| mobile-design | 未检测到移动端配置 |
-
-**问题：**
-
-1. 您是否同意上述更改？（是/否/自定义）
-2. 您是否计划在未来添加其他技术栈？
+- 前端：`Next.js 14`, `Tailwind CSS`, `Zustand`
+- Backend: `NestJS`, `PostgreSQL`, `Prisma`
+- 运维：`Docker`, `GitHub Actions`
+
+**✅ 已启用的代理 (Specialists)：**
+- `frontend-specialist`：针对 Next.js 和 Tailwind 进行了优化。
+- `backend-specialist`：精通 NestJS 架构。
+- `database-specialist`：支持 Prisma 查询优化。
+- `devops-engineer`：管理 Docker 和 CI/CD 流程。
+
+**🧩 已加载的技能：**
+- `react-patterns`, `tailwind-patterns`, `nodejs-best-practices`, `postgres-patterns`, `docker-patterns`
+
+**🚫 已隐藏的技能 (减少噪音)：**
+- `flutter-patterns`, `mobile-design`, `aws-patterns` (本项目未使用)
 ```
 
-### 命令
+### 控制命令
 
 ```bash
-/filter                           # 分析并过滤技能
-/filter --force-enable ai-rag     # 强制启用特定技能
-/filter --force-disable mobile    # 强制禁用特定技能
-/filter --reset                   # 重置为默认（启用全部）
+/filter                           # 重新扫描工作区并自动更新
+/filter --force-enable ai-rag     # 强制启用 RAG 技能（无论技术栈如何）
+/filter --force-disable mobile    # 强制禁用移动端相关技能
+/filter --reset                   # 重置为初始状态（启用全部）
 ```
 
-### 核心技能（永不禁用）
+### 核心技能 (始终就绪)
 
-无论技术栈如何，这些技能始终启用：
+某些基础技能和核心代理将永远不会被禁用，以确保系统级的逻辑思考能力：
 
-| 技能                    | 描述               |
-| ----------------------- | ------------------ |
-| `clean-code`            | 实用编码标准       |
-| `brainstorming`         | 苏格拉底式提问协议 |
-| `plan-writing`          | 任务分解和 WBS     |
-| `systematic-debugging`  | 4阶段调试          |
-| `testing-patterns`      | 测试金字塔模式     |
-| `security-fundamentals` | OWASP 2025 安全    |
+| 技能 | 核心价值 |
+| :--- | :--- |
+| `clean-code` | 确保代码整洁且易于维护。 |
+| `brainstorming` | 激活苏格拉底式思维以解决复杂问题。 |
+| `plan-writing` | 在执行任何代码之前进行详细规划。 |
+| `systematic-debugging` | 基于证据的 4 步骤系统化调试流程。 |
+| `security-fundamentals` | 符合 OWASP 2025 标准的安全检查。 |
 
 <br/>
 
@@ -327,8 +310,6 @@ npx @neyugn/agent-kits@latest
 | `/orchestrate`   | 多代理协调             |
 | `/ui-ux-pro-max` | UI/UX 设计智能         |
 
-> **注意：** `/filter` 命令属于 **Common Skills Layer**（见下文），在所有工具包中可用。
-
 </details>
 
 ### 🔜 即将推出