OpenSkillIndex← back to search
claude-code

AI-Agent-Toolkit intake

Skill: Intake

install
source · Clone the upstream repo
git clone https://github.com/ngapngap/AI-Agent-Toolkit
Claude Code · Install into ~/.claude/skills/
T=$(mktemp -d) && git clone --depth=1 https://github.com/ngapngap/AI-Agent-Toolkit "$T" && mkdir -p ~/.claude/skills && cp -r "$T/.agent/skills/intake" ~/.claude/skills/ngapngap-ai-agent-toolkit-intake && rm -rf "$T"
manifest: .agent/skills/intake/SKILL.md
source content

Skill: Intake

Mô tả

Skill này giúp thu thập requirements từ user một cách có cấu trúc, tránh việc AI đoán mò hoặc thiếu thông tin quan trọng khi triển khai. Đây là bước đầu tiên trong pipeline phát triển phần mềm.

Khi nào sử dụng

  • User mới đưa ý tưởng mơ hồ
  • Cần clarify requirements trước khi spec
  • Bắt đầu dự án mới
  • User không chắc họ cần gì chính xác

Workflow

Phase 1: Project Context

  1. Loại dự án: Web App, Mobile, API, CLI, Library, Desktop App
  2. Scale: MVP, Product, Enterprise
  3. Tech Stack mong muốn (nếu có)

Phase 2: Target Users

  1. Primary users: Ai là người dùng chính?
  2. Secondary users: Ai khác có thể dùng?
  3. User scenarios: Kịch bản sử dụng thực tế

Phase 3: Core Features

  1. Must-have features: Tính năng bắt buộc
  2. Nice-to-have features: Tính năng thêm nếu có thời gian
  3. Out of scope: Những gì KHÔNG cần làm

Phase 4: Constraints & Context

  1. Timeline: Deadline, milestones
  2. Budget/Resources: Giới hạn ngân sách
  3. Existing codebase: Có code sẵn không?
  4. Integrations: Cần tích hợp với gì?
  5. Deployment: Deploy ở đâu?

Phase 5: Summarize & Confirm

  1. Tổng hợp tất cả thông tin
  2. Liệt kê các câu hỏi còn mở
  3. Xác nhận với user trước khi chuyển qua phase tiếp theo

Output Format

File: 
output/intake/intake.md

# Intake: [Project Name]

## Project Overview
- **Type**: [Web App / Mobile / API / CLI / Library / Desktop]
- **Scale**: [MVP / Product / Enterprise]
- **Tech Stack**: [technologies]

## Target Users
### Primary User
- **Who**: [description]
- **Pain Points**: [what problems they have]
- **Goals**: [what they want to achieve]

### Secondary Users
- [list if any]

## Features

### Must-Have (P0)
1. [Feature 1]
   - Description: ...
   - Acceptance Criteria: ...
2. [Feature 2]
   - Description: ...
   - Acceptance Criteria: ...

### Nice-to-Have (P1)
1. [Feature]
   - Description: ...

### Out of Scope
- [What we explicitly won't do]

## Constraints
- **Timeline**: [estimate or deadline]
- **Budget**: [if relevant]
- **Tech Stack**: [required technologies]
- **Performance**: [SLA requirements if any]

## Existing Context
- **Codebase**: [Yes/No - details]
- **Design Files**: [Yes/No - details]
- **Documentation**: [Yes/No - details]

## Integrations
- [External service 1]
- [External service 2]

## Deployment
- **Environment**: [cloud/on-prem/hybrid]
- **Platform**: [AWS/GCP/Azure/Vercel/etc]

## Open Questions
1. [Question that needs clarification]
2. [Another open question]

## Next Steps
- [ ] Address open questions
- [ ] Proceed to Research phase
- [ ] Proceed to Spec phase

---
*Generated by Intake Skill | Date: [timestamp]*

Question Templates

Mở đầu

Để hiểu rõ yêu cầu của bạn, tôi cần hỏi một số câu hỏi.
Bạn có thể trả lời chi tiết hoặc "skip" nếu chưa chắc.

Về loại dự án

1. Đây là loại dự án gì?
   - Web Application (SPA, MPA, PWA)
   - Mobile App (iOS, Android, Cross-platform)
   - API/Backend Service
   - CLI Tool
   - Desktop Application
   - Library/Package
   - Other: [specify]

Về quy mô

2. Quy mô dự án như thế nào?
   - MVP (Minimum Viable Product) - Làm nhanh, test ý tưởng
   - Product - Sản phẩm hoàn chỉnh cho production
   - Enterprise - Hệ thống lớn, nhiều compliance

Về users

3. Ai sẽ dùng sản phẩm này?
   - Họ là ai? (developer, end-user, admin, ...)
   - Họ gặp vấn đề gì?
   - Họ muốn đạt được gì?

Về tính năng

4. Liệt kê các tính năng CHÍNH bạn cần:
   (Đánh số ưu tiên: P0 = bắt buộc, P1 = quan trọng, P2 = nice-to-have)

Về constraints

5. Có ràng buộc nào không?
   - Deadline cụ thể?
   - Tech stack bắt buộc?
   - Ngân sách giới hạn?
   - Yêu cầu performance/security đặc biệt?

Về existing context

6. Bạn đã có gì sẵn chưa?
   - Code/repo hiện tại?
   - Design files (Figma, Sketch, ...)?
   - API docs?
   - Database schema?

Integration với các Skills khác

Chuyển sang Research Skill

Khi intake hoàn tất, output 

intake.md
sẽ được dùng để:

  • Tìm kiếm repo mẫu phù hợp
  • Xác định patterns cần học hỏi
  • Tạo search queries cho GitHub

Chuyển sang Spec-Kit Skill

Intake cung cấp thông tin để:

  • Tạo feature specs chi tiết
  • Định nghĩa acceptance criteria
  • Phân chia tasks cho lanes

Quy tắc cho AI Agent

DO

  • Hỏi tuần tự, không hỏi quá nhiều cùng lúc
  • Cho phép user skip câu hỏi
  • Tổng hợp lại trước khi kết thúc
  • Lưu output vào file chuẩn

DON'T

  • Đừng đoán mò nếu thiếu thông tin
  • Đừng bắt đầu code trước khi intake xong
  • Đừng hỏi những thứ không liên quan
  • Đừng làm user cảm thấy bị "tra hỏi"

Lệnh thực thi

# Bắt đầu intake session
node ".agent/skills/intake/scripts/start-intake.js"

# Xem intake hiện tại
node ".agent/skills/intake/scripts/view-intake.js"

# Validate intake completeness
node ".agent/skills/intake/scripts/validate-intake.js"

Metrics đánh giá Intake Quality

MetricTiêu chuẩn
CompletenessĐủ thông tin để bắt đầu spec
ClarityKhông có mơ hồ, ai đọc cũng hiểu
ActionableCó thể chuyển thành tasks cụ thể
RealisticConstraints hợp lý, đạt được

Tham khảo