mirror of
https://github.com/hanzoai/skills.git
synced 2026-11-19 00:47:36 +00:00
Every page now loads /webmcp.js, scripts/webmcp.ts with its types stripped (npm run webmcp). Where the browser has document.modelContext it registers two read-only tools: search_skills over the published skills index, and get_skill, which returns a skill's markdown checked against the index digest. The markdown alternate link moves from build.py to site.py, so CI holds every page to it. The API catalog gains the site itself (llms.txt and the skills index) and hanzo.ai/agents; the live discovery check now fetches every catalog link. tests/site.mjs drives the tools through a recording modelContext, and checks a browser without one loads clean.
586 lines
26 KiB
HTML
586 lines
26 KiB
HTML
<!doctype html>
|
|
<html lang="en"><head>
|
|
<meta charset="utf-8"><meta name="viewport" content="width=device-width,initial-scale=1">
|
|
<title>collaboration-github-repository-management</title>
|
|
<meta name="color-scheme" content="dark">
|
|
<style>
|
|
/* Committed to one visual world: a dark instrument panel. No light variant —
|
|
the dot field and the hairline rules only read on black, and a naive
|
|
inversion would wash both out. Every colour is painted explicitly so the page
|
|
never borrows a host background. */
|
|
@font-face{font-family:'Zen';src:url('/fonts/Zen-Variable.woff2') format('woff2');font-weight:100 900;font-style:normal;font-display:swap}
|
|
@font-face{font-family:'Zen';src:url('/fonts/Zen-Italic-Variable.woff2') format('woff2');font-weight:100 900;font-style:italic;font-display:swap}
|
|
@font-face{font-family:'Zen Mono';src:url('/fonts/ZenMono-Variable.woff2') format('woff2');font-weight:100 900;font-style:normal;font-display:swap}
|
|
@font-face{font-family:'Zen Mono';src:url('/fonts/ZenMono-Italic-Variable.woff2') format('woff2');font-weight:100 900;font-style:italic;font-display:swap}
|
|
@font-face{font-family:'Zen Pixel Square';src:url('/fonts/ZenPixel-Square.woff2') format('woff2');font-style:normal;font-display:swap}
|
|
|
|
:root{
|
|
--ink:#f4f4f2; --soft:#9c9c98; --faint:#6a6a66; --ground:#000; --panel:#0a0a0a;
|
|
--line:#232323; --line-hi:#3a3a3a; --accent:#f4f4f2;
|
|
--font-zen-sans:'Zen',-apple-system,BlinkMacSystemFont,"Segoe UI",Helvetica,Arial,sans-serif;
|
|
--font-zen-mono:'Zen Mono',ui-monospace,"SF Mono",SFMono-Regular,Menlo,Consolas,monospace;
|
|
--font-zen-pixel-square:'Zen Pixel Square',monospace;
|
|
--mono:var(--font-zen-mono);
|
|
--sans:var(--font-zen-sans);
|
|
/* Controls are pills and surfaces are soft, as on hanzo.ai. */
|
|
--r:999px; --r-soft:14px;
|
|
}
|
|
*{box-sizing:border-box}
|
|
html{-webkit-text-size-adjust:100%}
|
|
body{margin:0;background:var(--ground);color:var(--ink);font-family:var(--sans);
|
|
font-size:16px;line-height:1.65;-webkit-font-smoothing:antialiased}
|
|
.wrap{max-width:60rem;margin:0 auto;padding:0 1.75rem}
|
|
|
|
/* The dot field. A halftone made of one repeating radial-gradient, faded out
|
|
along the diagonal by a mask so it reads as a wave rather than wallpaper. */
|
|
/* No overflow clip here: the dot field is inset to the box already, and a clip
|
|
would cut off the copy-prompt menu. */
|
|
.hero{position:relative;border-bottom:1px solid var(--line)}
|
|
.hero::before{content:"";position:absolute;inset:0;
|
|
background-image:radial-gradient(var(--line-hi) 1px, transparent 1px);
|
|
background-size:7px 7px;
|
|
-webkit-mask-image:linear-gradient(115deg,#000 0%,rgba(0,0,0,.55) 38%,transparent 72%);
|
|
mask-image:linear-gradient(115deg,#000 0%,rgba(0,0,0,.55) 38%,transparent 72%);
|
|
pointer-events:none}
|
|
.hero .wrap{position:relative;padding-top:5.5rem;padding-bottom:4rem}
|
|
|
|
nav{border-bottom:1px solid var(--line)}
|
|
nav .in{max-width:60rem;margin:0 auto;padding:1.1rem 1.75rem;display:flex;
|
|
justify-content:space-between;align-items:center;gap:1rem}
|
|
.brand{font-family:var(--mono);font-size:.85rem;letter-spacing:.14em;
|
|
text-transform:uppercase;color:var(--ink);text-decoration:none;
|
|
display:inline-flex;align-items:center;gap:.6rem}
|
|
.brand i{font-style:normal;color:var(--faint)}
|
|
.mark{width:1.15em;height:1.15em;display:block;flex:0 0 auto}
|
|
nav a.up{font-family:var(--mono);font-size:.72rem;letter-spacing:.14em;
|
|
text-transform:uppercase;color:var(--soft);text-decoration:none}
|
|
nav a.up:hover{color:var(--ink)}
|
|
|
|
h1{font-family:var(--mono);font-size:clamp(2rem,5.4vw,3.4rem);line-height:1.12;
|
|
letter-spacing:-.02em;margin:0 0 1.1rem;font-weight:500;text-wrap:balance}
|
|
h1 em{font-style:normal;color:var(--faint)}
|
|
.lede{color:var(--soft);font-size:1.05rem;max-width:52ch;margin:0 0 2.25rem}
|
|
|
|
.btns{display:flex;flex-wrap:wrap;gap:.7rem;margin:0 0 .5rem;align-items:center}
|
|
.btn{display:inline-flex;align-items:center;gap:.5rem;font-family:var(--mono);
|
|
font-size:.72rem;letter-spacing:.14em;text-transform:uppercase;
|
|
padding:.8rem 1.4rem;border:1px solid var(--line-hi);border-radius:var(--r);
|
|
color:var(--ink);text-decoration:none;background:transparent;cursor:pointer;
|
|
line-height:1.2;font-weight:400}
|
|
.btn:hover{background:#141414;text-decoration:none;border-color:var(--soft)}
|
|
.btn.solid{background:var(--ink);color:#000;border-color:var(--ink)}
|
|
.btn.solid:hover{background:#d8d8d4}
|
|
.btn .chev{width:.7em;height:.7em;flex:0 0 auto;transition:transform .15s ease}
|
|
.btn[aria-expanded="true"] .chev{transform:rotate(180deg)}
|
|
|
|
/* Copy-prompt selector. Each row copies the prompt for its own target. */
|
|
.copy{position:relative;display:inline-flex}
|
|
.menu{position:absolute;top:calc(100% + .5rem);left:0;z-index:20;min-width:21rem;
|
|
background:var(--panel);border:1px solid var(--line-hi);border-radius:var(--r-soft);
|
|
padding:.4rem;display:flex;flex-direction:column;
|
|
box-shadow:0 12px 32px rgba(0,0,0,.75)}
|
|
.menu[hidden]{display:none}
|
|
.mi{display:flex;align-items:center;gap:.7rem;width:100%;text-align:left;
|
|
padding:.62rem .8rem;border:0;border-radius:calc(var(--r-soft) - .35rem);
|
|
background:transparent;color:var(--ink);font-family:var(--mono);font-size:.76rem;
|
|
letter-spacing:.04em;text-decoration:none;cursor:pointer;line-height:1.3;
|
|
white-space:nowrap}
|
|
.mi:hover,.mi:focus-visible{background:#181818;outline:none}
|
|
.mi .mark{width:1.05rem;height:1.05rem;color:var(--soft)}
|
|
.mi:hover .mark{color:var(--ink)}
|
|
.mi u{margin-left:auto;color:var(--faint);text-decoration:none;font-size:.68rem;
|
|
letter-spacing:.1em;text-transform:uppercase}
|
|
|
|
/* Works-with bar: one scrolling row, name and mark per agent. */
|
|
.strip{border-bottom:1px solid var(--line);background:var(--panel)}
|
|
.strip .in{max-width:60rem;margin:0 auto;padding:.9rem 1.75rem;display:flex;
|
|
align-items:center;gap:1.25rem;font-family:var(--mono);font-size:.72rem;
|
|
letter-spacing:.1em;text-transform:uppercase;color:var(--faint)}
|
|
.strip b{color:var(--soft);font-weight:400;flex:0 0 auto;
|
|
border-right:1px solid var(--line);padding-right:1.25rem;align-self:stretch;
|
|
display:flex;align-items:center}
|
|
.bar{display:flex;align-items:center;gap:.5rem;flex:1 1 auto;min-width:0;
|
|
overflow-x:auto;scrollbar-width:none;scroll-snap-type:x proximity;
|
|
-webkit-overflow-scrolling:touch;
|
|
-webkit-mask-image:linear-gradient(90deg,#000 calc(100% - 3rem),transparent);
|
|
mask-image:linear-gradient(90deg,#000 calc(100% - 3rem),transparent)}
|
|
.bar::-webkit-scrollbar{display:none}
|
|
.agent{display:inline-flex;align-items:center;gap:.45rem;flex:0 0 auto;
|
|
padding:.4rem .85rem;border:1px solid var(--line);border-radius:var(--r);
|
|
color:var(--soft);white-space:nowrap;scroll-snap-align:start;
|
|
text-decoration:none;background:var(--ground)}
|
|
.agent:hover{color:var(--ink);border-color:var(--line-hi);text-decoration:none}
|
|
.agent .mark{width:.95rem;height:.95rem}
|
|
|
|
h2{font-family:var(--mono);font-size:1.1rem;letter-spacing:-.01em;margin:2.75rem 0 .75rem;font-weight:500}
|
|
h3{font-size:1rem;margin:2rem 0 .5rem;font-weight:600}
|
|
h4,h5,h6{font-size:.94rem;margin:1.5rem 0 .5rem;font-weight:600}
|
|
p{margin:0 0 1rem;max-width:70ch}
|
|
ul,ol{margin:0 0 1rem;padding-left:1.35rem;max-width:70ch}
|
|
li{margin:.22rem 0}
|
|
a{color:var(--ink);text-decoration:underline;text-underline-offset:3px;
|
|
text-decoration-color:var(--line-hi)}
|
|
a:hover{text-decoration-color:var(--ink)}
|
|
a:focus-visible{outline:1px solid var(--ink);outline-offset:3px}
|
|
code{font-family:var(--mono);font-size:.85em;background:var(--panel);
|
|
border:1px solid var(--line);border-radius:5px;padding:.1em .36em}
|
|
pre{background:var(--panel);border:1px solid var(--line);padding:1rem 1.1rem;
|
|
border-radius:var(--r-soft);overflow-x:auto;margin:0 0 1.25rem}
|
|
pre code{background:none;border:0;padding:0;font-size:.82rem;line-height:1.7}
|
|
blockquote{margin:0 0 1rem;padding-left:1rem;border-left:1px solid var(--line-hi);color:var(--soft)}
|
|
hr{border:0;border-top:1px solid var(--line);margin:2.5rem 0}
|
|
table{border-collapse:collapse;width:100%;margin:0 0 1.25rem;font-size:.92rem;
|
|
display:block;overflow-x:auto}
|
|
th,td{border:1px solid var(--line);padding:.5rem .7rem;text-align:left}
|
|
|
|
.curl{display:block;background:var(--panel);border:1px solid var(--line);
|
|
border-radius:var(--r-soft);padding:.95rem 1.1rem;font-family:var(--mono);
|
|
font-size:.8rem;color:var(--soft);overflow-x:auto;margin:0 0 2.5rem;
|
|
white-space:pre;line-height:1.9}
|
|
.curl b{color:var(--ink);font-weight:400}
|
|
.curl i{font-style:normal;color:var(--faint)}
|
|
|
|
/* index */
|
|
#q{width:100%;padding:.85rem 1.2rem;font-family:var(--mono);font-size:.85rem;color:var(--ink);
|
|
background:var(--panel);border:1px solid var(--line);border-radius:var(--r);margin:0 0 .6rem}
|
|
#q::placeholder{color:var(--faint);text-transform:uppercase;letter-spacing:.1em;font-size:.72rem}
|
|
#q:focus{outline:none;border-color:var(--soft)}
|
|
#count{color:var(--faint);font-family:var(--mono);font-size:.72rem;letter-spacing:.1em;
|
|
text-transform:uppercase;margin:0 0 2rem}
|
|
.cat{margin:2.5rem 0 .5rem;font-family:var(--mono);font-size:.7rem;letter-spacing:.16em;
|
|
text-transform:uppercase;color:var(--faint);border-bottom:1px solid var(--line);
|
|
padding-bottom:.45rem}
|
|
.row{display:block;padding:.6rem .9rem;margin:0 -.9rem;border-bottom:1px solid var(--line);
|
|
border-radius:var(--r-soft);text-decoration:none}
|
|
.row:hover{background:#0a0a0a}
|
|
.nm{font-family:var(--mono);font-size:.84rem;color:var(--ink);display:block}
|
|
.ds{color:var(--soft);font-size:.9rem;display:block;margin-top:.12rem}
|
|
footer{margin-top:4rem;padding:2rem 0 4rem;border-top:1px solid var(--line);
|
|
color:var(--faint);font-size:.85rem}
|
|
footer a{color:var(--soft)}
|
|
.fmap{display:grid;gap:1.75rem;grid-template-columns:repeat(auto-fit,minmax(11rem,1fr));
|
|
margin:0 0 2rem;font-size:.85rem}
|
|
.fmap b{display:block;font-family:var(--mono);font-size:.68rem;letter-spacing:.16em;
|
|
text-transform:uppercase;color:var(--faint);font-weight:400;margin:0 0 .6rem;
|
|
border-bottom:1px solid var(--line);padding-bottom:.4rem}
|
|
.fmap a{display:inline-block;color:var(--ink);text-decoration:none;margin:.3rem .35rem 0 0}
|
|
.fmap a:hover{text-decoration:underline}
|
|
.fmap div{color:var(--faint);line-height:1.5}
|
|
.fend{border-top:1px solid var(--line);padding-top:1.25rem;font-size:.82rem}
|
|
|
|
@media (max-width:640px){
|
|
.hero .wrap{padding-top:3.25rem;padding-bottom:2.75rem}
|
|
.btns{gap:.5rem}
|
|
.btn{padding:.75rem 1.15rem;font-size:.68rem}
|
|
.copy,.copy .btn{width:100%;justify-content:center}
|
|
.menu{left:0;right:0;min-width:0}
|
|
.strip .in{flex-direction:column;align-items:flex-start;gap:.6rem;padding:.9rem 1.75rem}
|
|
.strip b{border-right:0;padding-right:0}
|
|
.bar{width:100%}
|
|
}
|
|
</style>
|
|
<link rel="icon" href="/favicon.svg">
|
|
<link rel="canonical" href="https://hanzoskills.com/collaboration-github-repository-management">
|
|
<link rel="alternate" type="text/markdown" href="/collaboration-github-repository-management.md">
|
|
<script type="module" src="/webmcp.js"></script>
|
|
</head>
|
|
<!-- Reading this with a machine? Every page here is also plain markdown.
|
|
This one: https://hanzoskills.com/collaboration-github-repository-management.md
|
|
Index: https://hanzoskills.com/llms.txt
|
|
Corpus: https://hanzoskills.com/all.md
|
|
Append .md to any path for the markdown twin. -->
|
|
<body>
|
|
<nav><div class="in">
|
|
<a class="brand" href="/"><svg class="mark" viewBox="0 0 67 67" fill="currentColor" aria-hidden="true"><path d="M22.21 67V44.6369H0V67H22.21Z"/><path d="M66.7038 22.3184H22.2534L0.0878906 44.6367H44.4634L66.7038 22.3184Z"/><path d="M22.21 0H0V22.3184H22.21V0Z"/><path d="M66.7198 0H44.5098V22.3184H66.7198V0Z"/><path d="M66.7198 67V44.6369H44.5098V67H66.7198Z"/></svg> HANZO<i>SKILLS</i></a>
|
|
<a class="up" href="/">All skills</a>
|
|
</div></nav>
|
|
|
|
<div class="wrap">
|
|
<h1>collaboration-github-repository-management</h1><p class="lede">Repository creation, configuration, branch protection, tags, releases, and GitHub CLI operations</p><h1>GitHub Repository Management</h1>
|
|
<p><strong>Scope</strong>: Repository creation and configuration, branch management, branch protection rules, tags and releases, GitHub CLI operations, repository settings and templates</p>
|
|
<p><strong>Lines</strong>: ~280</p>
|
|
<p><strong>Last Updated</strong>: 2025-10-25</p>
|
|
<p><strong>Format Version</strong>: 1.0 (Atomic)</p>
|
|
<hr>
|
|
<h2>When to Use This Skill</h2>
|
|
<p>Activate this skill when:</p>
|
|
<ul><li>Creating and configuring new GitHub repositories</li><li>Setting up branch protection rules and required reviews</li><li>Managing releases with semantic versioning and release notes</li><li>Using GitHub CLI for repository operations</li><li>Configuring repository settings: webhooks, secrets, environments</li><li>Creating repository, issue, and PR templates</li><li>Setting default branches and branch naming conventions</li><li>Generating changelogs and managing tags</li></ul>
|
|
<hr>
|
|
<h2>Core Concepts</h2>
|
|
<h3>Repository Structure</h3>
|
|
<p><strong>Key components</strong>:</p>
|
|
<ul><li><strong>Default branch</strong>: Main development branch (main or master)</li><li><strong>Protected branches</strong>: Branches with enforcement rules</li><li><strong>Environments</strong>: Deployment targets with secrets and protection rules</li><li><strong>Webhooks</strong>: HTTP callbacks for repository events</li><li><strong>Secrets</strong>: Encrypted environment variables</li><li><strong>Templates</strong>: Standardized issue and PR formats</li></ul>
|
|
<pre><code class="lang-bash"># Repository hierarchy
|
|
repository/
|
|
├── .github/
|
|
│ ├── workflows/ # GitHub Actions
|
|
│ ├── ISSUE_TEMPLATE/ # Issue templates
|
|
│ ├── PULL_REQUEST_TEMPLATE.md
|
|
│ └── dependabot.yml
|
|
├── src/ # Source code
|
|
├── README.md
|
|
├── LICENSE
|
|
└── SECURITY.md</code></pre>
|
|
<h3>Branch Protection</h3>
|
|
<p><strong>Protection rules enforce</strong>:</p>
|
|
<ul><li>Required status checks before merging</li><li>Required reviews (count and approval)</li><li>Dismissal of stale reviews</li><li>Required linear history</li><li>Signed commits</li><li>Administrator enforcement</li></ul>
|
|
<h3>GitHub CLI Workflow</h3>
|
|
<pre><code class="lang-bash"># Authentication flow
|
|
gh auth login
|
|
gh auth status
|
|
|
|
# Repository operations
|
|
gh repo create → gh repo view → gh repo edit
|
|
↓
|
|
Branch protection → PR workflow → Release
|
|
↓
|
|
Cleanup and archival</code></pre>
|
|
<hr>
|
|
<h2>Patterns</h2>
|
|
<h3>Creating Repositories with GitHub CLI</h3>
|
|
<pre><code class="lang-bash"># Create new repository (interactive)
|
|
gh repo create my-project
|
|
|
|
# Create with flags
|
|
gh repo create my-project \
|
|
--public \
|
|
--description "Project description" \
|
|
--gitignore Node \
|
|
--license MIT
|
|
|
|
# Create from template
|
|
gh repo create my-project \
|
|
--template owner/template-repo \
|
|
--private
|
|
|
|
# Create and clone
|
|
gh repo create my-project --clone
|
|
|
|
# Initialize existing directory
|
|
cd existing-project
|
|
gh repo create --source=. --remote=origin --push</code></pre>
|
|
<h3>Repository Configuration</h3>
|
|
<pre><code class="lang-bash"># View repository details
|
|
gh repo view owner/repo
|
|
|
|
# Edit repository settings
|
|
gh repo edit owner/repo \
|
|
--description "New description" \
|
|
--homepage "https://example.com" \
|
|
--default-branch main \
|
|
--enable-issues=true \
|
|
--enable-wiki=false
|
|
|
|
# Archive repository
|
|
gh repo archive owner/repo
|
|
|
|
# Delete repository (careful!)
|
|
gh repo delete owner/repo --confirm</code></pre>
|
|
<h3>Branch Protection Rules</h3>
|
|
<p><strong>Via GitHub CLI</strong>:</p>
|
|
<pre><code class="lang-bash"># Enable branch protection (requires API)
|
|
gh api repos/owner/repo/branches/main/protection \
|
|
--method PUT \
|
|
--field required_status_checks='{"strict":true,"contexts":["ci/build","ci/test"]}' \
|
|
--field enforce_admins=true \
|
|
--field required_pull_request_reviews='{"required_approving_review_count":2}' \
|
|
--field restrictions=null</code></pre>
|
|
<p><strong>Via Web UI</strong> (recommended for complex rules):</p>
|
|
<ol><li>Settings → Branches → Add rule</li><li>Configure:</li></ol>
|
|
<ul><li>Require pull request before merging</li><li>Require approvals: 1-6 reviewers</li><li>Dismiss stale reviews when new commits pushed</li><li>Require review from Code Owners</li><li>Require status checks to pass</li><li>Require conversation resolution</li><li>Require signed commits</li><li>Require linear history</li></ul>
|
|
<p><strong>Protection rule pattern</strong>:</p>
|
|
<pre><code class="lang-yaml"># Common protection for main branch
|
|
Branch pattern: main
|
|
✅ Require pull request reviews (2 approvals)
|
|
✅ Dismiss stale reviews
|
|
✅ Require review from Code Owners
|
|
✅ Require status checks (ci/build, ci/test)
|
|
✅ Require branches to be up to date
|
|
✅ Require conversation resolution
|
|
✅ Include administrators</code></pre>
|
|
<h3>Tags and Releases</h3>
|
|
<p><strong>Creating tags</strong>:</p>
|
|
<pre><code class="lang-bash"># Create annotated tag (recommended)
|
|
git tag -a v1.0.0 -m "Release version 1.0.0"
|
|
git push origin v1.0.0
|
|
|
|
# Create lightweight tag
|
|
git tag v1.0.0
|
|
git push origin v1.0.0
|
|
|
|
# List tags
|
|
git tag -l
|
|
|
|
# Delete tag
|
|
git tag -d v1.0.0
|
|
git push origin :refs/tags/v1.0.0</code></pre>
|
|
<p><strong>Semantic versioning</strong>:</p>
|
|
<pre><code>MAJOR.MINOR.PATCH (1.2.3)
|
|
|
|
MAJOR: Breaking changes (1.x.x → 2.0.0)
|
|
MINOR: New features, backward compatible (1.2.x → 1.3.0)
|
|
PATCH: Bug fixes, backward compatible (1.2.3 → 1.2.4)
|
|
|
|
Pre-release: 1.0.0-alpha.1, 1.0.0-beta.2, 1.0.0-rc.1</code></pre>
|
|
<p><strong>Creating releases with GitHub CLI</strong>:</p>
|
|
<pre><code class="lang-bash"># Create release from tag
|
|
gh release create v1.0.0 \
|
|
--title "Version 1.0.0" \
|
|
--notes "Release notes here"
|
|
|
|
# Create release with assets
|
|
gh release create v1.0.0 \
|
|
--title "Version 1.0.0" \
|
|
--notes-file CHANGELOG.md \
|
|
dist/*.tar.gz dist/*.zip
|
|
|
|
# Create draft release
|
|
gh release create v1.0.0 \
|
|
--draft \
|
|
--title "Version 1.0.0" \
|
|
--notes "Draft release"
|
|
|
|
# Generate release notes automatically
|
|
gh release create v1.0.0 --generate-notes
|
|
|
|
# List releases
|
|
gh release list
|
|
|
|
# View specific release
|
|
gh release view v1.0.0
|
|
|
|
# Download release assets
|
|
gh release download v1.0.0</code></pre>
|
|
<h3>Repository Templates</h3>
|
|
<p><strong>Issue template</strong> (.github/ISSUE_TEMPLATE/bug_report.md):</p>
|
|
<pre><code class="lang-markdown">---
|
|
name: Bug Report
|
|
about: Report a bug to help us improve
|
|
title: '[BUG] '
|
|
labels: bug
|
|
assignees: ''
|
|
---
|
|
|
|
## Bug Description
|
|
A clear description of the bug.
|
|
|
|
## Steps to Reproduce
|
|
1. Go to '...'
|
|
2. Click on '...'
|
|
3. See error
|
|
|
|
## Expected Behavior
|
|
What should happen.
|
|
|
|
## Actual Behavior
|
|
What actually happens.
|
|
|
|
## Environment
|
|
- OS: [e.g., macOS 14.0]
|
|
- Browser: [e.g., Chrome 120]
|
|
- Version: [e.g., 1.2.3]
|
|
|
|
## Additional Context
|
|
Screenshots, logs, or other context.</code></pre>
|
|
<p><strong>Pull request template</strong> (.github/PULL_REQUEST_TEMPLATE.md):</p>
|
|
<pre><code class="lang-markdown">## Summary
|
|
Brief description of changes.
|
|
|
|
## Type of Change
|
|
- [ ] Bug fix
|
|
- [ ] New feature
|
|
- [ ] Breaking change
|
|
- [ ] Documentation update
|
|
|
|
## Testing
|
|
- [ ] Unit tests pass
|
|
- [ ] Integration tests pass
|
|
- [ ] Manual testing completed
|
|
|
|
## Checklist
|
|
- [ ] Code follows style guidelines
|
|
- [ ] Self-review completed
|
|
- [ ] Comments added for complex logic
|
|
- [ ] Documentation updated
|
|
- [ ] No new warnings generated
|
|
|
|
## Related Issues
|
|
Closes #123
|
|
Related to #456</code></pre>
|
|
<h3>Repository Secrets and Environments</h3>
|
|
<p><strong>Managing secrets with GitHub CLI</strong>:</p>
|
|
<pre><code class="lang-bash"># Set repository secret
|
|
gh secret set API_KEY < api_key.txt
|
|
|
|
# Set secret with value
|
|
echo "secret-value" | gh secret set SECRET_NAME
|
|
|
|
# List secrets
|
|
gh secret list
|
|
|
|
# Delete secret
|
|
gh secret delete SECRET_NAME
|
|
|
|
# Set environment secret
|
|
gh secret set API_KEY --env production</code></pre>
|
|
<p><strong>Configuring environments</strong> (via Web UI):</p>
|
|
<ol><li>Settings → Environments → New environment</li><li>Configure:</li></ol>
|
|
<ul><li>Environment protection rules</li><li>Required reviewers before deployment</li><li>Wait timer (delay before deployment)</li><li>Environment secrets</li><li>Deployment branches (limit to specific branches)</li></ul>
|
|
<h3>Webhooks Configuration</h3>
|
|
<pre><code class="lang-bash"># Create webhook via API
|
|
gh api repos/owner/repo/hooks \
|
|
--method POST \
|
|
--field name=web \
|
|
--field config[url]=https://example.com/webhook \
|
|
--field config[content_type]=json \
|
|
--field events[]="push" \
|
|
--field events[]="pull_request"
|
|
|
|
# List webhooks
|
|
gh api repos/owner/repo/hooks
|
|
|
|
# Delete webhook
|
|
gh api repos/owner/repo/hooks/123 --method DELETE</code></pre>
|
|
<hr>
|
|
<h2>Quick Reference</h2>
|
|
<h3>GitHub CLI Commands</h3>
|
|
<pre><code class="lang-bash"># Authentication
|
|
gh auth login # Authenticate with GitHub
|
|
gh auth status # Check authentication status
|
|
gh auth logout # Log out
|
|
|
|
# Repository operations
|
|
gh repo create [name] # Create repository
|
|
gh repo clone owner/repo # Clone repository
|
|
gh repo view [owner/repo] # View repository details
|
|
gh repo edit [owner/repo] # Edit repository settings
|
|
gh repo fork owner/repo # Fork repository
|
|
gh repo sync owner/repo # Sync fork with upstream
|
|
|
|
# Release management
|
|
gh release create <tag> # Create release
|
|
gh release list # List releases
|
|
gh release view <tag> # View release details
|
|
gh release download <tag> # Download release assets
|
|
gh release delete <tag> # Delete release
|
|
|
|
# Secret management
|
|
gh secret set <name> # Set secret
|
|
gh secret list # List secrets
|
|
gh secret delete <name> # Delete secret</code></pre>
|
|
<h3>Semantic Versioning Quick Guide</h3>
|
|
<pre><code>Version format: MAJOR.MINOR.PATCH
|
|
|
|
Breaking change: 1.0.0 → 2.0.0
|
|
New feature: 1.2.0 → 1.3.0
|
|
Bug fix: 1.2.3 → 1.2.4
|
|
|
|
Pre-release tags:
|
|
- alpha: 1.0.0-alpha.1
|
|
- beta: 1.0.0-beta.1
|
|
- rc: 1.0.0-rc.1</code></pre>
|
|
<h3>Branch Protection Checklist</h3>
|
|
<pre><code>✅ DO: Protect main/production branches
|
|
✅ DO: Require 1-2 approvals for PRs
|
|
✅ DO: Require status checks to pass
|
|
✅ DO: Dismiss stale reviews on new commits
|
|
✅ DO: Require conversation resolution
|
|
✅ DO: Require linear history for clean git log
|
|
|
|
❌ DON'T: Allow direct pushes to protected branches
|
|
❌ DON'T: Skip status checks for administrators (unless necessary)
|
|
❌ DON'T: Allow force pushes to protected branches</code></pre>
|
|
<hr>
|
|
<h2>Anti-Patterns</h2>
|
|
<h3>❌ No Branch Protection</h3>
|
|
<pre><code class="lang-bash"># WRONG: Allow direct pushes to main
|
|
# Anyone can push without review
|
|
git push origin main</code></pre>
|
|
<p><strong>Problems</strong>:</p>
|
|
<ul><li>No code review process</li><li>Untested code reaches production</li><li>No audit trail</li></ul>
|
|
<pre><code class="lang-bash"># CORRECT: Require PRs and reviews
|
|
# Settings → Branches → Add rule for main
|
|
# ✅ Require pull request reviews (2 approvals)
|
|
# ✅ Require status checks</code></pre>
|
|
<h3>❌ Hardcoded Secrets in Repository</h3>
|
|
<pre><code class="lang-yaml"># WRONG: Secrets in workflow file
|
|
env:
|
|
API_KEY: "sk-abc123xyz"
|
|
DATABASE_PASSWORD: "password123"</code></pre>
|
|
<p><strong>Problems</strong>:</p>
|
|
<ul><li>Secrets visible in git history</li><li>Security breach risk</li><li>Difficult to rotate credentials</li></ul>
|
|
<pre><code class="lang-yaml"># CORRECT: Use GitHub Secrets
|
|
env:
|
|
API_KEY: ${{ secrets.API_KEY }}
|
|
DATABASE_PASSWORD: ${{ secrets.DATABASE_PASSWORD }}
|
|
|
|
# Set via CLI
|
|
gh secret set API_KEY < api_key.txt</code></pre>
|
|
<h3>❌ No Release Process</h3>
|
|
<pre><code class="lang-bash"># WRONG: Push tags without documentation
|
|
git tag v1.0.0 && git push origin v1.0.0
|
|
# No release notes, no changelog</code></pre>
|
|
<p><strong>Problems</strong>:</p>
|
|
<ul><li>Users don't know what changed</li><li>No downloadable assets</li><li>Difficult to track versions</li></ul>
|
|
<pre><code class="lang-bash"># CORRECT: Create proper releases
|
|
gh release create v1.0.0 \
|
|
--title "Version 1.0.0" \
|
|
--notes-file CHANGELOG.md \
|
|
dist/*.tar.gz
|
|
|
|
# Include:
|
|
# - Version number (semantic versioning)
|
|
# - Release notes (what changed)
|
|
# - Downloadable assets (binaries, archives)</code></pre>
|
|
<h3>❌ Missing Templates</h3>
|
|
<p><strong>Problems</strong>:</p>
|
|
<ul><li>Inconsistent issue reports</li><li>Missing information in PRs</li><li>Wasted time asking for details</li></ul>
|
|
<pre><code class="lang-bash"># CORRECT: Create templates
|
|
mkdir -p .github/ISSUE_TEMPLATE
|
|
|
|
# Add bug report template
|
|
# Add feature request template
|
|
# Add pull request template
|
|
|
|
# Commit templates
|
|
git add .github/
|
|
git commit -m "Add issue and PR templates"</code></pre>
|
|
<h3>❌ Default Branch Named 'master'</h3>
|
|
<pre><code class="lang-bash"># WRONG: Using outdated default branch name
|
|
# main branch is called 'master'</code></pre>
|
|
<pre><code class="lang-bash"># CORRECT: Use 'main' as default branch
|
|
# Rename existing repository
|
|
git branch -m master main
|
|
git push -u origin main
|
|
|
|
# Update default branch on GitHub
|
|
gh repo edit owner/repo --default-branch main
|
|
|
|
# Delete old remote branch
|
|
git push origin --delete master</code></pre>
|
|
<hr>
|
|
<h2>Related Skills</h2>
|
|
<ul><li><code>collaboration/github/github-pull-requests.md</code> - PR workflow and code review process</li><li><code>collaboration/github/github-actions-workflows.md</code> - CI/CD automation with branch protection</li><li><code>collaboration/github/github-security-features.md</code> - Security settings and dependency management</li><li><code>collaboration/github/github-issues-projects.md</code> - Issue templates and project management</li><li><code>cicd/ci-security.md</code> - Secret management best practices</li><li><code>version-control/git-branching-strategies.md</code> - Branch naming and workflow strategies</li></ul>
|
|
<hr>
|
|
<p><strong>Last Updated</strong>: 2025-10-25</p>
|
|
<p><strong>Format Version</strong>: 1.0 (Atomic)</p>
|
|
<footer>
|
|
<div class="fmap">
|
|
<div><b>Build</b>
|
|
<a href="https://hanzo.app">hanzo.app</a> app builder
|
|
<a href="https://hanzo.codes">hanzo.codes</a> code with an agent
|
|
<a href="https://hanzoskills.com">hanzoskills.com</a> what an agent reads</div>
|
|
<div><b>Run</b>
|
|
<a href="https://console.hanzo.ai">console.hanzo.ai</a> cloud console
|
|
<a href="https://api.hanzo.ai">api.hanzo.ai</a> the API</div>
|
|
<div><b>Account</b>
|
|
<a href="https://hanzo.id">hanzo.id</a> sign in
|
|
<a href="https://pay.hanzo.ai">pay.hanzo.ai</a> top up
|
|
<a href="https://billing.hanzo.ai">billing.hanzo.ai</a> invoices and usage</div>
|
|
<div><b>Company</b>
|
|
<a href="https://hanzo.ai">hanzo.ai</a> canonical
|
|
<a href="https://hanzo.ventures">hanzo.ventures</a> ventures</div>
|
|
</div>
|
|
<div class="fend"><a href="/collaboration-github-repository-management.md">This page as plain text</a> · <a href="/llms.txt">Index for agents</a></div>
|
|
</footer>
|
|
</div></body></html> |