chore: initial public release

Co-authored-by: lbfsc <kongtang.lb@alibaba-inc.com>
Co-authored-by: zpzjzj <lisa.zp@alibaba-inc.com>
Co-authored-by: lijunfeng722 <ljf242059@alibaba-inc.com>

Author: 3 people

.editorconfig

@@ -0,0 +1,19 @@
+# https://editorconfig.org/
+root = true
+
+[*]
+charset = utf-8
+end_of_line = lf
+insert_final_newline = true
+trim_trailing_whitespace = true
+
+[*.go]
+indent_style = tab
+indent_size = 8
+
+[*.{yml,yaml}]
+indent_style = space
+indent_size = 2
+
+[Makefile]
+indent_style = tab

.githooks/commit-msg

@@ -0,0 +1,38 @@
+#!/bin/sh
+# Enforce Conventional Commits on the subject line (first line).
+# https://www.conventionalcommits.org/
+
+set -e
+
+msg_file=$1
+first_line=$(head -n1 "$msg_file")
+
+# Merge / revert commits from Git and GitHub
+case "$first_line" in
+Merge\ *|"Revert "*)
+	exit 0
+	;;
+esac
+
+# Optional body may follow; subject must match.
+pattern='^(feat|fix|docs|style|refactor|perf|test|build|ci|chore|revert)(\([a-zA-Z0-9._/-]+\))?: .+'
+
+if ! printf '%s\n' "$first_line" | grep -qE "$pattern"; then
+	cat <<-'EOF' >&2
+	error: commit message does not follow Conventional Commits.
+
+	Subject line (first line) must look like:
+
+	  <type>(<optional-scope>): <description>
+
+	Examples:
+	  feat(cli): add validate command
+	  fix(config): correct default timeout
+	  docs: update CONTRIBUTING
+
+	Allowed types: feat, fix, docs, style, refactor, perf, test, build, ci, chore, revert
+
+	See CONTRIBUTING.md for details.
+	EOF
+	exit 1
+fi

.githooks/pre-commit

@@ -0,0 +1,59 @@
+#!/bin/sh
+# Run mandatory pre-commit checks and block the commit on any failure.
+#
+# Policy: enforce formatting/vet/revive on the whole tree (cheap and stable),
+# but only run golangci-lint **incrementally** against the merge base so
+# unrelated pre-existing issues do not block new commits. CI runs the full
+# scan via `make quality-ci`.
+#
+# To run the full scan locally instead of the incremental one:
+#     SKILL_UP_PRECOMMIT_FULL=1 git commit ...
+# To bypass entirely (discouraged, last resort):
+#     git commit --no-verify ...
+
+set -e
+
+# Ensure Go and repo-local tools are in PATH for non-interactive shells.
+for go_path in /opt/homebrew/bin /usr/local/go/bin "$HOME/go/bin" "$HOME/.local/bin"; do
+	if [ -d "$go_path" ]; then
+		PATH="$go_path:$PATH"
+	fi
+done
+export PATH
+
+ROOT=$(git rev-parse --show-toplevel)
+cd "$ROOT"
+PATH="$ROOT/.tools/bin:$PATH"
+export PATH
+
+if ! command -v make >/dev/null 2>&1; then
+	echo "error: make is required for pre-commit" >&2
+	exit 1
+fi
+
+if [ "${SKILL_UP_PRECOMMIT_FULL:-0}" = "1" ]; then
+	echo "[pre-commit] SKILL_UP_PRECOMMIT_FULL=1 -> running full 'make verify'"
+	make verify
+	exit 0
+fi
+
+# Always-on cheap checks (whole tree).
+make fmt-check
+make vet
+make revive
+
+# Incremental golangci-lint: only fail on issues introduced by this commit.
+# Pick a sensible base ref: prefer origin/master, fall back to master, then HEAD.
+BASE_REF="${QUALITY_BASE_REF:-}"
+if [ -z "$BASE_REF" ]; then
+	if git rev-parse --verify --quiet origin/master >/dev/null; then
+		BASE_REF="origin/master"
+	elif git rev-parse --verify --quiet master >/dev/null; then
+		BASE_REF="master"
+	else
+		BASE_REF="HEAD"
+	fi
+fi
+
+echo "[pre-commit] running incremental lint against ${BASE_REF}"
+QUALITY_BASE_REF="$BASE_REF" make lint-new

.github/CODEOWNERS

@@ -0,0 +1,30 @@
+# CODEOWNERS for skill-up
+#
+# This file routes PR review requests to the appropriate maintainers.
+# See: https://docs.github.com/articles/about-code-owners
+#
+# Syntax notes:
+#   - Patterns follow .gitignore-style rules; the LAST matching pattern wins.
+#   - Owners must be real GitHub usernames (@user) or teams (@org/team)
+#     that have read access to the repository, otherwise the rule is ignored.
+#   - Multiple owners can be listed, separated by spaces.
+#
+# Recommended Branch Protection (Settings -> Branches -> Add rule):
+#   - Require a pull request before merging
+#   - Require review from Code Owners
+#   - Require status checks to pass (select `build` and `lint` jobs from CI)
+
+# Global fallback: every file is owned by the maintainers by default.
+*                           @hittyt @libinfs
+
+# Public API surface: changes here require extra care.
+/pkg/                       @hittyt @libinfs
+
+# CI / release configuration.
+/.github/                   @hittyt @libinfs
+/Makefile                   @hittyt @libinfs
+/.goreleaser.yaml           @hittyt @libinfs
+
+# Core runner & agent logic.
+/internal/runner/           @hittyt @libinfs
+/internal/agent/            @hittyt @libinfs

.github/ISSUE_TEMPLATE/bug_report.md

@@ -0,0 +1,33 @@
+---
+name: Bug report
+about: Report a reproducible bug
+labels: bug
+---
+
+## Description
+
+<!-- A clear and concise description of the bug. -->
+
+## Steps to reproduce
+
+1. 
+2. 
+3. 
+
+## Expected behavior
+
+<!-- What you expected to happen. -->
+
+## Actual behavior
+
+<!-- What actually happened. Include error output if applicable. -->
+
+## Environment
+
+- skill-up version (`skill-up --version`):
+- Go version (`go version`):
+- OS / arch:
+
+## Additional context
+
+<!-- Any other context, logs, or screenshots. -->

.github/ISSUE_TEMPLATE/feature_request.md

@@ -0,0 +1,21 @@
+---
+name: Feature request
+about: Suggest an idea or enhancement
+labels: enhancement
+---
+
+## Problem / motivation
+
+<!-- What problem does this feature solve? Who is affected? -->
+
+## Proposed solution
+
+<!-- Describe the solution you'd like. -->
+
+## Alternatives considered
+
+<!-- Any alternative approaches you've considered. -->
+
+## Additional context
+
+<!-- Links to related issues, designs, or prior art. -->

.github/PULL_REQUEST_TEMPLATE.md

@@ -0,0 +1,21 @@
+## Summary
+
+<!-- Describe what this PR does and why. -->
+
+## Related issues
+
+<!-- Closes #<issue-number> -->
+
+## Changes
+
+<!-- Bullet-point list of notable changes. -->
+
+## Test plan
+
+- [ ] `make test` passes
+- [ ] `make verify` passes (fmt + vet + lint)
+- [ ] Manual testing steps (if applicable):
+
+## Notes for reviewers
+
+<!-- Anything that needs special attention during review. -->

.github/dependabot.yml

@@ -0,0 +1,26 @@
+version: 2
+updates:
+  # Go module dependencies.
+  - package-ecosystem: "gomod"
+    directory: "/"
+    schedule:
+      interval: "weekly"
+      day: "monday"
+    open-pull-requests-limit: 5
+    labels:
+      - "dependencies"
+    commit-message:
+      prefix: "chore"
+
+  # GitHub Actions versions.
+  - package-ecosystem: "github-actions"
+    directory: "/"
+    schedule:
+      interval: "weekly"
+      day: "monday"
+    open-pull-requests-limit: 3
+    labels:
+      - "dependencies"
+      - "ci"
+    commit-message:
+      prefix: "ci"

.github/workflows/ci.yml

@@ -0,0 +1,68 @@
+name: CI
+
+on:
+  push:
+    branches: [main]
+  pull_request:
+    branches: [main]
+
+permissions:
+  contents: read
+
+jobs:
+  build:
+    name: Build & Test
+    runs-on: ubuntu-latest
+    strategy:
+      matrix:
+        go-version: ["1.25.x"]
+
+    steps:
+      - uses: actions/checkout@v4
+
+      - uses: actions/setup-go@v5
+        with:
+          go-version: ${{ matrix.go-version }}
+          cache: true
+
+      - name: Verify dependencies
+        run: go mod verify
+
+      - name: Build
+        run: go build ./...
+
+      - name: Test (with race detector and coverage)
+        run: go test -race -timeout 120s -covermode=atomic -coverprofile=coverage.out ./...
+
+      - name: Upload coverage to Codecov
+        uses: codecov/codecov-action@v5
+        with:
+          files: ./coverage.out
+          flags: unittests
+          fail_ci_if_error: false
+        env:
+          CODECOV_TOKEN: ${{ secrets.CODECOV_TOKEN }}
+
+  lint:
+    name: Lint
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+
+      - uses: actions/setup-go@v5
+        with:
+          go-version: "1.25.x"
+          cache: true
+
+      - name: Check formatting
+        run: |
+          if [ "$(gofmt -l . | wc -l)" -gt 0 ]; then
+            echo "Following files are not formatted:"
+            gofmt -l .
+            exit 1
+          fi
+
+      - name: golangci-lint
+        uses: golangci/golangci-lint-action@v8
+        with:
+          version: v2.11.4

.github/workflows/docs.yml

@@ -0,0 +1,64 @@
+name: Docs
+
+# Build the VitePress documentation site and deploy to GitHub Pages.
+# Site URL: https://<org>.github.io/skill-up/
+on:
+  push:
+    branches: [main]
+    paths:
+      - 'docs/**'
+      - 'package.json'
+      - 'package-lock.json'
+      - '.github/workflows/docs.yml'
+  workflow_dispatch:
+
+# Required for GitHub Pages deployment via actions/deploy-pages.
+permissions:
+  contents: read
+  pages: write
+  id-token: write
+
+# Allow only one concurrent deployment, but do not cancel in-progress runs.
+concurrency:
+  group: pages
+  cancel-in-progress: false
+
+jobs:
+  build:
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v4
+        with:
+          fetch-depth: 0
+
+      - name: Setup Node
+        uses: actions/setup-node@v4
+        with:
+          node-version: '20'
+          cache: 'npm'
+
+      - name: Install dependencies
+        run: npm ci
+
+      - name: Build VitePress site
+        run: npm run docs:build
+
+      - name: Setup Pages
+        uses: actions/configure-pages@v5
+
+      - name: Upload artifact
+        uses: actions/upload-pages-artifact@v3
+        with:
+          path: docs/.vitepress/dist
+
+  deploy:
+    needs: build
+    runs-on: ubuntu-latest
+    environment:
+      name: github-pages
+      url: ${{ steps.deployment.outputs.page_url }}
+    steps:
+      - name: Deploy to GitHub Pages
+        id: deployment
+        uses: actions/deploy-pages@v4