decision-logger
bởi alirezarezvanidecision-logger là một skill Decision Support dành cho các quyết định hội đồng đã được phê duyệt. Skill này tách transcript thô khỏi chỉ mục quyết định Layer 2, theo dõi owner, deadline, các phương án bị bác bỏ và follow-up, đồng thời có Python tracker để tạo tóm tắt, kiểm tra hạng mục quá hạn, phát hiện xung đột, lọc theo owner và tìm kiếm.
Skill này đạt 80/100, là một lựa chọn đáng cân nhắc cho người dùng thư mục cần bộ nhớ có cấu trúc về quyết định của hội đồng và rà soát các hạng mục hành động. Nó mang lại nhiều đòn bẩy cho agent hơn một prompt chung nhờ trigger được xác định rõ, định dạng lưu quyết định đã phê duyệt bền vững và script báo cáo, dù việc áp dụng sẽ dễ nhất khi nằm trong workflow C-Level Advisor đi kèm.
- Điều kiện kích hoạt được mô tả rõ: sau các cuộc họp hội đồng, khi rà soát các quyết định đã được phê duyệt, hoặc khi kiểm tra các hạng mục hành động quá hạn.
- Có nền tảng vận hành thực tế: SKILL.md định nghĩa mô hình bộ nhớ quyết định hai lớp raw/approved, cùng commands, keywords và use cases.
- Có hỗ trợ thực thi qua scripts/decision_tracker.py, kèm mẫu decision-entry với quy tắc trường để tạo các mục Layer 2 nhất quán.
- Không có lệnh cài đặt hoặc README tại đường dẫn skill, nên người dùng phải tự suy luận cách cài đặt từ cấu trúc repository lớn hơn.
- Quy trình có vẻ được thiết kế riêng cho hệ sinh thái C-Level Advisor/board-meeting và các slash command như /cs:decisions và /cs:review, nên mức độ hữu ích khi dùng độc lập có thể bị hạn chế.
Tổng quan về decision-logger skill
decision-logger làm gì
decision-logger là một Decision Support skill giúp chuyển kết quả họp hội đồng quản trị thành bộ nhớ quyết định bền vững gồm hai lớp. Lớp 1 lưu giữ bối cảnh thô của cuộc họp; Lớp 2 chỉ lưu các quyết định đã được phê duyệt, người chịu trách nhiệm, hạn chót, phương án bị loại và các việc cần theo dõi. Giá trị của decision-logger skill nằm ở tính thực dụng: các cuộc họp sau này có AI hỗ trợ nên dựa trên quyết định đã xác nhận, không phải tranh luận còn bỏ ngỏ hay sự đồng thuận do AI suy diễn.
Phù hợp nhất với quy trình họp hội đồng quản trị và điều hành
decision-logger skill phù hợp nhất với nhà sáng lập, chief of staff, người vận hành hội đồng quản trị và các AI agent hỗ trợ những cuộc họp điều hành định kỳ. Skill này hợp với các quy trình mà quyết định cần được duy trì qua nhiều kỳ họp, có thể tìm lại về sau và được tách riêng khỏi ghi chú thảo luận. Nó đặc biệt hữu ích khi một quy trình kiểu board-meeting kết thúc bằng phê duyệt của founder và cần một bản ghi sạch, có thể kiểm tra lại.
Điểm khác biệt chính: chỉ lưu bộ nhớ đã được phê duyệt
Lựa chọn thiết kế mạnh nhất là tách biệt bản ghi thô với chỉ mục Lớp 2 đã được phê duyệt. Khi rà soát về sau, hệ thống đọc lớp đã duyệt, không đọc lại mọi lập luận trong cuộc họp. Cách này giúp ngăn các ý tưởng cũ đã bị bác bỏ xuất hiện trở lại như thể chúng vẫn còn khả thi. Template cũng có DO_NOT_RESURFACE, các trường supersession, ngày review và theo dõi owner, nên có tính vận hành cao hơn nhiều so với một prompt “tóm tắt ghi chú cuộc họp” thông thường.
Cần kiểm tra gì trước khi cài đặt
Trước khi dùng decision-logger, hãy xác nhận rằng đội ngũ của bạn sẵn sàng duy trì một chỉ mục quyết định cục bộ tại ~/.claude/decisions/approved/decisions.md. Python helper đi kèm đọc file này và có thể báo cáo các mục quá hạn, xung đột, hành động theo từng owner và tìm kiếm theo từ khóa. Nếu quy trình của bạn chưa phân biệt rõ quyết định đã phê duyệt với ghi chú thảo luận, có thể bạn cần điều chỉnh cách vận hành cuộc họp trước.
Cách sử dụng decision-logger skill
Cài đặt decision-logger và các file nên xem trước
Cài skill từ đường dẫn repository:
npx skills add alirezarezvani/claude-skills --skill decision-logger
Sau khi cài đặt, hãy đọc các file này theo thứ tự:
SKILL.md— giải thích mô hình bộ nhớ hai lớp, mục đích của slash command và các vị trí lưu trữ dự kiến.templates/decision-entry.md— cho thấy định dạng chính xác của một entry Lớp 2.scripts/decision_tracker.py— cung cấp các lệnh báo cáo cho summary, mục quá hạn, xung đột, lọc theo owner và tìm kiếm.
Script chỉ dùng Python standard library, nên bạn không cần thiết lập dependency ngoài việc có sẵn Python.
Input cần có để skill hoạt động tốt
Để dùng decision-logger hiệu quả, đừng chỉ đưa cho agent một bản tóm tắt cuộc họp sơ sài. Hãy cung cấp agenda item, quyết định cuối cùng đã được phê duyệt, owner chịu trách nhiệm, due date, review date, rationale, các phương án bị loại và mọi founder override nếu có. Template kỳ vọng mỗi entry chỉ có một quyết định, vì vậy hãy tách các kết quả bị gộp chung thành các bản ghi riêng.
Input yếu: “Log that we discussed pricing and decided to test something.”
Input tốt hơn: “Log the approved decision from the 2026-03-05 board meeting: move from flat pricing to a three-tier pilot for new customers. Owner: CRO. Deadline: 2026-04-15. Review: 2026-05-01. Rationale: improves expansion path while limiting migration risk. Rejected: immediate migration of all existing customers because support load is too high. Raw transcript path: ~/.claude/decisions/raw/2026-03-05-pricing.md.”
Quy trình thực tế sau cuộc họp
Hãy dùng decision-logger sau khi đã có phê duyệt, không dùng trong lúc cuộc tranh luận còn mở. Một quy trình đáng tin cậy là:
- Lưu hoặc tham chiếu bản transcript thô ở Lớp 1.
- Yêu cầu agent chỉ trích xuất các kết quả đã được founder phê duyệt.
- Tạo entry Lớp 2 bằng
templates/decision-entry.md. - Đánh dấu các phương án bị loại kèm lý do và
DO_NOT_RESURFACE. - Chạy tracker script để kiểm tra summary, hành động quá hạn hoặc xung đột.
Các lệnh hữu ích trong repository gồm:
python scripts/decision_tracker.py --demopython scripts/decision_tracker.py --summarypython scripts/decision_tracker.py --overduepython scripts/decision_tracker.py --conflictspython scripts/decision_tracker.py --owner "CTO"python scripts/decision_tracker.py --search "pricing"python scripts/decision_tracker.py --due-within 7
Mẫu prompt để tạo entry tốt hơn
Một lời gọi tốt nên yêu cầu tạo decision entry, không phải bản tóm tắt dạng kể chuyện. Ví dụ:
“Use the decision-logger skill to create a Layer 2 approved decision entry. Include one clear decision statement, one accountable owner, deadline, review date, rationale, rejected proposals with DO_NOT_RESURFACE, action items, supersedes fields if applicable, and the raw transcript path. Do not include unapproved discussion points.”
Cách đặt khung này giảm mơ hồ và giữ cho Lớp 2 đủ sạch để phục vụ Decision Support về sau.
FAQ về decision-logger skill
decision-logger chỉ dùng cho họp hội đồng quản trị phải không?
Skill này được thiết kế quanh bộ nhớ quyết định cho hội đồng quản trị và cấp C-level, nhưng cũng có thể dùng cho investment committee, leadership staff meeting, product council hoặc governance review. Điều kiện cốt lõi là quyết định phải được phê duyệt chính thức và cần được theo dõi sau đó. Nó kém hữu ích hơn với các buổi brainstorming không có quyết định cuối cùng.
Cách này tốt hơn việc yêu cầu AI tóm tắt biên bản họp ở điểm nào?
Một bản tóm tắt thông thường thường trộn lẫn thảo luận, khuyến nghị, phản đối và quyết định. decision-logger ép thông tin vào cấu trúc rõ ràng: quyết định đã duyệt, owner, deadline, rationale, phương án bị loại, action item, supersession và liên kết tới raw transcript. Chính cấu trúc đó mới cho phép rà soát về sau, kiểm tra quá hạn và phát hiện xung đột.
decision-logger skill có cần database không?
Không. Bằng chứng từ repository cho thấy skill này dùng lưu trữ bằng markdown và một script dựa trên Python standard-library. Chỉ mục Lớp 2 chính được kỳ vọng nằm tại ~/.claude/decisions/approved/decisions.md, đồng thời có hỗ trợ legacy cho một đường dẫn file khác thông qua --file. Cách này nhẹ và dễ dùng, nhưng các đội cần phân quyền nhiều người dùng, dashboard hoặc audit log có thể sẽ cần thêm công cụ bổ trợ.
Khi nào không nên dùng decision-logger?
Đừng dùng skill này làm nơi đổ mọi ghi chú cuộc họp. Nó cũng không phù hợp nếu quyết định thay đổi liên tục mà không có owner hoặc ngày tháng, hoặc nếu tổ chức của bạn không xác định được điều gì thực sự đã được phê duyệt. Trong những trường hợp đó, một meeting-notes skill hoặc tích hợp project-management có thể phù hợp hơn trước khi bổ sung bộ nhớ quyết định.
Cách cải thiện decision-logger skill
Cải thiện kết quả decision-logger bằng phê duyệt rõ ràng hơn
Yếu tố chất lượng quan trọng nhất là độ rõ của phê duyệt. Trước khi ghi log, hãy xác minh: Chính xác thì điều gì đã được quyết định? Ai chịu trách nhiệm? Đến khi nào? Điều gì đã bị bác bỏ rõ ràng? Các agent trong tương lai nên tránh khơi lại điều gì? Nếu thiếu bất kỳ thông tin nào trong số này, hãy hỏi tiếp thay vì tạo một entry mơ hồ.
Các lỗi thường gặp cần tránh
Hãy cảnh giác với các entry chứa nhiều quyết định trong một đoạn, quyền sở hữu chung nhưng không có người chịu trách nhiệm cuối cùng, deadline kiểu “soon,” rationale chỉ lặp lại quyết định, hoặc ý tưởng bị loại nhưng không có lý do. Những lỗi này làm suy yếu khả năng tìm kiếm và rà soát về sau. Các quy tắc trường trong template nên được xem là ràng buộc, không phải gợi ý.
Lặp lại sau entry đầu tiên do agent tạo
Sau khi agent nháp một entry, hãy review nó như một bản ghi vận hành. Rút gọn quyết định còn một câu, chuyển tên hoặc vai trò thành một owner duy nhất, thay ngày tương đối bằng YYYY-MM-DD, và đảm bảo action item có thể kiểm tra được. Sau đó chạy --summary, --overdue hoặc --conflicts để xác minh entry hoạt động tốt trong tracker.
Mở rộng skill theo mô hình vận hành của bạn
Các đội có thể cải thiện decision-logger bằng cách thêm agenda tag nhất quán, nhãn board committee, mức độ rủi ro, loại quyết định hoặc liên kết đến project ticket. Hãy giữ các phần mở rộng tương thích với markdown index và tránh thêm những trường không ai duy trì. Mục tiêu không phải là tạo tài liệu phong phú hơn cho có; mục tiêu là Decision Support sạch hơn cho cuộc họp tiếp theo.