Skip to content
Back to search

aidd

MarketplaceWorks with Claude CodeGitHubIncomplete

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today
Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/soxxam--aidd/badge.svg)](/listings/soxxam--aidd)

HTML

<a href="/listings/soxxam--aidd"><img src="/api/listings/soxxam--aidd/badge.svg" alt="findsafeskills safety rating" /></a>

Install

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

.claude-plugin/marketplace.json · Manifest · 13 lines
  1. {
  2. "name": "aidd",
  3. "owner": { "name": "soxxam" },
  4. "metadata": { "description": "AIDD — AI-Driven Development theo SDLC cho Claude Code" },
  5. "plugins": [
  6. {
  7. "name": "aidd",
  8. "source": "./plugins/aidd",
  9. "description": "SDLC thành lệnh: bộ luật NFR, observability, CI bảo mật → PRD, thiết kế, hợp đồng schema/API, lát cắt → audit OWASP/hiệu năng → EXPLAIN, k6, cổng DoD → pipeline CI/CD 5 giai đoạn có auto-rollback",
  10. "version": "0.3.0"
  11. }
  12. ]
  13. }
README.md · README · 238 lines
  1. # AIDD — AI-Driven Development cho Claude Code
  2. Đưa quy trình SDLC vào Claude Code để AI code có kỷ luật thay vì "vibe coding".
  3. **Bạn** làm Architect & Reviewer. **Claude** làm Dev & QA.
  4. ```mermaid
  5. flowchart LR
  6. subgraph S0["0 · Setup (1 lần)"]
  7. I["/aidd:init"] --> R["/aidd:rules"] --> O["/aidd:observe"] --> C["/aidd:secure-ci"]
  8. end
  9. subgraph S1["1 · Build (mỗi tính năng)"]
  10. P["/aidd:prd"] --> D["/aidd:design"] --> K["/aidd:contract"] --> SL["/aidd:slice"] --> RV["/aidd:review"]
  11. RV -->|còn lát| SL
  12. end
  13. subgraph S2["2 · Audit (phiên mới)"]
  14. AS["/aidd:audit-security"] --> AP["/aidd:audit-perf"] --> F["/aidd:fix"]
  15. end
  16. subgraph S3["3 · Verify (trước merge)"]
  17. CI["/aidd:ci-fix"] --> E["/aidd:explain"] --> L["/aidd:loadtest"] --> V["/aidd:verify"]
  18. end
  19. S0 --> S1 --> S2 --> S3
  20. V -->|CHƯA ĐẠT| F
  21. V -->|ĐẠT| SH["/aidd:ship"] --> RCA["/aidd:rca"]
  22. ```
  23. ### Giai đoạn 0: Setup "bộ luật" (một lần)
  24. | Lệnh | Claude làm | Đầu ra |
  25. |---|---|---|
  26. | `/aidd:init` | Khảo sát dự án, tạo khung tài liệu, thêm mục AIDD vào `CLAUDE.md` | `docs/aidd/`, `CLAUDE.md` |
  27. | `/aidd:rules` | Ràng buộc cứng gắn với stack thật, gồm 3 nhóm. **Bảo mật:** JWT, RBAC/ABAC ở tầng Service, chống IDOR, validate DTO, cấm hardcode secret, parameterized query, rate limit. **Hiệu năng:** index trong schema, cấm N+1 và `SELECT *`, phân trang, queue. **Chịu lỗi:** idempotency key, locking, timeout + retry có backoff. Kèm danh sách vi phạm hiện có | `docs/rules/{security,performance,resilience}.md`, mục Ràng buộc cứng |
  28. | `/aidd:observe` | Log JSON kèm `trace_id`, metrics Prometheus/OpenTelemetry, trace W3C, health và readiness | cấu hình log và metrics, `docs/rules/observability.md` |
  29. | `/aidd:secure-ci` | Pipeline có **Gitleaks** (secret), **Semgrep/SonarQube** (SAST), **Trivy** (image, dependency, IaC), test và build. Hỏi nền tảng: GitHub, GitLab hay Jenkins | file CI |
  30. ### Giai đoạn 1: Thiết kế và sinh mã (mỗi tính năng)
  31. | Lệnh | Claude làm | Đầu ra |
  32. |---|---|---|
  33. | `/aidd:prd <ý tưởng>` | Hỏi lại, phản biện, viết user story + tiêu chí nghiệm thu (AC) | `docs/features/<slug>/PRD.md` |
  34. | `/aidd:design <slug>` | Mermaid, ADR, chia lát cắt dọc | `DESIGN.md`, `PLAN.md`, `docs/adr/` |
  35. | `/aidd:contract <slug>` | **Chốt dữ liệu trước khi code:** `SCHEMA.sql` có index cho mọi truy vấn, `API_SPEC.yaml` có phân trang, lỗi, bảo mật, idempotency | `docs/contracts/` |
  36. | `/aidd:slice <slug>` | Plan mode → chờ bạn duyệt → code DB → BE → FE, kèm test cho từng AC, theo `docs/rules` | code, test, tick `PLAN.md` |
  37. | `/aidd:review` | Review nhanh sau mỗi lát, bằng subagent chỉ có quyền đọc | bảng phát hiện |
  38. ### Giai đoạn 2: Phản biện chéo (Red Team, phiên mới)
  39. | Lệnh | Claude làm | Đầu ra |
  40. |---|---|---|
  41. | `/aidd:audit-security <slug>` | Subagent `security-auditor` rà theo OWASP: IDOR, lộ dữ liệu, validate, injection, SSRF, CORS, Dockerfile, secret | `docs/features/<slug>/AUDIT.md` |
  42. | `/aidd:audit-perf <slug>` | Subagent `perf-auditor` giả định 10 triệu dòng và 1.000 CCU: N+1, thiếu index, lock contention, race condition, cache, connection pool | `AUDIT.md` + top 5 điểm dễ sập |
  43. | `/aidd:fix <slug>` | Với mỗi phát hiện: test đỏ → sửa ở gốc → xanh → cập nhật trạng thái | code, test, `AUDIT.md` |
  44. ### Giai đoạn 3: Kiểm chứng bằng số liệu (trước khi merge)
  45. | Lệnh | Claude làm | Đầu ra |
  46. |---|---|---|
  47. | `/aidd:ci-fix <log>` | Đọc log Gitleaks, Semgrep, Trivy hay test đang đỏ rồi sửa tới khi xanh. Không tắt rule, không hạ ngưỡng | code, ngoại lệ có lý do |
  48. | `/aidd:explain <slug>` | Seed dữ liệu lớn, chạy `EXPLAIN (ANALYZE, BUFFERS)`, chỉnh index hoặc truy vấn, so trước và sau | `perf/seed/`, `perf/explain/`, migration |
  49. | `/aidd:loadtest <slug>` | Script **k6** theo traffic thật, ngưỡng p95/p99 và error rate, đọc kèm metrics | `perf/k6/`, `AUDIT.md` |
  50. | `/aidd:verify <slug>` | Cổng **Definition of Done**: đủ bằng chứng cho cả 4 bước thì ĐẠT, thiếu thì CHƯA ĐẠT kèm việc còn lại | `AUDIT.md` |
  51. ### Pipeline CI/CD (5 giai đoạn)
  52. Dựng toàn bộ bằng `/aidd:pipeline [github|gitlab|jenkins] [k8s|argocd|compose]`, hoặc dựng từng phần:
  53. | # | Giai đoạn | Lệnh | Claude làm | Chặn khi |
  54. |---|---|---|---|---|
  55. | 1 | Pre-commit & PR | `/aidd:precommit` | Hook dưới 1 phút: Gitleaks trên phần staged, formatter + linter (ESLint, Prettier, Spotless/Checkstyle, Ruff) theo `CLAUDE.md`, chặn commit vào main/develop | lộ secret, sai convention |
  56. | | | `/aidd:pr [--protect]` | Nhánh `feat/…`, mô tả PR (thay đổi, **bảng DB bị đụng**, migration, **breaking change**, dependency, test, rollback), mở PR bằng `gh`/`glab` khi bạn đồng ý, bật branch protection | push thẳng main, PR chưa duyệt |
  57. | 2 | Build & Test | `/aidd:ci-test` | Compile, kiểm dependency (xung đột, **package không có thật**), unit + integration bằng **Testcontainers**, coverage gate ≥ 75% tầng service | lỗi build hoặc test, coverage tụt |
  58. | | | `/aidd:migration-check` | Dry-run migration trên DB bản sao có dữ liệu, có `lock_timeout`; bắt thao tác khoá bảng và thay đổi phá rolling update | migration lỗi hoặc khoá bảng |
  59. | 3 | DevSecOps | `/aidd:secure-ci` | SAST (Semgrep/Sonar), **SCA**, Dockerfile multi-stage, Trivy image và IaC | HIGH/CRITICAL |
  60. | | | `/aidd:ci-fix <log>` | **Vòng tự sửa:** "Pipeline failed ở bước X… phân tích nguyên nhân gốc, sửa mà không hỏng test hiện có", lặp tới khi xanh | – |
  61. | 4 | Staging & Perf | `/aidd:smoke` | Script gọi health/readiness và các luồng sống còn, fail trong vài chục giây | một bước đỏ |
  62. | | | `/aidd:perf-gate` | Chạy k6, so p95/p99/lỗi với **baseline bản trước** (`compare.mjs`) | **p95 tăng > 20%**, lỗi > 1% |
  63. | 5 | Production | `/aidd:release` | **Duyệt tay** + rolling, blue/green hoặc **canary 5–10%** (Argo Rollouts); migration expand/contract; image bất biến | chưa duyệt |
  64. | | | `/aidd:rollback` | Theo dõi 5–15 phút (5xx, p95, restart, health). Vượt ngưỡng thì **tự rollback** về image trước và cảnh báo Slack/Telegram kèm `trace_id` | 5xx > 1%, health fail |
  65. | Giai đoạn | Công cụ tiêu chuẩn | Vai trò của AI | Vai trò của bạn (Tech Lead) |
  66. |---|---|---|---|
  67. | 1. Pre-commit & PR | Gitleaks, linter, GitHub/GitLab | Viết code, tự format, tóm tắt PR | Review diff, kiểm logic nghiệp vụ |
  68. | 2. Build & Test | Docker, Testcontainers, JUnit/Pytest | Viết test, sửa lỗi compile | Duyệt các test case biên |
  69. | 3. Security Gate | Semgrep, SonarQube, Trivy | Đọc báo cáo lỗ hổng, viết bản vá | Quyết định chấp nhận hay từ chối ngoại lệ |
  70. | 4. Staging & Perf | k6, Locust, Compose/K8s | Sinh script load test, phân tích bottleneck | Chốt ngưỡng p95/p99 |
  71. | 5. Prod & Monitor | ArgoCD/GitLab CD, Prometheus, Grafana | Phân tích sự cố (`/aidd:rca`) | Bấm duyệt lên production |
  72. ### Triển khai và vận hành
  73. | Lệnh | Claude làm | Đầu ra |
  74. |---|---|---|
  75. | `/aidd:ship` | Soát Dockerfile, compose, k8s; checklist secret và env | file hạ tầng |
  76. | `/aidd:rca <log>` | Nguyên nhân gốc, test tái hiện đỏ → sửa → xanh | bản vá + `docs/incidents/` |
  77. ### Checklist thực thi (dán vào Notion/Jira)
  78. | Bước | Hành động chính | Lệnh | Definition of Done |
  79. |---|---|---|---|
  80. | 1. Setup | Nạp bộ luật NFR và khung giám sát | `rules` · `observe` · `secure-ci` | Repo có file rules và CI quét bảo mật |
  81. | 2. Build | Thiết kế DB có index → sinh code → test | `contract` · `slice` | Chạy đúng nghiệp vụ, pass unit và integration test |
  82. | 3. Audit | Phiên mới, quét OWASP và quét theo tải cao | `audit-security` · `audit-perf` · `fix` | Đã sửa mọi lỗi bảo mật và điểm nghẽn tìm thấy |
  83. | 4. Verify | CI security + EXPLAIN ANALYZE + load test | `ci-fix` · `explain` · `loadtest` · `verify` | CI xanh, không full table scan, p95 đạt chuẩn |
  84. ## Cài đặt
  85. Yêu cầu: [Claude Code](https://docs.claude.com/en/docs/claude-code) và git.
  86. ### Cách 1 — Plugin (khuyên dùng)
  87. Trong Claude Code:
  88. ```
  89. /plugin marketplace add soxxam/aidd
  90. /plugin install aidd@aidd
  91. ```
  92. Khởi động lại Claude Code. Gõ `/aidd:` để thấy các lệnh.
  93. Cập nhật: `/plugin marketplace update aidd`. Gỡ: `/plugin uninstall aidd@aidd`.
  94. Cho cả team dùng chung — thêm vào `.claude/settings.json` của repo rồi commit:
  95. ```json
  96. {
  97. "extraKnownMarketplaces": {
  98. "aidd": { "source": { "source": "github", "repo": "soxxam/aidd" } }
  99. },
  100. "enabledPlugins": { "aidd@aidd": true }
  101. }
  102. ```
  103. ### Cách 2 — Copy thủ công vào dự án
  104. Dùng khi không muốn cài plugin hoặc muốn sửa skill theo dự án. Lệnh sẽ có dạng `/aidd-prd`, `/aidd-slice`… (gạch ngang thay vì hai chấm).
  105. macOS / Linux / Git Bash:
  106. ```bash
  107. git clone https://github.com/soxxam/aidd.git
  108. ./aidd/install.sh /đường/dẫn/dự-án # hoặc --global để cài cho mọi dự án
  109. ```
  110. Windows PowerShell:
  111. ```powershell
  112. git clone https://github.com/soxxam/aidd.git
  113. powershell -ExecutionPolicy Bypass -File .\aidd\install.ps1 D:\đường\dẫn\dự-án # hoặc thêm -Global
  114. ```
  115. Windows mặc định chặn chạy script `.ps1`, nên cần cờ `-ExecutionPolicy Bypass`. Cờ này chỉ áp dụng cho lần chạy đó.
  116. ### Khởi tạo dự án (cả hai cách)
  117. Mở Claude Code trong thư mục dự án và chạy `/aidd:init` (cách 2: `/aidd-init`). Lệnh này:
  118. - tạo `docs/aidd/WORKFLOW.md`, `docs/aidd/templates/` (PRD, DESIGN, PLAN, ADR), `docs/features/`, `docs/adr/`, `docs/incidents/`;
  119. - thêm mục **Quy trình AIDD** vào `CLAUDE.md` và điền lệnh build/test, nơi chứa quy ước code của dự án;
  120. - không ghi đè file đã có.
  121. Rồi commit những file này để cả team dùng chung.
  122. ## Dùng hằng ngày
  123. ```
  124. # Giai đoạn 0, một lần cho mỗi repo
  125. /aidd:init
  126. /aidd:rules # docs/rules + Ràng buộc cứng trong CLAUDE.md
  127. /aidd:observe # log JSON + trace_id, metrics
  128. /aidd:secure-ci jenkins # Gitleaks + Semgrep + Trivy trong pipeline
  129. # Giai đoạn 1, mỗi tính năng
  130. /aidd:prd Cho phép người dùng xuất báo cáo ra Excel
  131. /aidd:design export-excel
  132. /aidd:contract export-excel # SCHEMA.sql (có index) + API_SPEC.yaml, bạn duyệt
  133. /aidd:slice export-excel # lặp: plan → duyệt → code + test
  134. /aidd:review
  135. git add -p && git commit # một lát = một commit
  136. /clear
  137. # Giai đoạn 2, phiên mới
  138. /clear
  139. /aidd:audit-security export-excel
  140. /aidd:audit-perf export-excel
  141. /aidd:fix export-excel high # vá mọi mục Critical/High
  142. # Giai đoạn 3, trước khi merge
  143. git push # chờ CI; đỏ thì: /aidd:ci-fix <dán log>
  144. /aidd:explain export-excel
  145. /aidd:loadtest export-excel http://localhost:8080
  146. /aidd:verify export-excel # phải ĐẠT mới merge
  147. # CI/CD, dựng một lần cho mỗi repo
  148. /aidd:pipeline jenkins k8s # đối chiếu 5 giai đoạn rồi gọi các lệnh dưới
  149. /aidd:precommit # hook: Gitleaks + lint/format + chặn commit vào main
  150. /aidd:pr export-excel # nhánh feat/…, mô tả PR (bảng DB, breaking change), mở PR khi bạn đồng ý
  151. /aidd:ci-test 75 # Testcontainers + coverage gate
  152. /aidd:migration-check # dry-run migration của PR
  153. /aidd:smoke · /aidd:perf-gate # staging: smoke + so p95 với baseline
  154. /aidd:release canary · /aidd:rollback # duyệt tay, canary 10%, auto-rollback
  155. /aidd:ship # trước khi phát hành
  156. /aidd:rca <dán stack trace> # khi có bug
  157. ```
  158. Mẹo:
  159. - `@docs/features/<slug>/PRD.md` để đính tài liệu vào prompt bất kỳ.
  160. - `Shift+Tab` để tự bật plan mode; `Esc Esc` để quay lại checkpoint trong phiên.
  161. - Không hiểu đoạn code nào trong diff thì bắt Claude giải thích hoặc viết lại đơn giản hơn trước khi accept.
  162. ## Luật mà AIDD thêm vào CLAUDE.md
  163. - Không code tính năng mới khi chưa có `PRD.md` và `PLAN.md`; mỗi lần một lát cắt, plan được duyệt mới sửa file.
  164. - Mỗi AC có ít nhất một test; không báo "xong" khi chưa chạy test; không sửa test cho xanh.
  165. - Không tự thêm dependency, hạ tầng, đổi hợp đồng API/schema; không sửa migration đã chạy.
  166. - Không tự commit, push, deploy; không đưa secret vào file; không tắt bước quét hay hạ ngưỡng CI.
  167. - Không code khi chưa duyệt hợp đồng `docs/contracts/SCHEMA.sql` + `API_SPEC.yaml`.
  168. - `/aidd:rules` thêm mục **Ràng buộc cứng** trỏ tới `docs/rules/`. Code vi phạm SEC/PERF/RES là lỗi, không phải gợi ý.
  169. ## 3 nguyên tắc
  170. 1. **Tài liệu trong repo là bộ nhớ dài hạn của AI.** Code đổi thì tài liệu đổi trong cùng lát cắt.
  171. 2. **Commit nhỏ, liên tục.** Hỏng thì `git reset --hard HEAD` trong một giây.
  172. 3. **Bạn chịu trách nhiệm 100% về code.** AI tăng tốc, không chịu trách nhiệm thay bạn.
  173. ## Cấu trúc repo
  174. ```
  175. .claude-plugin/marketplace.json # marketplace "aidd"
  176. plugins/aidd/
  177. ├─ .claude-plugin/plugin.json
  178. ├─ skills/
  179. │ ├─ init, rules, observe, secure-ci # giai đoạn 0
  180. │ ├─ prd, design, contract, slice, review # giai đoạn 1
  181. │ ├─ audit-security, audit-perf, fix # giai đoạn 2
  182. │ ├─ ci-fix, explain, loadtest, verify # giai đoạn 3
  183. │ ├─ pipeline, precommit, pr, ci-test, migration-check,
  184. │ │ smoke, perf-gate, release, rollback # CI/CD 5 giai đoạn
  185. │ └─ ship, rca # triển khai, vận hành
  186. │ (templates: init/, rules/, contract/, pr/, pipeline/, loadtest/k6.js,
  187. │ perf-gate/compare.mjs, rollback/{watch.sh,analysis-template.yaml}, secure-ci/references.md)
  188. └─ agents/
  189. ├─ reviewer.md # review nhanh mỗi lát
  190. ├─ security-auditor.md # Red Team OWASP
  191. └─ perf-auditor.md # 10 triệu dòng / 1.000 CCU
  192. install.sh / install.ps1 # cài thủ công
  193. ```
  194. ## License
  195. MIT

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.