SkillsAdd

hoangvantuan/personal-assistant · Archived

pk-reflect

Rút bài học từ cả phiên làm việc (quét toàn bộ hội thoại).

First seen Jun 10, 2026

Installation

$ npx skills add hoangvantuan/personal-assistant --skill pk-reflect
View on skills.sh ↗ GitHub repository ↗

Summary

  • Rút bài học từ cả phiên làm việc (quét toàn bộ hội thoại).
  • Light (mặc định): quét nhanh phiên, trích bài học.
  • Deep: phỏng vấn AAR 5 câu chuyên sâu.
  • Dùng khi user nói 'rút bài học', 'retro', 'tổng kết phiên', 'rút kinh nghiệm', 'AAR', hoặc vừa kết thúc một giai đoạn và muốn nhìn lại.
  • Output đi vào inbox qua pk-capture.
  • KHÔNG dùng khi chỉ ghi 1 mẩu rời (dùng pk-capture) hoặc đúc kết inbox đã tích (dùng pk-distill).

Stronger alternatives

This repository is archived — consider an actively maintained alternative.

pk-shared Same source · more installs
hoangvantuan/personal-assistant

Thư viện reference nội bộ cho bộ pk-* (schemas, metrics, quality gate). KHÔNG BAO GIỜ gọi trực …

14 installs
pk-lint Same source · more installs
hoangvantuan/personal-assistant

Kiểm tra sức khoẻ hệ thống .cockpit/: link hỏng, registry lệch, file mồ côi, schema cũ.

14 installs
pk-init Same source · more installs
hoangvantuan/personal-assistant

Khởi tạo dự án mới hoặc sửa KR target/mục tiêu/constraints/tools (cấu trúc mục tiêu).

14 installs
pk-analyze Same source · more installs
hoangvantuan/personal-assistant

Xem tình hình dự án, đo tiến độ, phân tích vấn đề. Read-only, không sửa file. Dùng khi user hỏi…

13 installs

Similar popular skills

Related neighbors and high-traction skills in the same topics — useful to compare before installing.

reflect Similar name
cursor/plugins

Spawn three parallel review subagents over the active transcript, surface learnings, and route …

1.8K installs
reflect Similar name
neolabhq/context-engineering-kit

Reflect on previus response and output, based on Self-refinement framework for iterative improv…

1.2K installs
mantis-reflect Similar name
google/mantis

>- Extracts learnings from execution trajectories at the end of a Mantis loop. Use to parse age…

40 installs
memory-reflect Similar name
basicmachines-co/basic-memory

Sleep-time memory reflection: review recent conversations and daily notes, extract insights, an…

18 installs
reflection Similar name
davidkiss/smart-ai-skills

MUST use this skill when user provides feedback / ask to do things in certain way, or when a to…

726 installs
memory-reflect Similar name
basicmachines-co/basic-memory-skills

Sleep-time memory reflection: review recent conversations and daily notes, extract insights, an…

719 installs

Also in this package

Other skills from hoangvantuan/personal-assistant · top by installs.

npx skills add hoangvantuan/personal-assistant
pk-shared 14 pk-lint 14 pk-init 14 pk-analyze 13 pk-track 13 pk-plan 12 pk-harness 12 pk-distill 12 pk-capture 12 pk-consult 11

Browse all from hoangvantuan/personal-assistant

More details

Agent compatibility

Declared targets from SKILL.md / docs. Unmarked agents are not listed — the skill may still install via the CLI.

Claude Code Not declared
Cursor Not declared
Codex Not declared
GitHub Copilot Not declared
Windsurf Not declared
Gemini CLI Not declared
Cline Not declared
OpenCode Not declared

Repository health

Default branch main
Open issues 0
Status Archived

Package contents

Files included with this skill beyond the listing page.

  • skill md SKILL.md 5,097 B
  • docs SUMMARY.md 525 B

History

  1. First seen on skills.sh
  2. First recorded snapshot · 12 installs

SKILL.md

PK Reflect: Rút bài học

Ensure snapshot (bắt buộc, đầu flow)

  1. Precondition: .cockpit/ tồn tại. Thiếu → route pk-init (mode new), KHÔNG nạp gì thêm, dừng.
  2. Idempotent qua marker: phiên CHƯA có marker SNAPSHOT_LOADED → tự nạp full theo Snapshot Contract

(../pk-shared/references/snapshot-contract.md) rồi đặt marker SNAPSHOT_LOADED. Đã có marker (vd harness Phase 1 đã đặt) → skip, không đọc lại.

2 mode: light (mặc định, rút nhanh từ phiên) và deep (phỏng vấn AAR 5 câu). Output → inbox.

Modes

Mode Trigger Mô tả
light Mặc định, "rút bài học", "retro" Quét phiên, trích candidates, bàn giao pk-capture
deep "AAR", "phỏng vấn sâu", user chỉ định rõ Phỏng vấn 5 câu + gọi pk-analyze lấy data

Nguyên tắc

  • Reflect KHÔNG ghi file trực tiếp vào knowledge/skills/workflows. Mọi output đi qua pk-capture → inbox.
  • Light rút nhanh. Deep phải chỉ định rõ.
  • Bàn giao cho pk-capture (cross-call lớp 2 → lớp 3) để giữ bất biến "một cửa inbox".

Flow: mode light (session extraction)

Bước 1: Quét phiên

Nhìn lại TOÀN BỘ hội thoại phiên. Tìm:

  • Chỗ user sửa/bác bỏ cách làm
  • Chỗ vướng, làm lại, hiểu nhầm
  • Quy ước/ràng buộc mới lộ ra
  • Pattern được phát hiện

Bước 2: Lọc chất lượng

Chỉ giữ bài học tái dùng được + không hiển nhiên + actionable.

Bước 3: Bàn giao pk-capture

Gọi pk-capture flow từ Bước 2 (trình candidates). Set captured_from: reflect-light. Capture lo: duyệt, ghi inbox, ghi log.

Flow: mode deep (AAR phỏng vấn)

Bước 1: Lấy data

Gọi pk-analyze với mode=deep, focus=full (cross-call lớp 2 → lớp 4) lấy metrics, trends, root cause. Đọc log gần nhất.

Degraded (khi .cockpit/ có nhưng KHÔNG có objective hoặc plan, tức "pk-reflect deep degraded" theo ../pk-shared/references/snapshot-contract.md, mục "Graceful Degradation"): phỏng vấn 5 câu VẪN chạy, nhưng bỏ phần metrics/trends (pk-analyze chỉ knowledge-only, data nghèo). Thông báo cho user biết mode degraded trước khi tiếp tục.

Bước 2: Chọn bối cảnh

Bối cảnh Tín hiệu Trọng tâm
Sau sự cố Vừa xử lý xong lỗi Nguyên nhân gốc + phòng ngừa
Sau milestone / cuối dự án Bàn giao xong Kỳ vọng vs thực tế
Định kỳ (sprint) User muốn retro Việc lặp + lỗi lặp

Bước 3: Phỏng vấn 5 câu

Hỏi TỪNG CÂU MỘT, chờ trả lời:

  1. Kỳ vọng: Ban đầu định đạt gì?
  2. Thực tế: Kết quả thật ra sao? Lệch chỗ nào?
  3. Nguyên nhân gốc: Tại sao lệch? ("tại sao?" >= 3 lớp)
  4. Bài học: 1 câu cho người ngoài hiểu. Khi nào áp dụng, khi nào KHÔNG?
  5. Hành động hệ thống: Cái gì trong hệ thống phải đổi?

Bước 4: Tổng hợp candidates

Từ phỏng vấn, tách thành candidates theo type trong ../pk-shared/references/schemas.md mục "Inbox item thống nhất" (nguồn type DUY NHẤT):

  • 1 item lesson (lõi phiên, bắt buộc)
  • 0-n item thuộc bất kỳ type nào khả dĩ từ phỏng vấn (ví dụ: decision, pattern, troubleshooting, concept, resource, blocker, candidate-skill, candidate-workflow)

Không liệt danh sách cứng ở đây. Mọi type hợp lệ đã định nghĩa trong schemas.md.

Bước 5: Bàn giao pk-capture

Set captured_from: reflect-deep. Nguồn raw: nguyên văn hỏi-đáp phỏng vấn.

Quy tắc phỏng vấn (mode deep)

  • Gợi nhớ bằng dữ kiện, không hỏi chay.
  • Không phán xét. "Do tôi quên" → "vì sao quên được, hệ thống thiếu chốt chặn nào?"
  • Một lần phản tư, một chủ đề.
  • Ngắn: 10-15 phút. Đủ 5 câu dừng.
  • User trả lời nông → chấp nhận. Bài học nông hơn không gì.

Quy tắc cứng

  1. Reflect KHÔNG ghi vào knowledge, skills, workflows, inbox. Mọi kết quả qua pk-capture.
  2. Hỏi từng câu. CẤM dán 5 câu thành bảng hỏi.
  3. Câu 5 (hành động hệ thống) bắt buộc. Bài học không kèm thay đổi hệ thống sẽ bị quên.
  4. Trích nguyên văn lời user trong raw. Không diễn đạt lại.