@duckmind/deepquark-darwin-arm64 0.9.78 → 0.9.81

package/.deepquark/skills/bundled/excel-analysis/SKILL.md

@@ -0,0 +1,247 @@
+---
+name: Excel Analysis
+description: Analyze Excel spreadsheets, create pivot tables, generate charts, and perform data analysis. Use when analyzing Excel files, spreadsheets, tabular data, or .xlsx files.
+---
+
+# Excel Analysis
+
+## Quick start
+
+Read Excel files with pandas:
+
+```python
+import pandas as pd
+
+# Read Excel file
+df = pd.read_excel("data.xlsx", sheet_name="Sheet1")
+
+# Display first few rows
+print(df.head())
+
+# Basic statistics
+print(df.describe())
+```
+
+## Reading multiple sheets
+
+Process all sheets in a workbook:
+
+```python
+import pandas as pd
+
+# Read all sheets
+excel_file = pd.ExcelFile("workbook.xlsx")
+
+for sheet_name in excel_file.sheet_names:
+    df = pd.read_excel(excel_file, sheet_name=sheet_name)
+    print(f"\n{sheet_name}:")
+    print(df.head())
+```
+
+## Data analysis
+
+Perform common analysis tasks:
+
+```python
+import pandas as pd
+
+df = pd.read_excel("sales.xlsx")
+
+# Group by and aggregate
+sales_by_region = df.groupby("region")["sales"].sum()
+print(sales_by_region)
+
+# Filter data
+high_sales = df[df["sales"] > 10000]
+
+# Calculate metrics
+df["profit_margin"] = (df["revenue"] - df["cost"]) / df["revenue"]
+
+# Sort by column
+df_sorted = df.sort_values("sales", ascending=False)
+```
+
+## Creating Excel files
+
+Write data to Excel with formatting:
+
+```python
+import pandas as pd
+
+df = pd.DataFrame({
+    "Product": ["A", "B", "C"],
+    "Sales": [100, 200, 150],
+    "Profit": [20, 40, 30]
+})
+
+# Write to Excel
+writer = pd.ExcelWriter("output.xlsx", engine="openpyxl")
+df.to_excel(writer, sheet_name="Sales", index=False)
+
+# Get worksheet for formatting
+worksheet = writer.sheets["Sales"]
+
+# Auto-adjust column widths
+for column in worksheet.columns:
+    max_length = 0
+    column_letter = column[0].column_letter
+    for cell in column:
+        if len(str(cell.value)) > max_length:
+            max_length = len(str(cell.value))
+    worksheet.column_dimensions[column_letter].width = max_length + 2
+
+writer.close()
+```
+
+## Pivot tables
+
+Create pivot tables programmatically:
+
+```python
+import pandas as pd
+
+df = pd.read_excel("sales_data.xlsx")
+
+# Create pivot table
+pivot = pd.pivot_table(
+    df,
+    values="sales",
+    index="region",
+    columns="product",
+    aggfunc="sum",
+    fill_value=0
+)
+
+print(pivot)
+
+# Save pivot table
+pivot.to_excel("pivot_report.xlsx")
+```
+
+## Charts and visualization
+
+Generate charts from Excel data:
+
+```python
+import pandas as pd
+import matplotlib.pyplot as plt
+
+df = pd.read_excel("data.xlsx")
+
+# Create bar chart
+df.plot(x="category", y="value", kind="bar")
+plt.title("Sales by Category")
+plt.xlabel("Category")
+plt.ylabel("Sales")
+plt.tight_layout()
+plt.savefig("chart.png")
+
+# Create pie chart
+df.set_index("category")["value"].plot(kind="pie", autopct="%1.1f%%")
+plt.title("Market Share")
+plt.ylabel("")
+plt.savefig("pie_chart.png")
+```
+
+## Data cleaning
+
+Clean and prepare Excel data:
+
+```python
+import pandas as pd
+
+df = pd.read_excel("messy_data.xlsx")
+
+# Remove duplicates
+df = df.drop_duplicates()
+
+# Handle missing values
+df = df.fillna(0)  # or df.dropna()
+
+# Remove whitespace
+df["name"] = df["name"].str.strip()
+
+# Convert data types
+df["date"] = pd.to_datetime(df["date"])
+df["amount"] = pd.to_numeric(df["amount"], errors="coerce")
+
+# Save cleaned data
+df.to_excel("cleaned_data.xlsx", index=False)
+```
+
+## Merging and joining
+
+Combine multiple Excel files:
+
+```python
+import pandas as pd
+
+# Read multiple files
+df1 = pd.read_excel("sales_q1.xlsx")
+df2 = pd.read_excel("sales_q2.xlsx")
+
+# Concatenate vertically
+combined = pd.concat([df1, df2], ignore_index=True)
+
+# Merge on common column
+customers = pd.read_excel("customers.xlsx")
+sales = pd.read_excel("sales.xlsx")
+
+merged = pd.merge(sales, customers, on="customer_id", how="left")
+
+merged.to_excel("merged_data.xlsx", index=False)
+```
+
+## Advanced formatting
+
+Apply conditional formatting and styles:
+
+```python
+import pandas as pd
+from openpyxl import load_workbook
+from openpyxl.styles import PatternFill, Font
+
+# Create Excel file
+df = pd.DataFrame({
+    "Product": ["A", "B", "C"],
+    "Sales": [100, 200, 150]
+})
+
+df.to_excel("formatted.xlsx", index=False)
+
+# Load workbook for formatting
+wb = load_workbook("formatted.xlsx")
+ws = wb.active
+
+# Apply conditional formatting
+red_fill = PatternFill(start_color="FF0000", end_color="FF0000", fill_type="solid")
+green_fill = PatternFill(start_color="00FF00", end_color="00FF00", fill_type="solid")
+
+for row in range(2, len(df) + 2):
+    cell = ws[f"B{row}"]
+    if cell.value < 150:
+        cell.fill = red_fill
+    else:
+        cell.fill = green_fill
+
+# Bold headers
+for cell in ws[1]:
+    cell.font = Font(bold=True)
+
+wb.save("formatted.xlsx")
+```
+
+## Performance tips
+
+- Use `read_excel` with `usecols` to read specific columns only
+- Use `chunksize` for very large files
+- Consider using `engine='openpyxl'` or `engine='xlrd'` based on file type
+- Use `dtype` parameter to specify column types for faster reading
+
+## Available packages
+
+- **pandas** - Data analysis and manipulation (primary)
+- **openpyxl** - Excel file creation and formatting
+- **xlrd** - Reading older .xls files
+- **xlsxwriter** - Advanced Excel writing capabilities
+- **matplotlib** - Chart generation

package/.deepquark/skills/bundled/ge-payroll/SKILL.md

@@ -0,0 +1,153 @@
+---
+name: ge-payroll
+description: |
+  **GE Payroll Process Expert**: Comprehensive knowledge base and assistant for Golden Elephant (GE) payroll operations. Covers the entire monthly payroll cycle: employee data collection, masterlist management, timesheet processing, BHXH (social insurance) compliance, KPI/COM calculation, salary computation, approval workflow, and staff cost reporting.
+
+  MANDATORY TRIGGERS: payroll, tính lương, chấm công, BHXH, bảo hiểm xã hội, masterlist, C&B, bảng lương, phiếu lương, timesheet, manday, staff cost, KPI/COM, phân bổ CF, cost factor, trích nộp BHXH, thuế TNCN, PIT, quy trình lương, payslip, Golden Elephant, GE payroll, nghiệp vụ lương, compensation & benefits
+
+  Use this skill whenever the user asks about payroll processes, wants to create payroll-related documents (presentations, reports, spreadsheets), needs to understand the GE payroll workflow, wants to analyze pain points and propose improvements, or needs guidance on any step of the monthly payroll cycle. Also trigger when discussing HR operations, employee onboarding/offboarding impacts on payroll, BHXH compliance, or staff cost allocation — even if they don't explicitly mention "payroll".
+---
+
+# GE Payroll Process - Comprehensive Skill
+
+You are a payroll operations expert for Golden Elephant (GE). You have deep knowledge of GE's monthly payroll cycle — a process that spans ~14.3 mandays per month across 18 major steps involving 8+ stakeholders.
+
+## How to Use This Skill
+
+This skill gives you two levels of information:
+
+1. **This file (SKILL.md)** — The overview, key metrics, process summary, and guidance for common tasks. This should be enough for most questions.
+2. **Reference files** — For detailed step-by-step procedures, pain point analysis, RACI matrix, and automation roadmap. Read these when you need depth:
+   - `references/process-detail.md` — Full 18-step process with inputs, actions, risks, timing, and automation ideas
+   - `references/timeline-mandays.md` — Day-by-day timeline with manday breakdown per task
+   - `references/pain-points-improvements.md` — 10+ pain points, impact analysis, and 3-phase improvement roadmap
+   - `references/raci-stakeholders.md` — RACI matrix and stakeholder responsibilities
+
+## Process Overview
+
+GE's payroll runs on a **monthly cycle** from day 27 of the previous month to day 17 of the current month:
+
+### The 3 Main Phases
+
+**Phase 1: Thu thập thông tin (Data Collection)** — Day 27 to Day 3
+- Collect employee on/off info, update Masterlist
+- Gather CF (Cost Factor) allocation from department Heads
+- Process BHXH (social insurance) enrollment/withdrawal
+- Process timesheets from multiple sources (fingerprint, Excel, Power App, email)
+- Calculate KPI/COM/CTV compensation
+
+**Phase 2: Tính lương (Payroll Calculation)** — Day 2 to Day 3
+- Set up payroll form with employee data
+- Import timesheet data, verify against Masterlist
+- Calculate: base salary, BHXH deductions, KPI/COM/bonus, OT, welfare, PIT
+- Double-check net salary vs. previous month
+
+**Phase 3: Phê duyệt & Chi trả (Approval & Payment)** — Day 5 to Day 10
+- C&B Manager review → HRM/BOM approval → F&A/BOM approve base request
+- Process payment via e-Banking
+- Send payslips, archive records
+- Submit BHXH documentation to authorities (Day 12-17)
+
+### Key Metrics
+
+| Metric | Value |
+|--------|-------|
+| Total mandays/month | 14.3 |
+| Process steps | 18 |
+| Stakeholders | 8+ (TA, C&B, HRM, BOM, F&A, Head/BU, IT, Kế toán) |
+| Cycle | Monthly (Day 27 → Day 17) |
+| Legal entities | 7 pháp nhân |
+| Major pain points | 10+ |
+| Current system | Manual + Excel |
+
+### Data Flow
+
+```
+Inputs → MASTERLIST → Processing → PAYROLL → Outputs
+
+Inputs:                    Processing:           Outputs:
+- Thông tin NV on/off      - DSNV Phân bổ NS    - PAYMENT SALARY
+- Thông tin ký HĐLĐ       - DS Chấm công        - REPORT STAFF COST
+- Các TT nhân sự khác     - DS trích BHXH       - PIT Declaration
+                           - KPI/COM/CTV/GV      - BHXH Report
+                           - OT/Welfare/Add/Deduct - Documentation
+```
+
+## Stakeholders Quick Reference
+
+- **TA (Talent Acquisition)**: Provides new employee info → C&B
+- **C&B (Compensation & Benefits)**: Core process owner — runs the entire payroll cycle
+- **HRM (HR Manager)**: Approves payroll
+- **BOM (Board of Management)**: Final approval
+- **F&A (Finance & Accounting)**: Verifies and processes salary payment
+- **Head/BU (Department Heads)**: CF allocation, timesheet confirmation, KPI/COM data
+- **IT**: Exports attendance raw data from fingerprint system
+- **Kế toán (Accountant)**: Provides revenue data for COM calculation
+- **Cơ quan BHXH**: Receives enrollment docs, issues C12 for reconciliation
+- **NV (Employee)**: Provides personal info, receives payslip
+
+## Common Tasks & How to Handle Them
+
+### When asked to explain the process
+Provide a clear, phased explanation. Start with the overview, then drill into whichever phase the user is asking about. Reference the timeline (read `references/timeline-mandays.md`) for specific dates and effort.
+
+### When asked to create a presentation
+Use the PPTX skill alongside this one. Structure the deck following GE's established format:
+1. Title + Agenda
+2. Overview with key metrics
+3. Data flow diagram explanation
+4. Detailed phases (with timeline)
+5. Pain points analysis
+6. Improvement roadmap (3 phases: Quick Wins → Strategic → Transformation)
+7. RACI matrix
+8. ROI projections
+
+### When asked to analyze pain points or propose improvements
+Read `references/pain-points-improvements.md` for the full analysis. The top pain points are:
+1. Incomplete/inaccurate employee info from TA
+2. Late responses from department Heads
+3. Heavily manual processes (Excel-based)
+4. No integrated HRIS system
+5. BHXH/Tax compliance risks from late reporting
+6. Multi-department dependencies creating bottlenecks
+7. Lack of standardized processes across departments
+8. No visibility or tracking dashboard
+
+### When asked about compliance (BHXH, Tax)
+Read `references/process-detail.md` for BHXH conditions and PIT calculation details. Key rules:
+- BHXH eligibility: Must have HĐLĐ + unpaid leave ≤ 14 days/month
+- PIT: Determine tax type, NPT deductions per employee
+- C12 reconciliation: Monthly comparison with BHXH authority figures
+- Late reporting risks: Must file adjustment + explanation to BHXH
+
+### When asked to create a report or spreadsheet
+Use the XLSX or DOCX skill as appropriate. Common report types:
+- Payment Salary (chi trả lương)
+- Staff Cost Report (báo cáo chi phí nhân sự per 7 legal entities)
+- PIT Declaration (tờ khai thuế TNCN)
+- BHXH Report
+- Manday tracking report
+
+### When asked about automation or HRIS
+Read `references/pain-points-improvements.md` for the 3-phase roadmap:
+- **Phase 1 (Quick Wins, 1-2 months)**: Validated forms, deadline reminders, standardized templates, basic dashboard
+- **Phase 2 (Strategic, 3-6 months)**: Power Automate, unified attendance, Employee Self-Service, offboarding workflow
+- **Phase 3 (Transformation, 6-12 months)**: Full HRIS, end-to-end payroll automation, AI analytics
+
+Expected outcomes: 40-50% time reduction, 80% fewer errors, 100% visibility, ROI in 6-8 months.
+
+## Language Notes
+
+This is a Vietnamese business context. Use Vietnamese terminology naturally when communicating with Vietnamese-speaking users. Key terms:
+- Bảng lương = Payroll sheet
+- Chấm công = Timesheet/Attendance
+- Phiếu lương = Payslip
+- Trích nộp BHXH = Social insurance deduction
+- Phân bổ CF = Cost factor allocation
+- Pháp nhân = Legal entity
+- HĐLĐ = Labor contract (Hợp đồng lao động)
+- PLHĐ = Contract appendix (Phụ lục hợp đồng)
+- Thuế TNCN/PIT = Personal income tax
+- NPT = Người phụ thuộc (Dependents for tax deduction)
+- CTV = Cộng tác viên (Collaborator/Freelancer)
+- GV = Giáo viên (Teacher)

package/.deepquark/skills/bundled/ge-payroll/evals/evals.json

@@ -0,0 +1,23 @@
+{
+  "skill_name": "ge-payroll",
+  "evals": [
+    {
+      "id": 1,
+      "prompt": "Tôi là C&B mới vào GE, bạn giải thích cho tôi quy trình tính lương hàng tháng gồm những bước gì, ai phụ trách và timeline cụ thể ra sao?",
+      "expected_output": "Giải thích đầy đủ 3 giai đoạn chính (Thu thập TT → Tính lương → Phê duyệt & Chi trả) với 18 bước, timeline từ ngày 27 đến ngày 17, và stakeholders cho mỗi bước. Nên đề cập 14.3 mandays tổng cộng.",
+      "files": []
+    },
+    {
+      "id": 2,
+      "prompt": "Phân tích cho tôi các pain points chính trong quy trình payroll hiện tại của GE và đề xuất lộ trình cải tiến 3 giai đoạn. Tôi muốn output là file markdown chi tiết.",
+      "expected_output": "File markdown liệt kê 10+ pain points với mô tả, impact, và đề xuất. Roadmap 3 phase: Quick Wins (1-2 tháng), Strategic (3-6 tháng), Transformation (6-12 tháng) với ROI projections.",
+      "files": []
+    },
+    {
+      "id": 3,
+      "prompt": "Quy trình trích nộp BHXH trong payroll GE hoạt động như thế nào? Điều kiện tham gia BHXH là gì? Ai chịu trách nhiệm và timeline ra sao?",
+      "expected_output": "Giải thích chi tiết bước 3 (Trích nộp BHXH): điều kiện (có HĐLĐ + nghỉ KL ≤ 14 ngày), timeline (ngày 27-30 chuẩn bị, 12-15 nộp, 15-17 đối chiếu), quy trình đối chiếu C12, rủi ro báo muộn.",
+      "files": []
+    }
+  ]
+}

package/.deepquark/skills/bundled/ge-payroll/references/pain-points-improvements.md

@@ -0,0 +1,106 @@
+# GE Payroll - Pain Points & Improvement Roadmap
+
+## 10+ Pain Points Analysis
+
+### 1. Thông tin không đầy đủ/chính xác
+- **Mô tả**: TA không cung cấp đủ thông tin NV mới, sai line phòng ban/title
+- **Impact**: C&B mất thời gian check lại với thuế/BHXH/NH, back lại Head confirm
+- **Đề xuất**: Form TTNV có validation, cảnh báo thiếu trường trước khi sync Master data
+
+### 2. Head phản hồi không đúng thời hạn
+- **Mô tả**: Head không phản hồi đúng thời gian đánh giá HĐLĐ, phân bổ CF trễ
+- **Impact**: Phải làm lại báo cáo nhiều lần, điều chỉnh sau kỳ lương
+- **Đề xuất**: Hệ thống cảnh báo tự động, deadline workflow với escalation
+
+### 3. Quy trình thủ công, mất thời gian
+- **Mô tả**: Phân bổ CF nhỏ lẻ từng cá nhân = manual. Collect thông tin qua email dễ miss. Tracking nghỉ phép/OT qua email
+- **Impact**: 14.3 mandays/tháng, phần lớn là manual work trên Excel
+- **Đề xuất**: Tự động hóa với Power Automate, tích hợp dữ liệu từ nhiều nguồn
+
+### 4. Thiếu hệ thống tích hợp (No HRIS)
+- **Mô tả**: Khó truy xuất PLHĐ/HĐLĐ. Master data chưa đáp ứng truy xuất. Theo dõi bằng file Excel riêng
+- **Impact**: Dữ liệu phân tán, thiếu single source of truth
+- **Đề xuất**: HRIS tích hợp, Employee Self-Service Portal
+
+### 5. Rủi ro tuân thủ BHXH/Thuế
+- **Mô tả**: Nghỉ việc báo muộn → giải trình BHXH. Thay đổi mức lương báo sau kỳ. CTV/GV thay đổi hình thức liên tục
+- **Impact**: Phải điều chỉnh tháng kế tiếp, làm hồ sơ giải trình, rủi ro vi phạm
+- **Đề xuất**: Quy trình offboarding chặt chẽ, cảnh báo sớm khi có thay đổi
+
+### 6. Phụ thuộc nhiều bộ phận
+- **Mô tả**: C&B phụ thuộc TA, Head, BU, Kế toán, IT. 8+ stakeholders = nhiều điểm chờ
+- **Impact**: Bottleneck khi 1 bộ phận chậm, toàn bộ process bị delay
+- **Đề xuất**: SLA rõ ràng, escalation process, dashboard theo dõi tiến độ
+
+### 7. Thiếu chuẩn hóa quy trình
+- **Mô tả**: Các bộ phận chấm công khác nhau (Excel + Power App + Email + Vân tay). Không có form yêu cầu cụ thể cho nhiều thay đổi
+- **Impact**: C&B phải xử lý nhiều format, dễ sai sót
+- **Đề xuất**: Chuẩn hóa input/output, single source of truth cho chấm công
+
+### 8. Thiếu visibility & tracking
+- **Mô tả**: Không biết ai đã phản hồi/chưa. Khó track tiến độ từng bước. Follow up manual qua email
+- **Impact**: Mất thời gian follow up, dễ miss deadline
+- **Đề xuất**: Dashboard tracking, notification system, KPI metrics
+
+### 9. NV Sales Part-time thay đổi hình thức liên tục
+- **Mô tả**: CTV/GV thay đổi hình thức làm việc (full-time ↔ part-time ↔ freelancer)
+- **Impact**: Cản trở apply công thức COM chung, phải điều chỉnh tay
+- **Đề xuất**: Hệ thống tracking loại hình NV với rules tự động
+
+### 10. Phân bổ CF quá nhỏ lẻ
+- **Mô tả**: 1 cá nhân có thể được phân bổ nhiều CF khác nhau → mỗi CF = 1 dòng riêng trong báo cáo
+- **Impact**: Báo cáo cho 7 pháp nhân rất phức tạp, hoàn toàn manual
+- **Đề xuất**: Tự động tách dòng CF trong báo cáo
+
+---
+
+## 3-Phase Improvement Roadmap
+
+### Phase 1: Quick Wins (1-2 tháng)
+**Effort: Thấp | Impact: Cao**
+
+1. Form TTNV có validation tự động
+2. Deadline workflow cho Head (reminder email tự động)
+3. Chuẩn hóa input templates cho tất cả bộ phận
+4. Dashboard tracking cơ bản (ai đã phản hồi/chưa)
+5. SLA rõ ràng cho từng bộ phận (timeline + escalation)
+
+### Phase 2: Strategic (3-6 tháng)
+**Effort: Trung bình | Impact: Cao**
+
+1. Tự động hóa với Power Automate (collect data, send reminders, route approvals)
+2. Tích hợp chấm công unified (1 nguồn duy nhất thay vì 4 nguồn)
+3. Employee Self-Service Portal (NV tự cập nhật thông tin, đăng ký phép/OT)
+4. Quy trình offboarding chặt chẽ trên system
+5. Real-time notification system (approval alerts, deadline warnings)
+
+### Phase 3: Transformation (6-12 tháng)
+**Effort: Cao | Impact: Rất cao**
+
+1. HRIS tích hợp toàn diện
+   - Single source of truth cho tất cả dữ liệu HR
+   - Workflow automation end-to-end
+   - Approval chains tự động
+2. Payroll automation
+   - Tích hợp với hệ thống chấm công
+   - Tự động tính toán các khoản phát sinh
+   - Auto-generate reports cho 7 pháp nhân
+3. Advanced Analytics
+   - AI-assisted anomaly detection
+   - Predictive analytics cho budget planning
+   - Employee cost analytics dashboard
+
+---
+
+## ROI Projections
+
+| Metric | Hiện tại | Sau Phase 2 | Sau Phase 3 |
+|--------|----------|-------------|-------------|
+| Mandays/tháng | 14.3 | ~7 | ~4 |
+| Tỷ lệ sai sót | Cao | Giảm 60% | Giảm 80% |
+| Visibility | Thấp | 80% | 100% |
+| Compliance risk | Cao | Trung bình | Thấp |
+| Employee experience | Thấp | Trung bình | Cao |
+
+**Tiết kiệm mandays/năm**: ~84 mandays (sau Phase 2), ~120 mandays (sau Phase 3)
+**ROI ước tính**: Hoàn vốn sau 6-8 tháng triển khai Phase 1 & 2