jim60105/contribution-showcase

Latest recorded source activity: May 11, 2026 at 05:06

SkillsMP catalog refreshed: November 9, 2026 at 14:22

skills collected: 4

GitHub stars: 4
GitHub forks: 1

Install with an AI assistant

Copy this prompt into the AI assistant you're using.

Follow https://skillsmp.com/skill-install/prompt.md to install Agent Skills from https://github.com/jim60105/contribution-showcase.

Repository README

Repository README source: README.md

Read the source README

Expand full README

# contribution-showcase ![Preview image](docs/preview.png) [![GitHub Pages](https://img.shields.io/badge/Live_Demo-GitHub_Pages-blue)](https://jim60105.github.io/contribution-showcase/contribution-showcase.html) [![crates.io](https://img.shields.io/crates/v/contribution-showcase)](https://crates.io/crates/contribution-showcase) [![Build, Test, Audit & Coverage](https://github.com/jim60105/contribution-showcase/actions/workflows/build-test-audit-coverage.yml/badge.svg)](https://github.com/jim60105/contribution-showcase/actions/workflows/build-test-audit-coverage.yml) [![Release](https://github.com/jim60105/contribution-showcase/actions/workflows/release.yml/badge.svg)](https://github.com/jim60105/contribution-showcase/actions/workflows/release.yml) [![codecov](https://codecov.io/gh/jim60105/contribution-showcase/graph/badge.svg?token=yAi5wZRrEK)](https://codecov.io/gh/jim60105/contribution-showcase) [![License: GPL-3.0](https://img.shields.io/github/license/jim60105/contribution-showcase)](LICENSE) 一個 Rust CLI 工具，掃描多個 Git 儲存庫的提交紀錄，產生一頁式 HTML 貢獻總覽報告。 ## 功能 - 讀取 TOML 設定檔（`showcase.toml`），支援多專案、篩選條件與輸出設定 - 解析 Conventional Commit 格式，依類型統計提交分佈 - 統計程式碼異動行數（新增／刪除） - 收集 OpenSpec 提案清單 - 產生獨立 HTML 報告，包含： - 提交時間軸視覺化 - Conventional Commit 類型分佈圖 - 各專案統計資訊 - 測試覆蓋率資訊 ## 線上展示 👉 [查看線上範例](https://jim60105.github.io/contribution-showcase/contribution-showcase.html) ## 快速開始 ### 前置需求 - [Rust](https://www.rust-lang.org/) 工具鏈（`cargo`） - Git ### 安裝與建置 **從 crates.io 安裝（推薦）：** ```bash cargo install contribution-showcase ``` **從原始碼建置：** ```bash cargo build --release ``` 編譯產物位於 `target/release/contribution-showcase`。 ### 使用流程 1. 建立起始設定檔： ```bash contribution-showcase init ``` 2. 編輯 `showcase.toml`，設定要掃描的儲存庫路徑與篩選條件。 3. 產生報告： ```bash contribution-showcase generate ``` 報告預設輸出至 `dist/index.html`。 ## 設定檔設定檔為 TOML 格式，結構如下（完整範例請參考 `showcase.example.toml`）： ```toml # 報告標題（選填） title = "My Contribution Showcase" # 輸出設定（選填） [output] path = "dist/index.html" # timeline_max_buckets = 14 # 時間軸最大分段數（預設：14） # 全域篩選條件（選填） [filters] author = "Jane Doe" # 依作者名稱篩選 since = "2025-01-01" # 起始日期（YYYY-MM-DD） until = "2025-06-30" # 結束日期（YYYY-MM-DD） types = ["feat", "fix"] # 限定 Conventional Commit 類型 exclude_hashes = ["e3b0..."] # 排除特定 commit SHA # 專案清單（至少一筆） [[projects]] name = "my-backend" path = "../my-backend" description = "REST API server" branch = "main" coverage_command = "cargo llvm-cov --cobertura --output-path coverage.xml" coverage_result_path = "coverage.xml" ``` **必填欄位：** `name`、`path`。其餘欄位皆為選填。 > **CLI 覆寫：** `--title`、`--types`、`--exclude-hashes` 等 CLI 旗標會覆寫設定檔中的對應值。以逗號分隔的輸入會自動去除空白並轉為小寫。 ## CLI 用法 ### `generate` — 產生報告 ```bash contribution-showcase generate [OPTIONS] ``` | 選項 | 說明 | |---|---| | `-c, --config <FILE>` | 設定檔路徑（預設：`showcase.toml`） | | `-o, --output <FILE>` | 輸出路徑（覆寫設定檔中的值） | | `--author <NAME>` | 依作者篩選（覆寫設定檔中的值） | | `--since <DATE>` | 起始日期 YYYY-MM-DD（覆寫設定檔中的值） | | `--until <DATE>` | 結束日期 YYYY-MM-DD（覆寫設定檔中的值） | | `--title <TITLE>` | 報告標題（覆寫設定檔中的值，同時影響預設輸出檔名） | | `--types <TYPES>` | 以逗號分隔的 Conventional Commit 類型篩選（覆寫設定檔），例如 `feat,fix,docs` | | `--exclude-hashes <HASHES>` | 以逗號分隔的 commit SHA 排除清單（覆寫設定檔） | | `--timeline-max-buckets <N>` | 時間軸最大分段數，超過時自動提升時間粒度（預設：14） | ### `init` — 建立起始設定檔 ```bash contribution-showcase init [OPTIONS] ``` | 選項 | 說明 | |---|---| | `-o, --output <FILE>` | 設定檔輸出路徑（預設：`showcase.toml`） | ## License <img src="https://github.com/user-attachments/assets/c5def3ed-2715-4ef3-9a0c-00bada48b583" alt="gplv3" width="300" /> [GNU GENERAL PUBLIC LICENSE Version 3](LICENSE) Copyright (C) 2026 Jim Chen <Jim@ChenJ.im>. This program is free software: you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version. This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details. You should have received a copy of the GNU General Public License along with this program. If not, see [https://www.gnu.org/licenses/](https://www.gnu.org/licenses/).

Loading the repository README…

Skills in this repository

Project Management Specialists Computer Systems Analysts Software Developers

3 occupation categories · 100% classified

skill

occupation

description

updated

openspec-apply-change

Software Developers

Implement tasks from an OpenSpec change. Use when the user wants to start implementing, continue implementation, or work through tasks.

2026-05-11

openspec-archive-change

Project Management Specialists

Archive a completed change in the experimental workflow. Use when the user wants to finalize and archive a change after implementation is complete.

2026-05-11

openspec-explore

Project Management Specialists

Enter explore mode - a thinking partner for exploring ideas, investigating problems, and clarifying requirements. Use when the user wants to think through something before or during a change.

2026-05-11

openspec-propose

Computer Systems Analysts

Propose a new change with all artifacts generated in one step. Use when the user wants to quickly describe what they want to build and get a complete proposal with design, specs, and tasks ready for implementation.

2026-05-11

Showing 4 of 4 collected skills.