chore: restructure skills repo with new agents and skill bundles

- Add new skills: deep-dive, docs-rag, meta-creator, ppt-maker, sdlc - Add agent configs: g-assistent, meta-creator, sdlc with prompt files - Add reference docs for custom agents and skills specification - Add utility scripts: install-agents.sh, orchestrate.py, puml2svg.sh - Update README and commit-message skill config - Remove deprecated skills: codereview, python, testing, typescript - Add .gitignore
2026-04-18 13:07:46 +08:00
parent 72f16d26b8
commit c0d14c6ac1
74 changed files with 5726 additions and 324 deletions
@@ -0,0 +1,65 @@
+# commit-message
+
+Generates professional git commit messages following the [Conventional Commits](references/conventional-commits.md) standard.
+
+## Architecture
+
+![Architecture](assets/commit-message-architecture.svg)
+
+## Workflow
+
+![Workflow](assets/commit-message-workflow.svg)
+
+## When to Use
+
+- You're ready to commit and want a well-structured message
+- You want a suggestion before running `git commit`
+- Trigger phrases: "commit these changes", "give me a commit message", "wrap up my work"
+
+## How It Works
+
+1. Runs `git status` to find staged files
+2. Runs `git diff --cached` to analyze the changes
+3. Drafts a Conventional Commits message (type, scope, description, body, breaking changes)
+4. Presents the message and asks for confirmation or adjustments
+
+## Commit Format
+
+```
+<type>(<scope>): <description>
+
+[optional body]
+
+[optional footer / BREAKING CHANGE]
+```
+
+**Types:** `feat`, `fix`, `docs`, `style`, `refactor`, `perf`, `test`, `build`, `ci`, `chore`, `revert`
+
+## Examples
+
+| Staged changes | Suggested message |
+|---|---|
+| New JWT auth in `src/auth.ts` | `feat(auth): add JWT-based session management` |
+| Updated API docs | `docs: update API endpoints for user registration` |
+| Breaking API change | `feat(api)!: rename /users to /accounts` |
+
+## File Structure
+
+```
+skills/commit-message/
+├── SKILL.md
+├── README.md              # this file
+├── assets/
+│   ├── workflow.puml
+│   └── commit-message-workflow.svg
+├── evals/
+│   └── evals.json
+└── references/
+    └── conventional-commits.md
+```
+
+## Evals
+
+```bash
+python scripts/run_evals.py commit-message
+```
@@ -0,0 +1,24 @@
+@startuml commit-message-architecture
+skinparam componentStyle rectangle
+skinparam defaultFontName Arial
+skinparam backgroundColor #FAFAFA
+
+package "commit-message Skill" {
+  component "SKILL.md\n(instructions)" as SKILL
+  component "references/\nconventional-commits.md" as REF
+  component "evals/evals.json" as EVALS
+}
+
+package "Git Environment" {
+  database "Staged Changes\n(git index)" as INDEX
+  component "git commit" as GIT
+}
+
+actor Developer
+
+Developer --> SKILL : triggers skill
+SKILL --> REF : loads commit format rules
+SKILL --> INDEX : reads via git diff --cached
+SKILL --> Developer : proposes message
+Developer --> GIT : confirms & commits
+@enduml
@@ -0,0 +1,22 @@
+@startuml commit-message-workflow
+skinparam defaultFontName Arial
+skinparam backgroundColor #FAFAFA
+
+actor Developer
+participant "commit-message\nSkill" as SKILL
+participant "git" as GIT
+
+Developer -> SKILL : "commit these changes"
+SKILL -> GIT : git status
+GIT --> SKILL : staged files list
+SKILL -> GIT : git diff --cached
+GIT --> SKILL : diff output
+SKILL -> SKILL : draft Conventional Commits message
+SKILL --> Developer : proposed message
+alt confirmed
+  Developer -> GIT : git commit -m "..."
+else refine
+  Developer -> SKILL : feedback
+  SKILL --> Developer : revised message
+end
+@enduml