Đưa request tới PR readiness với ak:vibe

Dùng ak:vibe khi một GitHub issue hoặc feature request có boundary rõ cần đi qua isolated worktree, validated plan, implementation hoặc repair, local review, pull request và merge tùy chọn. Pipeline điều phối owning Skill; nó không thay thế test, approval gate, branch protection hay security rule của chúng.

Chọn ak:vibe cho end-to-end delivery

Dùng ak:vibe khi

• GitHub issue là source of truth cho feature hoặc bugfix.
• Natural-language request cụ thể cần trở thành issue cùng reviewed PR.
• Bạn muốn cùng pipeline chọn ak:cook cho feature work hoặc ak:fix cho bug, regression, failing CI hay incident evidence.
• Bạn muốn optional beta delivery, dual-stage promotion hoặc advisory checkpoint.

Chọn workflow khác khi

• Requirement hoặc product scope vẫn cần khám phá. Bắt đầu với ak:brainstorm hoặc ak:plan.
• Bạn cần local implementation và không cấp quyền GitHub mutation, branch push hay PR creation. Dùng trực tiếp ak:cook hoặc ak:fix.
• Bạn chỉ cần review. Dùng ak:code-review hoặc ak:review-pr.
• Repository hiện tại không khớp supplied issue repository.
• Work phải chạy trực tiếp trên protected hoặc shared integration branch.

Chuẩn bị delivery authority

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

• Hoàn thành Làm quen và xác nhận mọi Engineer Skill được điều phối đã cài cho đúng runtime cùng scope.
• Mở Git repository khớp với clean hoặc reusable isolated feature worktree strategy.
• Cài AgentKit CLI, Git cùng gh CLI authenticated có permission cần cho issue, label, branch, PR, review cùng merge action được yêu cầu.
• Cung cấp GitHub issue URL/number hoặc feature request có outcome, scope, constraint, acceptance criteria cùng non-goal.
• Quyết định run chỉ được tới PR readiness hay có thể merge và converge CI.
• Giữ unrelated work và xác định protected branch cùng promotion policy.

Xem Runtime adapter trước khi bắt đầu run dài, nhiều mutation ngoài runtime có evidence mạnh nhất.

Chọn ship mode có chủ đích

/ak:vibe --beta "Add exportable audit logs with existing authorization, focused tests, and no breaking API changes"

/ak:vibe --beta "Add exportable audit logs with existing authorization, focused tests, and no breaking API changes"

$ak:vibe --beta "Add exportable audit logs with existing authorization, focused tests, and no breaking API changes"

Mode resolution là --both trên --beta trên default stable. Khi cả hai flag cùng xuất hiện, Skill cảnh báo một lần rồi tiếp tục dual-stage mode.

Hiểu điều gì xảy ra trong một lần chạy

1. Skill resolve request. Skill xác minh repository identity, đọc issue title, body cùng comment khi được cung cấp, extract contract, chọn feature hoặc bugfix route và tìm existing durable plan.
2. Skill tạo isolation. ak:worktree tạo hoặc reuse matching clean worktree cùng descriptive branch. Skill không implement trực tiếp trên common protected hoặc integration branch.
3. Skill validate plan. Existing plan.md hợp lệ được reuse; nếu không, ak:plan --tdd tạo plan. Validation, red-team cùng whole-plan consistency sweep luôn chạy trước implementation.
4. Skill project state lên GitHub. Workflow tạo delivery label còn thiếu, tạo hoặc update source issue, ghi branch, route, plan, mode cùng acceptance criteria, rồi link issue vào local plan index.
5. Skill implement scoped work. Feature dùng ak:cook --tdd --auto; bugfix dùng ak:fix --auto. Issue đổi từ ready to cook sang in progress trước khi code change bắt đầu.
6. Skill thực hiện local review. ak:code-review --pending kiểm tra spec compliance cùng quality. Critical và Important finding được fix rồi relevant validation chạy lại.
7. Skill ship PR. ak:ship beta hoặc ak:ship official finalize plan file, merge target branch vào feature branch, test, review, commit, push, mở PR và ghi linked PR.
8. Skill converge PR review. ak:review-pr --fix --reply review full PR, fix actionable finding, push verified fix, post final review và chờ required check thành terminal cùng green.
9. Skill đánh dấu readiness. Issue và PR nhận ready label đúng; stale implementation label được remove.
10. Skill tùy chọn merge và monitor. --ship cùng --both merge theo repository convention, watch target-branch CI hoặc deploy workflow và chạy bounded follow-up fix branch cho deterministic failure.

Dual-stage mode không bắt đầu stable delivery tới khi beta CI green. Trước promotion merge, Skill liệt kê commit được mang theo và dừng xin duyệt nếu promotion sweep unrelated work.

Giữ approval gate nguyên vẹn

• --ship cấp quyền merge PR chỉ sau khi readiness gate pass; nó không cấp quyền force push, direct push vào protected target, bypass review hay che check fail.
• --both cấp quyền hai delivery stage nhưng không cho unrelated promotion sweep.
• Public-contract, security-sensitive, business hoặc irreversible decision vẫn là human gate ngay trong automatic implementation mode.
• Branch protection cùng required review vẫn authoritative. Pending check có thể dùng repository-supported auto-merge; failed hoặc conflicting state không thể bị force qua.
• Cùng unresolved CI blocker chỉ được thử tối đa ba lần trước khi run dừng và handoff evidence.
• --advice thêm counsel cùng external PR/issue comment. Kongming không edit code hay cung cấp approval thay user.

Tính network, process, disk và cost

• GitHub issue, label, PR, review, merge cùng workflow operation dùng authenticated network request và mutate shared repository state.
• Worktree creation ghi checkout khác; owning Skill có thể install dependency dựa trên lockfile, dùng đáng kể network, CPU cùng disk.
• Planning, implementation, test, build, review, commit cùng follow-up fix có thể spawn nhiều local process và tạo durable file.
• CI cùng deploy workflow dùng runner hoặc provider capacity của repository sau push và merge. Skill không định giá; account billing cùng quota áp dụng.
• Issue body, comment, plan, PR text, log cùng advisory comment phải loại secret, token, customer data, private environment value và sensitive command output chưa redact.

Xác minh kết quả

Một PR-readiness run hoàn tất nên cung cấp:

• Source issue hoặc created issue URL, isolated branch cùng worktree, durable plan, implementation route và resolved ship mode.
• Acceptance criteria được current test cùng local review evidence hỗ trợ.
• Pushed PR có structured evidence, linked plan, final review verdict, green required check cùng ready label đúng.
• Không có unresolved Critical hoặc Important review finding.
• Completion report nêu review iteration, blocker cùng unresolved question.

Merge-enabled run còn phải hiển thị merge result, merge commit, target-branch CI conclusion cùng mọi follow-up fix. Dual-stage completion cần evidence PR, merge và CI riêng cho beta cùng stable.

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

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

• Full run phụ thuộc nested Skill tương thích, GitHub access, repository convention, branch protection, test infrastructure cùng CI availability.
• Natural-language input gây GitHub issue creation sau plan gate; đây không phải local-only shortcut.
• Automatic implementation không loại business hoặc irreversible-action gate.
• Package stable và beta hiện chứa cùng instruction cùng invocation behavior cho ak:vibe.