Files
skillshare/CONTRIBUTING.md
T
Willie 262e639701 docs: add task-routed agent wiki
Add a shared instruction kernel and byte-budgeted topic router so agents load only task-relevant repository guidance. Wire drift checks into local and CI workflows and point project skills at the routed topics.
2026-09-25 02:32:37 +08:00

83 lines
3.3 KiB
Markdown

# Contributing to skillshare
Thanks for your interest in contributing! This guide helps you get started.
## Start with an Issue
The best way to contribute is to [open an issue](https://github.com/runkids/skillshare/issues/new). Issues are where ideas, feature requests, and design discussions happen. This helps us:
- Align on whether the change fits the project direction
- Agree on scope and approach before any code is written
- Avoid investing time in work that may not be merged
**Please open an issue before writing code**, even if you're confident in the approach. Skipping this step is the most common reason contributions can't be accepted.
## Pull Requests
### What PRs are good for
PRs work best for **small, focused changes**:
- Bug fixes with a clear reproduction
- Typo and documentation corrections
- Small improvements (a few files, under ~200 lines of meaningful change)
These can go straight to a PR (still link to an issue if one exists).
### Feature Ideas
For new features or large changes:
1. **Open an issue** to describe the idea and the problem it solves
2. **Submit a proposal** — copy [`proposals/TEMPLATE.md`](proposals/TEMPLATE.md), fill it in, and open a PR to `proposals/`
Approved proposals will be added to the roadmap. Implementation is handled by the maintainer to ensure consistency with the project's architecture and codebase conventions.
> **Note:** Due to the nature of this project, most feature PRs won't be merged directly — but every contribution is valuable. Your PR serves as a concrete reference that shapes the final implementation.
### PR Checklist
- [ ] Linked to an issue (required for features, recommended for bug fixes)
- [ ] Tests included and passing (`make check`)
- [ ] No unrelated changes in the diff
- [ ] Commit messages explain "why", not just "what"
- [ ] Scope is focused — one concern per PR
## Translated READMEs
The language links at the top of each README are sorted by language code (`ja`, `ko`, `zh-CN`, `zh-TW`), with English first as the source. Add a new language at its place in that order, name the file `README-<code>.md`, and use the language's own name without a region or flag.
## Development Setup
All development and testing should be done inside the **devcontainer**. This ensures a consistent environment (Go toolchain, Node.js, pnpm, and demo content are pre-configured).
Repository-specific task context is indexed in the [developer wiki](wiki/README.md). Agents should load the closest topic with `python3 scripts/ai-context.py <topic>` before making changes.
```bash
git clone https://github.com/runkids/skillshare.git
cd skillshare
make devc # start devcontainer + enter shell (one step)
```
Once inside the devcontainer:
```bash
make build # build binary → bin/skillshare
make test # unit + integration tests
make check # fmt + lint + test (must pass before PR)
make ui-dev # Go API server + Vite HMR for Web UI
```
Other devcontainer commands:
```bash
make devc-down # stop devcontainer
make devc-restart # restart devcontainer
make devc-reset # full reset (remove volumes)
make devc-status # show devcontainer status
```
## Questions?
Not sure where to start? Browse [open issues](https://github.com/runkids/skillshare/issues) or open a new one to discuss your idea.