AgentKit
Tài liệuBộ kitTham chiếu CLIỨng dụng Desktop

Skill

Cấu trúc analysis có thể revision với ak:sequential-thinking

Phân rã quyết định phức tạp thành checkpoint có giới hạn với assumption, branch, revision và verification evidence rõ ràng.

Dùng ak:sequential-thinking để phân tích problem phức tạp theo các stage có thể revision. Skill có thể mở rộng hoặc thu hẹp working sequence, xem lại assumption không còn đúng, so sánh branch và xác minh hypothesis trước khi trình bày final decision. Đây là reasoning method, không phải implementation hay proof engine.

Chọn ak:sequential-thinking cho adaptive reasoning

Dùng ak:sequential-thinking khi

  • Problem có nhiều dependent constraint hoặc scope chưa rõ.
  • Evidence mới có thể làm assumption trước đó không còn đúng.
  • Bạn cần so sánh hai hoặc ba approach và giải thích convergence.
  • Debugging yêu cầu hypothesis, observation và verification result luôn kết nối.
  • Plan hoặc architecture decision cần summary có thể audit về assumption, trade-off và unresolved question.

Chọn workflow khác khi

  • Câu hỏi đủ đơn giản để trả lời trực tiếp. Dùng ak:ask.
  • Bạn cần tạo nhiều option trước analysis. Dùng ak:brainstorm.
  • Bạn cần repository implementation plan. Dùng ak:plan.
  • Bạn cần thực thi thay đổi. Dùng ak:cook.
  • Bạn cần numeric optimization lặp lại. Dùng ak:loop.

Chuẩn bị problem và evidence

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

  • Hoàn thành Làm quen và xác nhận Skill khả dụng qua Engineer Kit cho runtime cùng scope hiện tại.
  • Nêu decision hoặc diagnosis bạn cần, không chỉ topic.
  • Cung cấp constraint, evidence hiện có, rejected alternative và authority boundary.
  • Đánh dấu fact, assumption, unknown và claim cần test hoặc source.
  • Đặt response bound hữu ích như maximum checkpoint, elapsed time hoặc branch. Skill không có invocation flag chính thức cho các giới hạn này.
  • Giữ secret và sensitive personal data khỏi reasoning record.
RuntimeCách gọiRanh giới khả dụng
Claude Code/ak:sequential-thinking ...Chạy như Skill được Engineer Kit kế thừa; explicit output phụ thuộc response shape được yêu cầu.
Cursor/ak:sequential-thinking ...Dùng cách gọi slash đã được người dùng xác minh cho Engineer Skill; runtime parity rộng hơn chưa được thiết lập.
Codex$ak:sequential-thinking ...Dùng discovery Skill native của Codex; điều này không cho phép truy cập hidden model reasoning hay host control giống hệt.

Chạy analysis có giới hạn

/ak:sequential-thinking "Choose a migration strategy for splitting the audit log from the primary database. Use at most 8 concise checkpoints, compare dual-write and change-data-capture branches, revise assumptions when evidence conflicts, and finish with a decision, verification plan, and unresolved questions."

Yêu cầu visible checkpoint khi chúng giúp review. Với routine work, Skill có thể áp dụng method ngầm và chỉ trả conclusion, evidence, assumption cùng open question. Không mode nào expose hay bảo đảm private internal chain of thought của model.

Hiểu reasoning marker

MarkerMục đíchCâu hỏi review
Thought N/MNêu một bounded aspect và estimate hiện tạiCheckpoint này thêm evidence hay decision cần thiết không?
REVISIONSửa assumption hoặc conclusion trước đóEvidence mới nào tạo thay đổi và downstream claim nào cần kiểm tra lại?
BRANCHTách viable alternativeTrade-off có được đánh giá dưới cùng constraint không?
HYPOTHESISNêu explanation hoặc solution đề xuấtObservation nào sẽ support hoặc reject nó?
VERIFICATIONGhi test, source hoặc comparisonEvidence có current, scoped và thực sự phân biệt không?
FINALTổng hợp result hiện tạiCritical uncertainty đã được giải quyết hay nêu rõ chưa?

Initial total là loose estimate. Expansion phù hợp khi constraint mới xuất hiện; contraction phù hợp khi decisive finding làm step sau không còn cần. Nhiều checkpoint hơn không phải bằng chứng answer tốt hơn.

Quan sát adaptive process

  1. Skill frame câu hỏi. Nó nêu outcome, constraint, evidence, unknown và current scope estimate.
  2. Skill xử lý một concern mỗi lần. Mỗi checkpoint build trên context trước và nói evidence hoặc decision tiếp theo là gì.
  3. Skill revision khi cần. Correction nêu original claim, evidence mới và downstream impact.
  4. Skill branch có chọn lọc. Hai hoặc ba plausible alternative được so sánh trước khi tạo thêm branch.
  5. Skill xác minh hypothesis. Test, measurement, code evidence hoặc authoritative source phân biệt competing explanation.
  6. Skill kiểm tra progress của chính nó. Circling, missing evidence hoặc revision cascade kích hoạt strategy change thay vì thêm prose lặp lại.
  7. Skill converge hoặc dừng. Nó trả decision có rationale và validation, hoặc blocked result nêu minimum missing evidence.

Sau foundational revision, downstream checkpoint phải được reassess. Invalidated reasoning không nên âm thầm còn trong final answer.

Dùng optional tracking cẩn thận

Package có optional Node.js helper cho deterministic validation, history và display formatting. Đây là support file, không phải Skill riêng hay required runtime service.

HelperTác dụngLocal side effect
scripts/process-thought.jsValidate thought number, total, next-state, revision và branch fieldAppend supplied text vào scripts/.thought-history.json cạnh helper
scripts/format-thought.jsFormat supplied checkpoint dạng box, simple text hoặc MarkdownIn output; không dùng history tracker
--history trên processorTrả stored thought và branchĐọc local history file
--reset trên processorXóa tracked historyXóa local history file

Optional tracker persist prompt text

Không truyền secret, credential, private customer data hoặc sensitive incident detail vào process-thought.js. Review local history trước khi share installation hoặc artifact và yêu cầu approval trước khi xóa bằng --reset.

Bản thân method không cần helper. Chỉ dùng support script khi durable local history hoặc deterministic formatting là một phần deliverable được yêu cầu.

Giữ reasoning trong authority

Structured analysis không cấp quyền file edit, command, network access, external research, deployment hay destructive action. Verification step cần bất kỳ effect nào trong số đó phải tuân theo project và user approval rule bình thường.

Đừng biến missing evidence thành confidence language. Nếu hypothesis không thể test bằng tool có sẵn, hãy nêu gap và đề xuất bounded next check. Dừng khi checkpoint tiếp theo lặp cùng premise, vượt resource bound của user hoặc cần authority mới.

Xác minh final result

Output hữu ích nên chứa:

  • Decision hoặc diagnosis đã frame cùng constraint.
  • Fact, assumption và unresolved unknown được tách biệt.
  • Revision cùng evidence và downstream impact gây ra nó.
  • Branch được so sánh theo common evaluation criteria.
  • Hypothesis và evidence dùng để support hoặc reject.
  • Final recommendation, confidence boundary và verification plan.
  • Blocked result khi critical evidence không khả dụng.
  • Optional local history artifact cùng sensitivity boundary.

Run hoàn tất khi decision được yêu cầu có available evidence support và critical uncertainty được giải quyết hoặc nêu rõ. Chỉ có label FINAL không làm conclusion đúng.

Xử lý sự cố hoặc dừng

Triệu chứngBước an toàn tiếp theo
Sequence tiếp tục mở rộngReframe decision, cap checkpoint và xác định một missing fact có decision value cao nhất.
Branch tăng nhiềuGiới hạn hai hoặc ba, so sánh bằng shared criteria và converge trước khi branch thêm.
Revision làm nhiều step sau invalidMark revision, reassess mọi dependent claim và chỉ rebuild affected path.
Answer dài nhưng không có supportThay narrative bằng assumption, evidence, test và decision table ngắn.
Verification không thể chạyTrả blocked hypothesis cùng minimum required evidence; không claim confidence.
Tracker history chứa sensitive textDừng share artifact, review local file và yêu cầu approval trước reset hoặc redaction.
Runtime không tìm thấy SkillXác nhận installation và xem Runtime không tìm thấy Skill hoặc Agent.

Đưa verified decision sang ak:plan, dùng ak:scenario để mở rộng edge case hoặc ak:predict để stress-test risky proposal.

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

  • Skill cấu trúc analysis; nó không đảm bảo correctness, confidence, completeness hay optimal decision.
  • Visible marker là review artifact, không phải quyền truy cập private model reasoning.
  • Hypothesis verification bị giới hạn bởi available evidence và authorized tool.
  • Optional processor persist supplied text và không cung cấp encryption, access control hay cross-runtime synchronization.
  • Runtime output shape và support-file location có thể khác sau projection.
  • Stable và beta chứa source cùng helper ak:sequential-thinking giống nhau.