Skip to content

Commit f1908c8

Browse files
benymbenym
authored
feat: tailor github templates and support antigravity skill paths
2 parents 1101dc9 + 17875c4 commit f1908c8

23 files changed

Lines changed: 693 additions & 145 deletions

‎.github/ISSUE_TEMPLATE/bug_report.yml‎

Lines changed: 92 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,92 @@
1+
name: 🐛 Bug Report
2+
description: Report a reproducible problem with Comet.
3+
title: 'fix: '
4+
labels: ['bug']
5+
body:
6+
- type: checkboxes
7+
attributes:
8+
label: 🔎 Existing issue check
9+
description: Please search existing issues before opening a new one.
10+
options:
11+
- label: I have searched the existing issues.
12+
required: true
13+
14+
- type: dropdown
15+
attributes:
16+
label: 🎯 Affected area
17+
description: Which part of Comet is affected?
18+
options:
19+
- CLI command
20+
- Skill installation
21+
- Comet workflow skill
22+
- Shell script
23+
- Documentation
24+
- CI / release
25+
- Other
26+
validations:
27+
required: true
28+
29+
- type: input
30+
attributes:
31+
label: 📦 Comet version
32+
description: Run `comet --version` or check the installed package version.
33+
placeholder: '0.2.8'
34+
validations:
35+
required: false
36+
37+
- type: textarea
38+
attributes:
39+
label: 💥 Current behavior
40+
description: What happened?
41+
placeholder: 'Describe the error, unexpected output, or broken workflow.'
42+
validations:
43+
required: true
44+
45+
- type: textarea
46+
attributes:
47+
label: ✅ Expected behavior
48+
description: What did you expect to happen?
49+
validations:
50+
required: true
51+
52+
- type: textarea
53+
attributes:
54+
label: 🔁 Steps to reproduce
55+
description: Include the exact command, project state, and options used.
56+
placeholder: |
57+
1. In a project with ...
58+
2. Run `comet init --scope project --json`
59+
3. See ...
60+
validations:
61+
required: true
62+
63+
- type: textarea
64+
attributes:
65+
label: 🖥️ Environment
66+
description: Please include versions and platform details that may affect reproduction.
67+
value: |
68+
- OS:
69+
- Shell:
70+
- Node:
71+
- Package manager:
72+
- Install scope: project / global
73+
- Skill language: en / zh
74+
- Target AI platform(s):
75+
render: markdown
76+
validations:
77+
required: true
78+
79+
- type: textarea
80+
attributes:
81+
label: 📋 Logs or output
82+
description: Paste terminal output, stack traces, or JSON output. Remove secrets before posting.
83+
render: shell
84+
validations:
85+
required: false
86+
87+
- type: textarea
88+
attributes:
89+
label: 🧩 Additional context
90+
description: Links, screenshots, related specs, or anything else that helps explain the issue.
91+
validations:
92+
required: false

‎.github/ISSUE_TEMPLATE/config.yml‎

Lines changed: 8 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,8 @@
1+
blank_issues_enabled: false
2+
contact_links:
3+
- name: 📚 Comet documentation
4+
url: https://github.com/rpamis/comet#readme
5+
about: Read the installation guide, command reference, and workflow overview.
6+
- name: 💬 Comet discussions
7+
url: https://github.com/rpamis/comet/discussions
8+
about: Ask open-ended questions or discuss ideas that are not ready for an issue.

‎.github/ISSUE_TEMPLATE/feature_request.yml‎

Lines changed: 79 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,79 @@
1+
name: 🚀 Feature Request
2+
description: Suggest an improvement to Comet.
3+
title: 'feat: '
4+
labels: ['enhancement', 'needs-triage']
5+
body:
6+
- type: checkboxes
7+
attributes:
8+
label: 🔎 Existing issue check
9+
description: Please search existing issues before opening a new one.
10+
options:
11+
- label: I have searched the existing issues.
12+
required: true
13+
14+
- type: textarea
15+
attributes:
16+
label: 🧭 Problem
17+
description: What workflow problem should this solve?
18+
placeholder: 'When using Comet to ..., I need ...'
19+
validations:
20+
required: true
21+
22+
- type: textarea
23+
attributes:
24+
label: ✨ Proposed solution
25+
description: Describe the behavior you want Comet to provide.
26+
validations:
27+
required: true
28+
29+
- type: dropdown
30+
attributes:
31+
label: 🎯 Primary area
32+
description: Where would this feature live?
33+
options:
34+
- CLI command
35+
- Platform support
36+
- Skill workflow
37+
- Shell script
38+
- Documentation
39+
- CI / release
40+
- Other
41+
validations:
42+
required: true
43+
44+
- type: dropdown
45+
attributes:
46+
label: 🪐 Workflow phase
47+
description: If this affects a Comet phase, choose the closest one.
48+
options:
49+
- Not phase-specific
50+
- Open
51+
- Design
52+
- Build
53+
- Verify
54+
- Archive
55+
- Hotfix
56+
validations:
57+
required: false
58+
59+
- type: textarea
60+
attributes:
61+
label: 🔀 Alternatives considered
62+
description: What workarounds or alternate designs have you considered?
63+
validations:
64+
required: false
65+
66+
- type: textarea
67+
attributes:
68+
label: 🧰 Compatibility notes
69+
description: Mention affected platforms, install scopes, languages, or shell environments if relevant.
70+
placeholder: 'For example: project/global scope, English/Chinese skills, macOS/Linux/Windows Git Bash.'
71+
validations:
72+
required: false
73+
74+
- type: textarea
75+
attributes:
76+
label: 🧩 Additional context
77+
description: Links, examples, screenshots, or related projects.
78+
validations:
79+
required: false

‎.github/ISSUE_TEMPLATE/question.yml‎

Lines changed: 44 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,44 @@
1+
name: 💬 Question
2+
description: Ask about installing, configuring, or using Comet.
3+
title: 'question: '
4+
labels: ['question']
5+
body:
6+
- type: textarea
7+
attributes:
8+
label: ❓ Question
9+
description: What are you trying to understand or accomplish?
10+
placeholder: 'I am trying to use Comet to ...'
11+
validations:
12+
required: true
13+
14+
- type: textarea
15+
attributes:
16+
label: 🔍 What you tried
17+
description: Include commands, configuration, docs you read, or workflow steps you followed.
18+
placeholder: |
19+
- Ran `comet init ...`
20+
- Read `README.md` section ...
21+
validations:
22+
required: false
23+
24+
- type: textarea
25+
attributes:
26+
label: 🖥️ Environment
27+
description: Add details if the question depends on your setup.
28+
value: |
29+
- OS:
30+
- Shell:
31+
- Node:
32+
- Install scope: project / global
33+
- Skill language: en / zh
34+
- Target AI platform(s):
35+
render: markdown
36+
validations:
37+
required: false
38+
39+
- type: textarea
40+
attributes:
41+
label: 🧩 Additional context
42+
description: Links, screenshots, logs, or related issues.
43+
validations:
44+
required: false

‎.github/ISSUE_TEMPLATE/task.yml‎

Lines changed: 59 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,59 @@
1+
name: 🛠️ Maintenance Task
2+
description: Track project maintenance, refactoring, docs, or release work.
3+
title: 'chore: '
4+
labels: ['task']
5+
body:
6+
- type: textarea
7+
attributes:
8+
label: 🎯 Goal
9+
description: What needs to be done, and why?
10+
placeholder: 'Update ... so that ...'
11+
validations:
12+
required: true
13+
14+
- type: dropdown
15+
attributes:
16+
label: 🧱 Task type
17+
options:
18+
- Refactor
19+
- Documentation
20+
- Tests
21+
- CI
22+
- Release
23+
- Dependencies
24+
- Repository maintenance
25+
- Other
26+
validations:
27+
required: true
28+
29+
- type: textarea
30+
attributes:
31+
label: 📌 Scope
32+
description: List the files, commands, platforms, or workflows that are expected to change.
33+
placeholder: |
34+
- `src/...`
35+
- `assets/skills/...`
36+
- `test/...`
37+
validations:
38+
required: false
39+
40+
- type: textarea
41+
attributes:
42+
label: ✅ Acceptance criteria
43+
description: What must be true when this task is complete?
44+
placeholder: |
45+
- [ ] ...
46+
- [ ] ...
47+
validations:
48+
required: true
49+
50+
- type: textarea
51+
attributes:
52+
label: 🧪 Suggested verification
53+
description: Commands or manual checks that should pass.
54+
placeholder: |
55+
- `pnpm build`
56+
- `pnpm lint`
57+
- `pnpm test`
58+
validations:
59+
required: false

‎.github/PULL_REQUEST_TEMPLATE.md‎

Lines changed: 41 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,41 @@
1+
## ✨ Summary
2+
3+
<!-- What changed, and why? Link related issues when available. -->
4+
5+
## 🎯 Scope
6+
7+
<!-- Check all areas touched by this PR. -->
8+
9+
- [ ] CLI commands (`init`, `status`, `doctor`, `update`)
10+
- [ ] Core installer / platform detection
11+
- [ ] Comet skills (`assets/skills/`, `assets/skills-zh/`)
12+
- [ ] Comet shell scripts (`assets/skills/comet/scripts/`)
13+
- [ ] Tests / CI
14+
- [ ] Documentation / changelog
15+
- [ ] Other:
16+
17+
## 🧪 Testing
18+
19+
<!-- List the commands you ran and summarize the result. -->
20+
21+
- [ ] `pnpm build`
22+
- [ ] `pnpm lint`
23+
- [ ] `pnpm format:check`
24+
- [ ] `pnpm test`
25+
- [ ] `pnpm test -- test/ts/comet-scripts.test.ts`
26+
- [ ] `pnpm test:shell`
27+
- [ ] Not run:
28+
29+
## ✅ Checklist
30+
31+
- [ ] PR title follows Conventional Commits, for example `fix: handle project-scope init`
32+
- [ ] User-facing behavior is documented in `README.md`, `README-zh.md`, or `CONTRIBUTING.md`
33+
- [ ] `CHANGELOG.md` is updated when behavior changes
34+
- [ ] Skill changes were made in Chinese first when applicable, then synced to English
35+
- [ ] New scripts are included in `assets/manifest.json` and relevant tests
36+
- [ ] Shell scripts remain portable across macOS, Linux, and Windows Git Bash
37+
- [ ] No unrelated generated files or local artifacts are included
38+
39+
## 👀 Notes for Reviewers
40+
41+
<!-- Anything reviewers should pay special attention to? -->

‎.github/workflows/ci.yml‎

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -129,7 +129,7 @@ jobs:
129129
.gemini/skills .amazonq/skills .qwen/skills .kilocode/skills \
130130
.augment/skills .kiro/skills .lingma/skills .junie/skills \
131131
.codebuddy/skills .cospec/skills .crush/skills .factory/skills \
132-
.iflow/skills .pi/skills .qoder/skills .agent/skills \
132+
.iflow/skills .pi/skills .qoder/skills .agents/skills \
133133
.bob/skills .forge/skills .trae/skills .github/skills; do
134134
check_file "$PROJ/$sd/comet/SKILL.md"
135135
check_file "$PROJ/$sd/comet/scripts/comet-guard.sh"
@@ -197,7 +197,7 @@ jobs:
197197
.gemini/skills .amazonq/skills .qwen/skills .kilocode/skills \
198198
.augment/skills .kiro/skills .lingma/skills .junie/skills \
199199
.codebuddy/skills .cospec/skills .crush/skills .factory/skills \
200-
.iflow/skills .pi/skills .qoder/skills .agent/skills \
200+
.iflow/skills .pi/skills .qoder/skills .gemini/antigravity/skills \
201201
.bob/skills .forge/skills .trae/skills .github/skills; do
202202
check_file "$HOME_DIR/$sd/comet/SKILL.md"
203203
check_file "$HOME_DIR/$sd/comet/scripts/comet-guard.sh"

‎.github/workflows/greeting-guideline-pr.yml‎

Lines changed: 34 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,34 @@
1+
name: Greetings
2+
3+
on:
4+
pull_request:
5+
types: [opened]
6+
7+
permissions:
8+
pull-requests: write
9+
contents: read
10+
11+
jobs:
12+
greeting:
13+
runs-on: ubuntu-latest
14+
steps:
15+
- uses: actions/first-interaction@v2.0.0
16+
with:
17+
repo_token: ${{ secrets.GITHUB_TOKEN }}
18+
pr_message: |-
19+
👋 Thanks for opening your first PR to Comet, @${{ github.actor }}.
20+
21+
Before review, please make sure the PR title follows Conventional Commits, for example `fix: handle project-scope init`, and that the checklist in the PR template is up to date.
22+
23+
🧪 The most useful local checks are:
24+
25+
```bash
26+
pnpm build
27+
pnpm lint
28+
pnpm format:check
29+
pnpm test
30+
```
31+
32+
🧰 If your change touches `assets/skills/comet/scripts/`, please also check script portability across macOS, Linux, and Windows Git Bash. Avoid `sed -i`, support both `sha256sum` and `shasum -a 256`, and guard optional `grep` pipelines with `|| true`.
33+
34+
✨ We appreciate the contribution and will take a look as soon as we can.

0 commit comments

Comments
 (0)