Thiết kế và thay đổi database với ak:databases

Dùng ak:databases để thiết kế model MongoDB hoặc PostgreSQL, viết và giải thích query, phân tích index hay chuẩn bị database operation với bằng chứng recovery hiển thị. Skill gồm reference guidance cùng utility Python tùy chọn cho migration, backup, restore, cleanup và performance analysis.

Chọn ak:databases cho ranh giới dữ liệu

Dùng ak:databases khi

• Schema, query, aggregation, index, migration, backup, replication, permission hoặc performance database là trọng tâm.
• Bạn cần chọn relational, document, analytical hay event-history model từ workload cùng yêu cầu integrity.
• Bạn cần guidance quản trị MongoDB hoặc PostgreSQL.

Chọn workflow khác khi

• Database change chỉ là phần phụ của API implementation lớn hơn. Dùng ak:backend-development nhưng giữ các migration gate của Skill này.
• Task chủ yếu là cloud infrastructure hoặc deployment. Dùng ak:devops.
• Bạn chỉ cần chẩn đoán root cause. Dùng ak:fix và giữ database access ở chế độ read-only tới khi correction được duyệt.
• Bạn cần thực thi plan đa tầng đã duyệt. Dùng ak:cook, đồng thời cô lập phase cùng quyền database.

Chuẩn bị access và recovery

Trước khi bắt đầu:

• Hoàn thành Làm quen và xác nhận Engineer Kit đã được cài cho runtime cùng scope hiện tại.
• Xác định database engine cùng version, environment, owner, schema hoặc collection, workload, độ nhạy dữ liệu, retention cùng consistency need.
• Dùng account có least privilege và target non-production rõ ràng khi có thể. Không để connection string trong prompt, log, shell history hay tệp commit.
• Ghi nhận read và write đại diện, invariant, volume dự kiến, khả năng chịu lock, maintenance window cùng yêu cầu compatibility.
• Yêu cầu backup hiện hành, đường restore đã test, forward plan, rollback hoặc compensating plan cùng post-change verification trước mutation production.

Prerequisite của utility tùy chọn phụ thuộc operation:

Runtime requirements file đi kèm không cài pymongo hay psycopg2, dù utility migration cùng performance có import chúng. Hãy xác nhận dependency thay vì giả định utility đã sẵn sàng.

Chạy Skill

Argument shape được khai báo là [query or schema task]. Skill không định nghĩa flag, database mặc định hay connection tự động.

/ak:databases "Design a backward-compatible PostgreSQL migration that adds order.external_id as nullable, backfills in batches, then adds uniqueness. Produce SQL, rollback limits, lock analysis, and verification queries; do not connect or apply it."

/ak:databases "Design a backward-compatible PostgreSQL migration that adds order.external_id as nullable, backfills in batches, then adds uniqueness. Produce SQL, rollback limits, lock analysis, and verification queries; do not connect or apply it."

$ak:databases "Design a backward-compatible PostgreSQL migration that adds order.external_id as nullable, backfills in batches, then adds uniqueness. Produce SQL, rollback limits, lock analysis, and verification queries; do not connect or apply it."

Hiểu mode của utility đi kèm

Đây là local script riêng, không phải flag của ak:databases:

Các utility nhận connection URI qua command argument. Hãy dùng execution environment được bảo vệ và lưu ý argument có thể hiển thị cho local user khác hoặc được shell history ghi lại.

Quan sát workflow database an toàn

1. Lần chạy phân loại workload. Skill ghi access pattern, invariant, growth, retention, reporting, consistency cùng constraint dữ liệu nhạy cảm.
2. Lần chạy kiểm tra không mutation. Skill đọc schema, index, query plan, statistic cùng dữ liệu đại diện với privilege hẹp nhất có thể.
3. Lần chạy thiết kế thay đổi. Skill nêu forward step, compatibility, batching, lock, ảnh hưởng replication, backup, rollback hoặc compensation cùng acceptance query.
4. Lần chạy rehearsal an toàn. Skill dùng generated script, dry run, fixture hoặc database cô lập gần production và ghi rõ giới hạn của từng cách.
5. Lần chạy xin quyền mutation. Apply migration, restore, cleanup backup, đổi role, bật profiling hay sửa production config vẫn là quyết định riêng.
6. Lần chạy xác minh và báo cáo. Skill kiểm tra schema state, row hoặc document count, constraint, query plan, application compatibility, replication cùng recovery evidence.

Giữ destructive operation sau approval

Các ranh giới khác từ utility đi kèm:

• Rollback migration MongoDB chỉ xóa migration tracking record; nó không đảo ngược schema hay index operation đã ghi. Không dùng nó cho recovery nếu chưa có compensating operation được xác minh riêng.
• “Verification” của backup chỉ kiểm tra output tồn tại và không rỗng. Đây không phải checksum, content validation hay test restore.
• Cleanup xóa vĩnh viễn mọi tệp không phải JSON trong backup directory đã chọn nếu cũ hơn retention cutoff. Review chính xác directory cùng dry-run listing trước.
• Performance analysis MongoDB bật database profiling theo slow-query threshold đã chọn nếu profiling đang tắt. Việc này đổi database config và có thể thu query content.
• Index được gợi ý là heuristic. Phải review explain plan, write overhead, storage, uniqueness, locking cùng workload evidence trước khi tạo.
• Atlas, managed database, storage, snapshot, replica, cross-region traffic và restore operation có thể phát sinh phí provider. Bản thân Skill không yêu cầu paid provider.

Xác minh kết quả

Kết quả design hoặc query hoàn tất nên cung cấp model hay query đề xuất, assumption, plan dự kiến cùng đường validation. Kết quả mutation hoàn tất còn nên cung cấp:

• Chính xác target environment, database, schema hoặc collection cùng identity đã dùng.
• Backup artifact cùng bằng chứng restore mạnh hơn phép kiểm tra không rỗng của utility.
• Forward operation, behavior transaction cùng lock, rollback hoặc compensation và compatibility window.
• Count trước và sau, constraint, query plan, latency hoặc throughput cùng application check liên quan.
• Mọi test đã bỏ qua, rủi ro chưa giải quyết và production action vẫn chờ duyệt.

Xử lý sự cố hoặc tiếp tục

Xem Project, artifact và checkpoint trước recovery hoặc tiếp tục với Engineer Kit.

Biết các giới hạn hiện tại

• Test utility bao phủ class ở mức parser cùng database hoặc subprocess được mock; chúng không chứng minh an toàn trên hệ thống MongoDB hay PostgreSQL thật.
• Quick example trong source không khớp mọi parser option của utility. Các bảng trên theo executable argument definition.
• Runtime duration không được định nghĩa. Query advice có thể mất vài phút; backup, restore, migration, reindex và performance sampling phụ thuộc data size, lock, network, storage cùng provider limit.
• Stable và beta chứa reference, utility cùng test giống nhau trong cặp release này.