Giữ tri thức project marketing luôn cập nhật với ak:docs

Dùng ak:docs để tạo, đối chiếu hoặc tóm tắt tài liệu project mà không áp đặt cây thư mục chuẩn. Skill giữ quyết định, constraint, terminology và navigation trong prose, đồng thời trỏ behavior hiện tại tới bằng chứng thực thi được.

Chọn ak:docs cho tài liệu dựa trên bằng chứng

Dùng ak:docs khi

• Project marketing cần route tài liệu tối thiểu cho con người, AI collaborator hoặc cả hai.
• Workflow, configuration, public contract hoặc operating constraint đã duyệt thay đổi và tài liệu gần đó có thể đã cũ.
• Bạn cần bản tóm tắt tập trung từ bằng chứng hiện tại của project.
• Tài liệu đang sao chép command, inventory hoặc implementation behavior dễ đổi.

Chọn workflow khác khi

• Tầm nhìn hoặc quyết định của bạn cần trở thành tài liệu qua phỏng vấn. Dùng ak:interview-docs.
• Bạn cần research assignment. Dùng ak:research-prompt.
• Bạn muốn triển khai product code. ak:docs loại trừ rõ công việc đó.
• Bạn chỉ cần sơ đồ. Dùng ak:mermaidjs-v11 hoặc ak:tech-graph.

Chuẩn bị project và runtime

Xác định audience, quyết định tài liệu phải hỗ trợ, nguồn chứng minh behavior hiện tại và acceptance criteria. Chạy từ project có instruction cùng bằng chứng sẽ chi phối kết quả.

Skill đọc instruction như AGENTS.md hoặc CLAUDE.md, README.md ở root, navigation tài liệu hiện có, tài liệu gần đó, rồi source, test, script, generated artifact và live state liên quan. Skill không giả định filename, số lượng tệp hay cây tài liệu chung.

Xem Runtime adapter để biết khác biệt theo từng component.

Chạy Skill

Argument đầu tiên chọn init, update, summarize hoặc agent-context. Input trống hay không rõ khiến Skill hỏi lại; Skill không bao giờ tự giả định init.

/ak:docs update Đối chiếu tài liệu launch với campaign workflow đã duyệt. Chỉ đổi claim được bằng chứng hiện tại của project chứng minh, giữ tài liệu không liên quan và không publish

/ak:docs update Đối chiếu tài liệu launch với campaign workflow đã duyệt. Chỉ đổi claim được bằng chứng hiện tại của project chứng minh, giữ tài liệu không liên quan và không publish

$ak:docs update Đối chiếu tài liệu launch với campaign workflow đã duyệt. Chỉ đổi claim được bằng chứng hiện tại của project chứng minh, giữ tài liệu không liên quan và không publish

Với root context, /ak:docs agent-context --advice hỏi kongming trước khi đề xuất ghi. /ak:docs agent-context --audit trình bày từng quyết định keep, cut, fix hoặc migrate và chỉ áp dụng thay đổi đã xác nhận. Trong Codex, dùng $ak:docs. Setting và cấu hình Hook deterministic chỉ được khuyến nghị, và chưa có filename root context cho Cursor. Chỉ dùng ak:folder-context cho thư mục con.

Theo các giai đoạn dựa trên bằng chứng

1. Xác lập contract. Giới hạn audience, outcome, authority, bằng chứng, scope và acceptance criteria.
2. Khám phá route. Đọc instruction cùng navigation trước khi chọn tài liệu.
3. Map claim tới owner. Dùng source, test, schema, manifest, generator và live state cho behavior hiện tại.
4. Chọn thay đổi nhỏ nhất. Dùng lại route mạch lạc; tránh index rỗng, roadmap suy đoán và bộ ADR tự động.
5. Viết hoặc tóm tắt. Trỏ tới executable owner thay vì sao chép behavior dễ thay đổi.
6. Xác minh. Kiểm tra link, path, example, configuration key, command và owning script khi thực tế.

Giữ thay đổi tài liệu trong phạm vi quyền hạn

Đừng đặt credential, dữ liệu khách hàng riêng tư hoặc secret URL vào tài liệu. Giữ plan, audit, research và release evidence tách khỏi evergreen authority. Review đề xuất thay route tài liệu đã thiết lập trước khi ghi tệp.

Xác minh output và bằng chứng

Không có output filename cố định. Một lần chạy hoàn tất nên xác định:

• tài liệu được tạo, thay đổi, giữ lại hoặc xóa;
• audience và quyết định mà mỗi tài liệu đã đổi phục vụ;
• evidence owner cho từng claim hiện tại;
• link, path, example và validator đã kiểm tra; và
• uncertainty còn lại hay hành động vẫn cần phê duyệt.

Với summarize, hãy chờ response trừ khi bạn nêu target lâu dài. Với init hoặc update, hãy kiểm tra diff và xác nhận không có product code hay tài liệu không liên quan bị thay đổi.

Khắc phục và hiểu giới hạn

Skill chỉ có thể xác minh bằng chứng và live state truy cập được trong session hiện tại. Skill không thể biến claim thiếu hỗ trợ thành đúng hay quyết định policy publish.

Tiếp tục với Tổng quan Marketing Kit, Agent của Marketing Kit hoặc Cài đặt Kit.