@rpamis/comet 0.4.2 → 0.4.3
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/LICENSE +21 -21
- package/README.md +332 -332
- package/assets/manifest.json +1 -1
- package/assets/skills/comet/scripts/comet-check.mjs +89 -89
- package/assets/skills/comet/scripts/comet-guard.mjs +102 -102
- package/assets/skills/comet/scripts/comet-hook-router.mjs +106 -106
- package/assets/skills/comet/scripts/comet-runtime.mjs +227 -227
- package/assets/skills/comet/scripts/comet-state.mjs +124 -124
- package/assets/skills/comet-classic/SKILL.md +2 -0
- package/assets/skills/comet-classic/reference/scripts.md +8 -0
- package/assets/skills/comet-hotfix/SKILL.md +1 -0
- package/assets/skills/comet-native/SKILL.md +3 -1
- package/assets/skills/comet-native/reference/commands.md +10 -0
- package/assets/skills/comet-native/scripts/comet-native-next.mjs +13 -13
- package/assets/skills/comet-native/scripts/comet-native-runtime.mjs +31 -31
- package/assets/skills/comet-native/scripts/comet-native-show.mjs +26 -26
- package/assets/skills/comet-tweak/SKILL.md +1 -0
- package/assets/skills-zh/comet-classic/SKILL.md +2 -0
- package/assets/skills-zh/comet-classic/reference/scripts.md +2 -0
- package/assets/skills-zh/comet-hotfix/SKILL.md +1 -0
- package/assets/skills-zh/comet-native/SKILL.md +3 -1
- package/assets/skills-zh/comet-native/reference/commands.md +10 -0
- package/assets/skills-zh/comet-tweak/SKILL.md +1 -0
- package/bin/comet-daemon-router.js +35 -7
- package/dist/app/commands/daemon-server.d.ts.map +1 -1
- package/dist/app/commands/daemon-server.js +1 -0
- package/dist/app/commands/daemon-server.js.map +1 -1
- package/dist/app/commands/project-knowledge.d.ts.map +1 -1
- package/dist/app/commands/project-knowledge.js +0 -1
- package/dist/app/commands/project-knowledge.js.map +1 -1
- package/dist/domains/comet-classic/classic-check-snapshot.d.ts +2 -0
- package/dist/domains/comet-classic/classic-check-snapshot.d.ts.map +1 -1
- package/dist/domains/comet-classic/classic-check-snapshot.js +22 -1
- package/dist/domains/comet-classic/classic-check-snapshot.js.map +1 -1
- package/dist/domains/comet-native/native-portable-checks.d.ts +1 -0
- package/dist/domains/comet-native/native-portable-checks.d.ts.map +1 -1
- package/dist/domains/comet-native/native-portable-checks.js +8 -6
- package/dist/domains/comet-native/native-portable-checks.js.map +1 -1
- package/dist/domains/project-knowledge/corpus.d.ts +5 -0
- package/dist/domains/project-knowledge/corpus.d.ts.map +1 -1
- package/dist/domains/project-knowledge/corpus.js +34 -9
- package/dist/domains/project-knowledge/corpus.js.map +1 -1
- package/dist/domains/project-knowledge/index-store.d.ts +5 -2
- package/dist/domains/project-knowledge/index-store.d.ts.map +1 -1
- package/dist/domains/project-knowledge/index-store.js +95 -52
- package/dist/domains/project-knowledge/index-store.js.map +1 -1
- package/dist/domains/project-knowledge/local-provider.d.ts.map +1 -1
- package/dist/domains/project-knowledge/local-provider.js +14 -3
- package/dist/domains/project-knowledge/local-provider.js.map +1 -1
- package/dist/domains/project-knowledge/local-store.d.ts +2 -2
- package/dist/domains/project-knowledge/local-store.d.ts.map +1 -1
- package/dist/domains/project-knowledge/local-store.js +2 -2
- package/dist/domains/project-knowledge/local-store.js.map +1 -1
- package/dist/domains/project-knowledge/plugin.d.ts.map +1 -1
- package/dist/domains/project-knowledge/plugin.js +5 -4
- package/dist/domains/project-knowledge/plugin.js.map +1 -1
- package/dist/domains/project-knowledge/provider-factory.d.ts.map +1 -1
- package/dist/domains/project-knowledge/provider-factory.js +7 -5
- package/dist/domains/project-knowledge/provider-factory.js.map +1 -1
- package/dist/domains/project-knowledge/types.d.ts +1 -0
- package/dist/domains/project-knowledge/types.d.ts.map +1 -1
- package/dist/domains/skill/platform-install.d.ts.map +1 -1
- package/dist/domains/skill/platform-install.js +31 -3
- package/dist/domains/skill/platform-install.js.map +1 -1
- package/dist/platform/process/comet-daemon.d.ts.map +1 -1
- package/dist/platform/process/comet-daemon.js +1 -0
- package/dist/platform/process/comet-daemon.js.map +1 -1
- package/dist/platform/process/windows-process-broker.d.ts +12 -0
- package/dist/platform/process/windows-process-broker.d.ts.map +1 -0
- package/dist/platform/process/windows-process-broker.js +91 -0
- package/dist/platform/process/windows-process-broker.js.map +1 -0
- package/package.json +1 -1
package/README.md
CHANGED
|
@@ -1,332 +1,332 @@
|
|
|
1
|
-
<p align="center">
|
|
2
|
-
<a href="https://github.com/rpamis/comet/blob/master/img/title-log.png">
|
|
3
|
-
<picture>
|
|
4
|
-
<source srcset="https://github.com/rpamis/comet/blob/master/img/title-log.png">
|
|
5
|
-
<img src="https://github.com/rpamis/comet/blob/master/img/title-log.png" alt="Comet logo">
|
|
6
|
-
</picture>
|
|
7
|
-
</a>
|
|
8
|
-
</p>
|
|
9
|
-
|
|
10
|
-
<p align="center">
|
|
11
|
-
<a href="https://github.com/rpamis/comet/actions/workflows/ci.yml"><img alt="CI" src="https://img.shields.io/github/actions/workflow/status/rpamis/comet/ci.yml?branch=master&style=flat-square&label=CI" /></a>
|
|
12
|
-
<a href="https://app.codecov.io/gh/rpamis/comet/tree/master"><img alt="codecov" src="https://img.shields.io/codecov/c/github/rpamis/comet/master?style=flat-square&label=coverage&color=%23E61A7A" /></a>
|
|
13
|
-
<a href="https://deepwiki.com/rpamis/comet"><img alt="DeepWiki" src="https://img.shields.io/badge/DeepWiki-rpamis%2Fcomet-blue?style=flat-square" /></a>
|
|
14
|
-
<a href="https://www.npmjs.com/package/@rpamis/comet"><img alt="npm version" src="https://img.shields.io/npm/v/@rpamis/comet?style=flat-square" /></a>
|
|
15
|
-
<a href="https://www.npmjs.com/package/@rpamis/comet"><img alt="npm total download count" src="https://img.shields.io/npm/dt/@rpamis/comet?style=flat-square&label=Downloads" /></a>
|
|
16
|
-
<a href="https://www.npmjs.com/package/@rpamis/comet"><img alt="npm monthly download count" src="https://img.shields.io/npm/dm/@rpamis/comet?style=flat-square&label=Downloads/mo" /></a>
|
|
17
|
-
<a href="https://docs.comet.rpamis.com/"><img alt="Comet Docs" src="https://img.shields.io/badge/Docs-docs.comet.rpamis.com-FFD700?style=flat-square" /></a>
|
|
18
|
-
<a href="./LICENSE"><img alt="License: MIT" src="https://img.shields.io/badge/License-MIT-blue.svg?style=flat-square" /></a>
|
|
19
|
-
<a href="https://atomgit.com/rpamis/comet"><img alt="AtomGitStars" src="https://atomgit.com/rpamis/comet/star/badge.svg" /></a>
|
|
20
|
-
</p>
|
|
21
|
-
|
|
22
|
-
<p align="center">
|
|
23
|
-
<a href="https://trendshift.io/repositories/38989?utm_source=repository-badge&utm_medium=badge&utm_campaign=badge-repository-38989" target="_blank" rel="noopener noreferrer"><img src="https://trendshift.io/api/badge/repositories/38989" alt="rpamis%2Fcomet | Trendshift" width="250" height="55"/></a>
|
|
24
|
-
</p>
|
|
25
|
-
|
|
26
|
-
## What is Comet ?
|
|
27
|
-
|
|
28
|
-
```
|
|
29
|
-
██████╗ ██████╗ ███╗ ███╗███████╗████████╗
|
|
30
|
-
██╔════╝██╔═══██╗████╗ ████║██╔════╝╚══██╔══╝
|
|
31
|
-
██║ ██║ ██║██╔████╔██║█████╗ ██║
|
|
32
|
-
██║ ██║ ██║██║╚██╔╝██║██╔══╝ ██║
|
|
33
|
-
╚██████╗╚██████╔╝██║ ╚═╝ ██║███████╗ ██║
|
|
34
|
-
╚═════╝ ╚═════╝ ╚═╝ ╚═╝╚══════╝ ╚═╝
|
|
35
|
-
```
|
|
36
|
-
|
|
37
|
-
> 中文版:[README-zh.md](README-zh.md)
|
|
38
|
-
> [Bilibili video](https://www.bilibili.com/video/BV1y4Gi6CEo1/?spm_id_from=333.1387.homepage.video_card.click&vd_source=d22726fe6b108647dbebf1c5d8817377)
|
|
39
|
-
> [DouYin](https://www.douyin.com/search/comet?aid=cd8fcc82-498b-4d59-8860-617deb719412&modal_id=7646429015808936293&type=general)
|
|
40
|
-
|
|
41
|
-
**Comet is a resumable long-running task workflow and Skill platform for coding.**
|
|
42
|
-
|
|
43
|
-
It provides two independent requirements workflows: Native for strong models, powered only by Comet's own runtime, and Classic, which preserves the full OpenSpec + Superpowers phase-governance model. Comet also covers Skill creation, evaluation, and release.
|
|
44
|
-
|
|
45
|
-
It allows you to use a toolchain to handle everything from requirements to archiving, combine any skill to make it like Comet, evolving your skills based on scientific **Rubric**, **Pass@k**, and **Pass^k** scoring.
|
|
46
|
-
|
|
47
|
-
> [!IMPORTANT]
|
|
48
|
-
> **Comet 0.4.0 stable release** — Building on 0.3.9, this release adds Native workflows, multi-agent collaboration, memory and knowledge management, and a complete toolchain for creating, distributing, and evaluating Skills.
|
|
49
|
-
>
|
|
50
|
-
> - **Native workflows for strong models**: After requirements are confirmed, the Agent chooses how to plan, implement, test, and review. Comet handles state checks, acceptance, and resumable archive. Native runs independently of Classic, which retains the OpenSpec + Superpowers five-phase methodology; both share configuration, status, Dashboard, and Eval entry points.
|
|
51
|
-
> - **Parallel delivery for complex requirements**: Supervisor Changes split a goal into dependency-aware child changes. Independent Codex sessions or Claude Code Agent Teams implement and verify them in isolated worktrees, then integrate them in dependency order before the parent change's final acceptance.
|
|
52
|
-
> - **Manageable Personal Memory and Project Knowledge**: Retain collaboration preferences and reusable experience across tasks, and progressively supply context relevant to the current task. You can inspect, correct, forget, or pause it; new lessons start in trial and gain supporting evidence through actual adoption and verification.
|
|
53
|
-
> - **Skill creation, distribution, and evaluation**: Compose any Skills with `/comet-any` and package them for distribution. Use `comet eval` with Rubric, Pass@k, Pass^k, and LangSmith to compare results and guide Skill improvements.
|
|
54
|
-
> - **A unified three-pane Dashboard**: Inspect Native and Classic progress, Git worktrees, acceptance results, and archives in your browser, and manage Personal Memory, Project Knowledge, and plugin settings.
|
|
55
|
-
> - **Cross-platform execution and recovery**: A pure Node.js Runtime supports Windows, macOS, and Linux without Bash or WSL. Task state stays in the project so work can resume after interruptions or session changes; CLI output identifies the next step and decisions that need your input.
|
|
56
|
-
>
|
|
57
|
-
> In the existing aligned Native vs. 0.4.0 Classic experiment (16 tasks, 48 runs per treatment), the 41 paired samples where both passed showed **76.8% fewer total tokens**, **57.4% fewer Agent rounds**, and **47.4% less time** for Native. Across the full sample, Native achieved **87.5% pass^3 (+12.5 percentage points)**, while both treatments reached **100% pass@3**. See the [evaluation report](https://docs.comet.rpamis.com/en/eval/comet-native-vs-040-experiment) for conditions and limitations, and the [Changelog](https://docs.comet.rpamis.com/en/changelog) for all changes.
|
|
58
|
-
|
|
59
|
-
> Native and Classic are not lightweight and heavyweight tiers, and neither upgrades into the other. Native is for strong models that can plan and verify autonomously; Classic is for scenarios that benefit from a complete phased methodology and stronger constraints.
|
|
60
|
-
|
|
61
|
-
## Why Comet
|
|
62
|
-
|
|
63
|
-
- **Native workflow for strong models** — `/comet-native` uses a detailed brief, complete target specifications, phase checks, and recoverable archive to constrain outcomes while leaving planning, implementation, testing, and review methods to the model. User-readable artifacts live under `docs/comet/` by default, fully separate from Classic. See the [Native workflow guide](https://docs.comet.rpamis.com/en/native/quickstart).
|
|
64
|
-
- **One-way, resumable Native archive** — Archive first returns a single dry-run continuation command, with explicit isolated-workspace finish choices and blocker paths; continuing the workflow lets Runtime own the archive commit without repeated status queries or manual runtime-file commits.
|
|
65
|
-
- **Supervisor Changes for complex requirements** — Native can split work along real delivery boundaries, manage dependencies and readiness as a DAG, let multiple agents implement and verify in Runtime-created worktrees, and then integrate the results before the parent change's final acceptance.
|
|
66
|
-
- **The stable core for long-running tasks** — Comet's Classic Spec mode combines OpenSpec and Superpowers into a five-phase flow with a state machine, phase checks, and scripts. It suits work that needs an explicit method and strong constraints; its permanent entry point is `/comet-classic`.
|
|
67
|
-
- **A configuration-driven shared entry point** — `/comet` reads only the project's `.comet/config.yaml` and deterministically forwards to `/comet-native` or `/comet-classic`. It does not guess from task size or mix changes, state, or directories across workflows. `comet resume-probe` uses the same configuration to resume through the correct permanent entry point.
|
|
68
|
-
- **Skill platform** — Comet can author reusable Skill packages and use `/comet-any` to organize them into distributable
|
|
69
|
-
Bundles, so Skills you create can be distributed to coding platforms with one command, much like `comet init`.
|
|
70
|
-
- **Eval platform** — Comet assesses your skills using scientific Rubric, Pass@k, and Pass^k scoring, ensuring skill evolution is based on scientific evidence rather than intuition. It supports integration with LangSmith assessments, bringing evaluation to real-world enterprise production environments. Its dual-agent architecture automates the assessment process in your production environment.
|
|
71
|
-
|
|
72
|
-
## Supervisor Change: coordinated delivery across multiple agents
|
|
73
|
-
|
|
74
|
-
When a requirement contains multiple deliverables that can be implemented and verified independently, a Supervisor Change confirms the child changes and their dependencies before coordinating independent Codex sessions or Claude Code Agent Teams. The Runtime remains responsible for worktrees, task identity, verification, ordered integration, and the parent change's final Verify.
|
|
75
|
-
|
|
76
|
-
`Complex goal → child-change DAG → isolated worktrees → independent implementation and verification → ordered integration → final parent Verify`
|
|
77
|
-
|
|
78
|
-
**Codex multi-session execution**
|
|
79
|
-
<a href="https://github.com/rpamis/comet/blob/master/img/supervisor-codex.mp4">
|
|
80
|
-
<img src="https://github.com/rpamis/comet/blob/master/img/supervisor-codex-preview.png" alt="Comet Supervisor coordinating independent Codex sessions" width="100%">
|
|
81
|
-
</a><br>
|
|
82
|
-
<a href="https://github.com/rpamis/comet/blob/master/img/supervisor-codex.mp4">▶ Play the full demo</a>
|
|
83
|
-
**Claude Code Agent Teams execution**
|
|
84
|
-
<a href="https://github.com/rpamis/comet/blob/master/img/supervisor-claude-code.mp4">
|
|
85
|
-
<img src="https://github.com/rpamis/comet/blob/master/img/supervisor-claude-code-preview.png" alt="Comet Supervisor coordinating a Claude Code Agent Team" width="100%">
|
|
86
|
-
</a><br>
|
|
87
|
-
<a href="https://github.com/rpamis/comet/blob/master/img/supervisor-claude-code.mp4">▶ Play the full demo</a>
|
|
88
|
-
## Extremely low memory threshold
|
|
89
|
-
|
|
90
|
-
With Comet, you only need to remember two skills and one command, covering coding, creation, and evaluation with an extremely low barrier to entry:
|
|
91
|
-
|
|
92
|
-
- Use `/comet` to enter the project's configured Native or Classic workflow
|
|
93
|
-
- Use `/comet-any` to compose any Skills
|
|
94
|
-
- Use `comet eval` to evaluate any Skill
|
|
95
|
-
|
|
96
|
-
## Comet 0.4.0 Baseline Comparison
|
|
97
|
-
|
|
98
|
-
The following charts are from 16 Comet workflow tasks, with 5 samples per treatment, comparing no Comet, Comet 0.3.9, and Comet 0.4.0.
|
|
99
|
-
|
|
100
|
-
The core observations were the differences in Pass@5, Pass^5, and Rubric scores. The baseline without Comet Skills only validated business behavior.
|
|
101
|
-
|
|
102
|
-
<p align="center">
|
|
103
|
-
<img src="https://github.com/rpamis/comet/blob/master/img/comet-eval-pass5.png" alt="Comet pass@5 and pass^5 baseline comparison" width="920">
|
|
104
|
-
</p>
|
|
105
|
-
|
|
106
|
-
<p align="center">
|
|
107
|
-
<img src="https://github.com/rpamis/comet/blob/master/img/comet-eval-rubric-core.png" alt="Comet core rubric and LLM-as-judge baseline comparison" width="920">
|
|
108
|
-
</p>
|
|
109
|
-
|
|
110
|
-
## From Industry-Frontier Practice
|
|
111
|
-
|
|
112
|
-
Many Comet capabilities have parallels in current industry practice.
|
|
113
|
-
|
|
114
|
-
> To compare Comet with those patterns, see [Comet Docs](https://docs.comet.rpamis.com/zh/tech-blog/comet-vs-industry).
|
|
115
|
-
|
|
116
|
-
## What You Can Learn
|
|
117
|
-
|
|
118
|
-
- **How to reliably trigger nested Skills** — not by making an agent perform something that merely looks like a Skill
|
|
119
|
-
trigger, such as writing files based on a Skill description, but by actually triggering the Skill. Comet invokes many
|
|
120
|
-
OpenSpec and Superpowers capabilities, with trigger prompts refined through broad real-world practice.
|
|
121
|
-
- **How to make composed Skills advance through multiple phases automatically** — not through manual intervention. Aside
|
|
122
|
-
from necessary user choices, Comet's five-phase flow can trigger core Skills automatically while the state machine keeps
|
|
123
|
-
transitions reliable.
|
|
124
|
-
- **How to make a Spec lifecycle resumable** — Comet links OpenSpec change/spec artifacts with Superpowers design and
|
|
125
|
-
plan documents, then records phase, execution mode, verification result, and archive status in each change's
|
|
126
|
-
`.comet.yaml`, so an agent can continue after interruption instead of rereading documents and guessing progress.
|
|
127
|
-
- **How to turn doc synchronization from reminders into automation** — Comet scripts handoff, state updates, validation,
|
|
128
|
-
and archive sync, reducing repeated prompts such as "remember to update the design doc" or "remember to archive the
|
|
129
|
-
change."
|
|
130
|
-
- **How to design guard conditions that agents can execute** — phase exits do not rely on an agent saying "done." Scripts
|
|
131
|
-
such as `comet-guard.mjs`, `comet-yaml-validate.mjs`, and `comet-state.mjs` check tasks, state fields, verification
|
|
132
|
-
evidence, and archive conditions before the workflow advances.
|
|
133
|
-
- **How to distribute and install Skills across platforms** — Comet supports many AI coding platforms, project/global
|
|
134
|
-
install scopes, Chinese/English Skill variants, and platform-specific directories such as Antigravity's different
|
|
135
|
-
project/global paths.
|
|
136
|
-
- **How to turn scripts into agent workflow infrastructure** — Comet scripts handle hashes, YAML fields, state machines,
|
|
137
|
-
and archive flow, showing how workflow control that is easy to scatter across prompts can become testable, reusable
|
|
138
|
-
tooling.
|
|
139
|
-
- **How to evolve Skills through scientific evaluation** — Comet Eval supports structured rubric scoring plus Pass@k and
|
|
140
|
-
Pass^k metrics, with both local and LangSmith evaluation paths for production use.
|
|
141
|
-
- **How to create Comet-like Skills intelligently** — `/comet-any` composes arbitrary Skills. You describe your Skill
|
|
142
|
-
preferences, and the agent handles stability-related hooks, rules, scripts, and referenced Skill files for you.
|
|
143
|
-
|
|
144
|
-
## Install
|
|
145
|
-
|
|
146
|
-
Requirements:
|
|
147
|
-
|
|
148
|
-
- Node.js 22.16+ (22.x), or 24+
|
|
149
|
-
- npm/npx
|
|
150
|
-
- Git
|
|
151
|
-
|
|
152
|
-
```bash
|
|
153
|
-
npm install -g @rpamis/comet
|
|
154
|
-
```
|
|
155
|
-
|
|
156
|
-
## Quick Start
|
|
157
|
-
|
|
158
|
-
Initialize Comet in the project where you want to use it:
|
|
159
|
-
|
|
160
|
-
```bash
|
|
161
|
-
cd your-project
|
|
162
|
-
comet init
|
|
163
|
-
# Invoke /comet in the host
|
|
164
|
-
```
|
|
165
|
-
|
|
166
|
-
Interactive setup explains and offers Native, Classic, or both. Native is for strong models that can implement and verify autonomously; Classic is for tasks that need full Spec/TDD phase constraints; Both installs two independent entries while keeping `/comet` on Native by default. Non-interactive new projects default to Native, and project configuration is unified at `.comet/config.yaml`:
|
|
167
|
-
|
|
168
|
-
```bash
|
|
169
|
-
comet init --workflow classic
|
|
170
|
-
comet init --workflow both
|
|
171
|
-
```
|
|
172
|
-
|
|
173
|
-
### Project configuration
|
|
174
|
-
|
|
175
|
-
`comet init` generates `.comet/config.yaml` with field-level comments in the selected language. `comet update` fills new managed defaults while preserving user values and unknown extensions.
|
|
176
|
-
|
|
177
|
-
<details>
|
|
178
|
-
<summary>View the compact config shape when Native and Classic are both enabled</summary>
|
|
179
|
-
|
|
180
|
-
```yaml
|
|
181
|
-
schema: comet.project.v1
|
|
182
|
-
default_workflow: native
|
|
183
|
-
workflows: [native, classic]
|
|
184
|
-
ambient_resume: true
|
|
185
|
-
|
|
186
|
-
memory:
|
|
187
|
-
learning: true
|
|
188
|
-
retrieval: true
|
|
189
|
-
knowledge:
|
|
190
|
-
provider: local
|
|
191
|
-
hook:
|
|
192
|
-
allow_paths: []
|
|
193
|
-
|
|
194
|
-
native:
|
|
195
|
-
artifact_root: docs
|
|
196
|
-
language: en
|
|
197
|
-
clarification_mode: batch
|
|
198
|
-
archive_confirmation: automatic
|
|
199
|
-
max_verify_failures: 5
|
|
200
|
-
|
|
201
|
-
classic:
|
|
202
|
-
artifact_layout: docs
|
|
203
|
-
language: en
|
|
204
|
-
context_compression: off
|
|
205
|
-
review_mode: standard
|
|
206
|
-
auto_transition: true
|
|
207
|
-
```
|
|
208
|
-
|
|
209
|
-
- `default_workflow` selects the default `/comet` entry and must be present in `workflows`. `ambient_resume`, `memory`, `knowledge`, and `hook` are shared by both workflows.
|
|
210
|
-
- `memory.learning` / `retrieval` control personal-memory learning and injection. `knowledge.local.include` can append project-relative Markdown globs. `hook.allow_paths` is empty by default; add project-relative directories only when guarded phases must write shared files. It cannot bypass protection for `.comet` or workflow artifacts.
|
|
211
|
-
- Native stores user-readable artifacts under `docs/comet/` and machine Runtime under `.comet/runtime/native/`. Use `comet init --workflow native --root artifacts` for `artifacts/comet/`. Classic-only defaults stay under `classic:`; `comet init` / `comet update` migrate legacy top-level fields.
|
|
212
|
-
|
|
213
|
-
Cloud Knowledge and self-hosted PR providers remain advanced settings; see [Native configuration](https://docs.comet.rpamis.com/en/native/configuration) and [Classic configuration](https://docs.comet.rpamis.com/en/classic/configuration). Native v4 no longer persists the legacy `snapshot` budgets in user configuration.
|
|
214
|
-
|
|
215
|
-
</details>
|
|
216
|
-
|
|
217
|
-
## Support for OpenClaw and Hermes, and other AI platforms
|
|
218
|
-
|
|
219
|
-
For platforms that use the generic `skills` CLI directly, you can install the Comet skill package with:
|
|
220
|
-
|
|
221
|
-
```bash
|
|
222
|
-
npx skills add rpamis/comet
|
|
223
|
-
```
|
|
224
|
-
|
|
225
|
-
## Screenshots
|
|
226
|
-
|
|
227
|
-
### Classic Spec Skill
|
|
228
|
-
|
|
229
|
-
<p align="center">
|
|
230
|
-
<img src="https://github.com/rpamis/comet/blob/master/img/runner.png" alt="runner">
|
|
231
|
-
</p>
|
|
232
|
-
|
|
233
|
-
<p align="center">Auto-install OpenSpec & Superpowers, one-click dev environment setup</p>
|
|
234
|
-
<p align="center">Multi-phase Skill entry, auto-detects current Spec stage, auto-triggers core flow, manual review at key nodes</p>
|
|
235
|
-
|
|
236
|
-
### Integration with LangSmith/LangFuse
|
|
237
|
-
|
|
238
|
-
Comet Eval's automated dual-agent architecture can integrate online with LangSmith/LangFuse environments, making experiments traceable and skills evolvable.
|
|
239
|
-
|
|
240
|
-
<p align="center">
|
|
241
|
-
<img src="https://github.com/rpamis/comet/blob/master/img/langsmith-dataset.png" alt="runner">
|
|
242
|
-
</p>
|
|
243
|
-
<p align="center">Manage your Skill baseline in LangSmith and view detailed performance metrics, latency, and token consumption</p>
|
|
244
|
-
|
|
245
|
-
<p align="center">
|
|
246
|
-
<img src="https://github.com/rpamis/comet/blob/master/img/langsmith-trace.png" alt="runner">
|
|
247
|
-
</p>
|
|
248
|
-
<p align="center">Trace your Claude Code in LangSmith</p>
|
|
249
|
-
|
|
250
|
-
<p align="center">
|
|
251
|
-
<img src="https://github.com/rpamis/comet/blob/master/img/langsmith-baseline-detail.png" alt="runner">
|
|
252
|
-
</p>
|
|
253
|
-
<p align="center">Trace custom Rubric metrics with Pytest in LangSmith</p>
|
|
254
|
-
|
|
255
|
-
## Supported Platforms
|
|
256
|
-
|
|
257
|
-
`comet init` supports 37 AI coding platforms:
|
|
258
|
-
|
|
259
|
-
<details>
|
|
260
|
-
<summary>View full platform list</summary>
|
|
261
|
-
|
|
262
|
-
| Platform | Skills Dir | Platform | Skills Dir |
|
|
263
|
-
| ------------------ | ------------- | ------------- | ------------ |
|
|
264
|
-
| Claude Code | `.claude/` | Cursor | `.cursor/` |
|
|
265
|
-
| Codex | `.codex/` | OpenCode | `.opencode/` |
|
|
266
|
-
| Devin Desktop (formerly Windsurf) | `.devin/` | Cline | `.cline/` |
|
|
267
|
-
| RooCode | `.roo/` | Continue | `.continue/` |
|
|
268
|
-
| GitHub Copilot | `.github/` | Gemini CLI | `.gemini/` |
|
|
269
|
-
| Amazon Q Developer | `.amazonq/` | Qwen Code | `.qwen/` |
|
|
270
|
-
| Kilo Code | `.kilocode/` | Auggie | `.augment/` |
|
|
271
|
-
| Kimi Code | `.kimi-code/` | Kiro | `.kiro/` |
|
|
272
|
-
| Lingma | `.lingma/` | Junie | `.junie/` |
|
|
273
|
-
| CodeBuddy | `.codebuddy/` | WorkBuddy | `.workbuddy/` |
|
|
274
|
-
| Crush | `.crush/` | Factory Droid | `.factory/` |
|
|
275
|
-
| iFlow | `.iflow/` | Pi | `.pi/` |
|
|
276
|
-
| Qoder | `.qoder/` | Antigravity | `.agents/` |
|
|
277
|
-
| Antigravity 2.0 | `.agents/` | Bob Shell | `.bob/` |
|
|
278
|
-
| ForgeCode | `.forge/` | Trae | `.trae/` |
|
|
279
|
-
| Trae CN | `.trae-cn/` | ZCode | `.zcode/` |
|
|
280
|
-
| MimoCode | `.mimocode/` | CoStrict | `.cospec/` |
|
|
281
|
-
| Grok | `.grok/` | | |
|
|
282
|
-
|
|
283
|
-
</details>
|
|
284
|
-
|
|
285
|
-
## Development
|
|
286
|
-
|
|
287
|
-
See [CONTRIBUTING.md](CONTRIBUTING.md) | [中文版](CONTRIBUTING-zh.md) for development setup, commit
|
|
288
|
-
conventions, PR process, branch workflow, and guidance for adding platforms,
|
|
289
|
-
skills, scripts, or changelog entries.
|
|
290
|
-
|
|
291
|
-
See [CHANGELOG.md](CHANGELOG.md) for version history and updates.
|
|
292
|
-
|
|
293
|
-
## Roadmap
|
|
294
|
-
|
|
295
|
-
Track our development progress and upcoming features on the [Comet Roadmap](https://github.com/orgs/rpamis/projects/1).
|
|
296
|
-
|
|
297
|
-
## Star History
|
|
298
|
-
|
|
299
|
-
[](https://www.star-history.com/?repos=rpamis%2Fcomet&type=date&legend=top-left)
|
|
300
|
-
|
|
301
|
-
## Contributors
|
|
302
|
-
|
|
303
|
-
<a href="https://github.com/rpamis/comet/graphs/contributors">
|
|
304
|
-
<img src="https://contrib.rocks/image?repo=rpamis/comet&columns=12&anon=1" />
|
|
305
|
-
</a>
|
|
306
|
-
|
|
307
|
-
## License
|
|
308
|
-
|
|
309
|
-
[MIT](LICENSE)
|
|
310
|
-
|
|
311
|
-
## Community
|
|
312
|
-
|
|
313
|
-
<table align="center">
|
|
314
|
-
<tr>
|
|
315
|
-
<td align="center" width="180">
|
|
316
|
-
<img src="https://github.com/rpamis/comet/blob/master/img/douyin.png" width="120" height="120"><br>
|
|
317
|
-
<b>DouYin (Recommended)</b>
|
|
318
|
-
</td>
|
|
319
|
-
<td align="center" width="180">
|
|
320
|
-
<img src="https://github.com/rpamis/comet/blob/master/img/wechat.png" width="120" height="120"><br>
|
|
321
|
-
<b>WeChat</b>
|
|
322
|
-
</td>
|
|
323
|
-
<td align="center" width="180">
|
|
324
|
-
<img src="https://github.com/rpamis/comet/blob/master/img/qq.jpg" width="120" height="120"><br>
|
|
325
|
-
<b>QQ</b>
|
|
326
|
-
</td>
|
|
327
|
-
</tr>
|
|
328
|
-
</table>
|
|
329
|
-
|
|
330
|
-
## Reference
|
|
331
|
-
|
|
332
|
-
[LINUX DO - 新的理想型社区](https://linux.do/)
|
|
1
|
+
<p align="center">
|
|
2
|
+
<a href="https://github.com/rpamis/comet/blob/master/img/title-log.png">
|
|
3
|
+
<picture>
|
|
4
|
+
<source srcset="https://github.com/rpamis/comet/blob/master/img/title-log.png">
|
|
5
|
+
<img src="https://github.com/rpamis/comet/blob/master/img/title-log.png" alt="Comet logo">
|
|
6
|
+
</picture>
|
|
7
|
+
</a>
|
|
8
|
+
</p>
|
|
9
|
+
|
|
10
|
+
<p align="center">
|
|
11
|
+
<a href="https://github.com/rpamis/comet/actions/workflows/ci.yml"><img alt="CI" src="https://img.shields.io/github/actions/workflow/status/rpamis/comet/ci.yml?branch=master&style=flat-square&label=CI" /></a>
|
|
12
|
+
<a href="https://app.codecov.io/gh/rpamis/comet/tree/master"><img alt="codecov" src="https://img.shields.io/codecov/c/github/rpamis/comet/master?style=flat-square&label=coverage&color=%23E61A7A" /></a>
|
|
13
|
+
<a href="https://deepwiki.com/rpamis/comet"><img alt="DeepWiki" src="https://img.shields.io/badge/DeepWiki-rpamis%2Fcomet-blue?style=flat-square" /></a>
|
|
14
|
+
<a href="https://www.npmjs.com/package/@rpamis/comet"><img alt="npm version" src="https://img.shields.io/npm/v/@rpamis/comet?style=flat-square" /></a>
|
|
15
|
+
<a href="https://www.npmjs.com/package/@rpamis/comet"><img alt="npm total download count" src="https://img.shields.io/npm/dt/@rpamis/comet?style=flat-square&label=Downloads" /></a>
|
|
16
|
+
<a href="https://www.npmjs.com/package/@rpamis/comet"><img alt="npm monthly download count" src="https://img.shields.io/npm/dm/@rpamis/comet?style=flat-square&label=Downloads/mo" /></a>
|
|
17
|
+
<a href="https://docs.comet.rpamis.com/"><img alt="Comet Docs" src="https://img.shields.io/badge/Docs-docs.comet.rpamis.com-FFD700?style=flat-square" /></a>
|
|
18
|
+
<a href="./LICENSE"><img alt="License: MIT" src="https://img.shields.io/badge/License-MIT-blue.svg?style=flat-square" /></a>
|
|
19
|
+
<a href="https://atomgit.com/rpamis/comet"><img alt="AtomGitStars" src="https://atomgit.com/rpamis/comet/star/badge.svg" /></a>
|
|
20
|
+
</p>
|
|
21
|
+
|
|
22
|
+
<p align="center">
|
|
23
|
+
<a href="https://trendshift.io/repositories/38989?utm_source=repository-badge&utm_medium=badge&utm_campaign=badge-repository-38989" target="_blank" rel="noopener noreferrer"><img src="https://trendshift.io/api/badge/repositories/38989" alt="rpamis%2Fcomet | Trendshift" width="250" height="55"/></a>
|
|
24
|
+
</p>
|
|
25
|
+
|
|
26
|
+
## What is Comet ?
|
|
27
|
+
|
|
28
|
+
```
|
|
29
|
+
██████╗ ██████╗ ███╗ ███╗███████╗████████╗
|
|
30
|
+
██╔════╝██╔═══██╗████╗ ████║██╔════╝╚══██╔══╝
|
|
31
|
+
██║ ██║ ██║██╔████╔██║█████╗ ██║
|
|
32
|
+
██║ ██║ ██║██║╚██╔╝██║██╔══╝ ██║
|
|
33
|
+
╚██████╗╚██████╔╝██║ ╚═╝ ██║███████╗ ██║
|
|
34
|
+
╚═════╝ ╚═════╝ ╚═╝ ╚═╝╚══════╝ ╚═╝
|
|
35
|
+
```
|
|
36
|
+
|
|
37
|
+
> 中文版:[README-zh.md](README-zh.md)
|
|
38
|
+
> [Bilibili video](https://www.bilibili.com/video/BV1y4Gi6CEo1/?spm_id_from=333.1387.homepage.video_card.click&vd_source=d22726fe6b108647dbebf1c5d8817377)
|
|
39
|
+
> [DouYin](https://www.douyin.com/search/comet?aid=cd8fcc82-498b-4d59-8860-617deb719412&modal_id=7646429015808936293&type=general)
|
|
40
|
+
|
|
41
|
+
**Comet is a resumable long-running task workflow and Skill platform for coding.**
|
|
42
|
+
|
|
43
|
+
It provides two independent requirements workflows: Native for strong models, powered only by Comet's own runtime, and Classic, which preserves the full OpenSpec + Superpowers phase-governance model. Comet also covers Skill creation, evaluation, and release.
|
|
44
|
+
|
|
45
|
+
It allows you to use a toolchain to handle everything from requirements to archiving, combine any skill to make it like Comet, evolving your skills based on scientific **Rubric**, **Pass@k**, and **Pass^k** scoring.
|
|
46
|
+
|
|
47
|
+
> [!IMPORTANT]
|
|
48
|
+
> **Comet 0.4.0 stable release** — Building on 0.3.9, this release adds Native workflows, multi-agent collaboration, memory and knowledge management, and a complete toolchain for creating, distributing, and evaluating Skills.
|
|
49
|
+
>
|
|
50
|
+
> - **Native workflows for strong models**: After requirements are confirmed, the Agent chooses how to plan, implement, test, and review. Comet handles state checks, acceptance, and resumable archive. Native runs independently of Classic, which retains the OpenSpec + Superpowers five-phase methodology; both share configuration, status, Dashboard, and Eval entry points.
|
|
51
|
+
> - **Parallel delivery for complex requirements**: Supervisor Changes split a goal into dependency-aware child changes. Independent Codex sessions or Claude Code Agent Teams implement and verify them in isolated worktrees, then integrate them in dependency order before the parent change's final acceptance.
|
|
52
|
+
> - **Manageable Personal Memory and Project Knowledge**: Retain collaboration preferences and reusable experience across tasks, and progressively supply context relevant to the current task. You can inspect, correct, forget, or pause it; new lessons start in trial and gain supporting evidence through actual adoption and verification.
|
|
53
|
+
> - **Skill creation, distribution, and evaluation**: Compose any Skills with `/comet-any` and package them for distribution. Use `comet eval` with Rubric, Pass@k, Pass^k, and LangSmith to compare results and guide Skill improvements.
|
|
54
|
+
> - **A unified three-pane Dashboard**: Inspect Native and Classic progress, Git worktrees, acceptance results, and archives in your browser, and manage Personal Memory, Project Knowledge, and plugin settings.
|
|
55
|
+
> - **Cross-platform execution and recovery**: A pure Node.js Runtime supports Windows, macOS, and Linux without Bash or WSL. Task state stays in the project so work can resume after interruptions or session changes; CLI output identifies the next step and decisions that need your input.
|
|
56
|
+
>
|
|
57
|
+
> In the existing aligned Native vs. 0.4.0 Classic experiment (16 tasks, 48 runs per treatment), the 41 paired samples where both passed showed **76.8% fewer total tokens**, **57.4% fewer Agent rounds**, and **47.4% less time** for Native. Across the full sample, Native achieved **87.5% pass^3 (+12.5 percentage points)**, while both treatments reached **100% pass@3**. See the [evaluation report](https://docs.comet.rpamis.com/en/eval/comet-native-vs-040-experiment) for conditions and limitations, and the [Changelog](https://docs.comet.rpamis.com/en/changelog) for all changes.
|
|
58
|
+
|
|
59
|
+
> Native and Classic are not lightweight and heavyweight tiers, and neither upgrades into the other. Native is for strong models that can plan and verify autonomously; Classic is for scenarios that benefit from a complete phased methodology and stronger constraints.
|
|
60
|
+
|
|
61
|
+
## Why Comet
|
|
62
|
+
|
|
63
|
+
- **Native workflow for strong models** — `/comet-native` uses a detailed brief, complete target specifications, phase checks, and recoverable archive to constrain outcomes while leaving planning, implementation, testing, and review methods to the model. User-readable artifacts live under `docs/comet/` by default, fully separate from Classic. See the [Native workflow guide](https://docs.comet.rpamis.com/en/native/quickstart).
|
|
64
|
+
- **One-way, resumable Native archive** — Archive first returns a single dry-run continuation command, with explicit isolated-workspace finish choices and blocker paths; continuing the workflow lets Runtime own the archive commit without repeated status queries or manual runtime-file commits.
|
|
65
|
+
- **Supervisor Changes for complex requirements** — Native can split work along real delivery boundaries, manage dependencies and readiness as a DAG, let multiple agents implement and verify in Runtime-created worktrees, and then integrate the results before the parent change's final acceptance.
|
|
66
|
+
- **The stable core for long-running tasks** — Comet's Classic Spec mode combines OpenSpec and Superpowers into a five-phase flow with a state machine, phase checks, and scripts. It suits work that needs an explicit method and strong constraints; its permanent entry point is `/comet-classic`.
|
|
67
|
+
- **A configuration-driven shared entry point** — `/comet` reads only the project's `.comet/config.yaml` and deterministically forwards to `/comet-native` or `/comet-classic`. It does not guess from task size or mix changes, state, or directories across workflows. `comet resume-probe` uses the same configuration to resume through the correct permanent entry point.
|
|
68
|
+
- **Skill platform** — Comet can author reusable Skill packages and use `/comet-any` to organize them into distributable
|
|
69
|
+
Bundles, so Skills you create can be distributed to coding platforms with one command, much like `comet init`.
|
|
70
|
+
- **Eval platform** — Comet assesses your skills using scientific Rubric, Pass@k, and Pass^k scoring, ensuring skill evolution is based on scientific evidence rather than intuition. It supports integration with LangSmith assessments, bringing evaluation to real-world enterprise production environments. Its dual-agent architecture automates the assessment process in your production environment.
|
|
71
|
+
|
|
72
|
+
## Supervisor Change: coordinated delivery across multiple agents
|
|
73
|
+
|
|
74
|
+
When a requirement contains multiple deliverables that can be implemented and verified independently, a Supervisor Change confirms the child changes and their dependencies before coordinating independent Codex sessions or Claude Code Agent Teams. The Runtime remains responsible for worktrees, task identity, verification, ordered integration, and the parent change's final Verify.
|
|
75
|
+
|
|
76
|
+
`Complex goal → child-change DAG → isolated worktrees → independent implementation and verification → ordered integration → final parent Verify`
|
|
77
|
+
|
|
78
|
+
**Codex multi-session execution**
|
|
79
|
+
<a href="https://github.com/rpamis/comet/blob/master/img/supervisor-codex.mp4">
|
|
80
|
+
<img src="https://github.com/rpamis/comet/blob/master/img/supervisor-codex-preview.png" alt="Comet Supervisor coordinating independent Codex sessions" width="100%">
|
|
81
|
+
</a><br>
|
|
82
|
+
<a href="https://github.com/rpamis/comet/blob/master/img/supervisor-codex.mp4">▶ Play the full demo</a>
|
|
83
|
+
**Claude Code Agent Teams execution**
|
|
84
|
+
<a href="https://github.com/rpamis/comet/blob/master/img/supervisor-claude-code.mp4">
|
|
85
|
+
<img src="https://github.com/rpamis/comet/blob/master/img/supervisor-claude-code-preview.png" alt="Comet Supervisor coordinating a Claude Code Agent Team" width="100%">
|
|
86
|
+
</a><br>
|
|
87
|
+
<a href="https://github.com/rpamis/comet/blob/master/img/supervisor-claude-code.mp4">▶ Play the full demo</a>
|
|
88
|
+
## Extremely low memory threshold
|
|
89
|
+
|
|
90
|
+
With Comet, you only need to remember two skills and one command, covering coding, creation, and evaluation with an extremely low barrier to entry:
|
|
91
|
+
|
|
92
|
+
- Use `/comet` to enter the project's configured Native or Classic workflow
|
|
93
|
+
- Use `/comet-any` to compose any Skills
|
|
94
|
+
- Use `comet eval` to evaluate any Skill
|
|
95
|
+
|
|
96
|
+
## Comet 0.4.0 Baseline Comparison
|
|
97
|
+
|
|
98
|
+
The following charts are from 16 Comet workflow tasks, with 5 samples per treatment, comparing no Comet, Comet 0.3.9, and Comet 0.4.0.
|
|
99
|
+
|
|
100
|
+
The core observations were the differences in Pass@5, Pass^5, and Rubric scores. The baseline without Comet Skills only validated business behavior.
|
|
101
|
+
|
|
102
|
+
<p align="center">
|
|
103
|
+
<img src="https://github.com/rpamis/comet/blob/master/img/comet-eval-pass5.png" alt="Comet pass@5 and pass^5 baseline comparison" width="920">
|
|
104
|
+
</p>
|
|
105
|
+
|
|
106
|
+
<p align="center">
|
|
107
|
+
<img src="https://github.com/rpamis/comet/blob/master/img/comet-eval-rubric-core.png" alt="Comet core rubric and LLM-as-judge baseline comparison" width="920">
|
|
108
|
+
</p>
|
|
109
|
+
|
|
110
|
+
## From Industry-Frontier Practice
|
|
111
|
+
|
|
112
|
+
Many Comet capabilities have parallels in current industry practice.
|
|
113
|
+
|
|
114
|
+
> To compare Comet with those patterns, see [Comet Docs](https://docs.comet.rpamis.com/zh/tech-blog/comet-vs-industry).
|
|
115
|
+
|
|
116
|
+
## What You Can Learn
|
|
117
|
+
|
|
118
|
+
- **How to reliably trigger nested Skills** — not by making an agent perform something that merely looks like a Skill
|
|
119
|
+
trigger, such as writing files based on a Skill description, but by actually triggering the Skill. Comet invokes many
|
|
120
|
+
OpenSpec and Superpowers capabilities, with trigger prompts refined through broad real-world practice.
|
|
121
|
+
- **How to make composed Skills advance through multiple phases automatically** — not through manual intervention. Aside
|
|
122
|
+
from necessary user choices, Comet's five-phase flow can trigger core Skills automatically while the state machine keeps
|
|
123
|
+
transitions reliable.
|
|
124
|
+
- **How to make a Spec lifecycle resumable** — Comet links OpenSpec change/spec artifacts with Superpowers design and
|
|
125
|
+
plan documents, then records phase, execution mode, verification result, and archive status in each change's
|
|
126
|
+
`.comet.yaml`, so an agent can continue after interruption instead of rereading documents and guessing progress.
|
|
127
|
+
- **How to turn doc synchronization from reminders into automation** — Comet scripts handoff, state updates, validation,
|
|
128
|
+
and archive sync, reducing repeated prompts such as "remember to update the design doc" or "remember to archive the
|
|
129
|
+
change."
|
|
130
|
+
- **How to design guard conditions that agents can execute** — phase exits do not rely on an agent saying "done." Scripts
|
|
131
|
+
such as `comet-guard.mjs`, `comet-yaml-validate.mjs`, and `comet-state.mjs` check tasks, state fields, verification
|
|
132
|
+
evidence, and archive conditions before the workflow advances.
|
|
133
|
+
- **How to distribute and install Skills across platforms** — Comet supports many AI coding platforms, project/global
|
|
134
|
+
install scopes, Chinese/English Skill variants, and platform-specific directories such as Antigravity's different
|
|
135
|
+
project/global paths.
|
|
136
|
+
- **How to turn scripts into agent workflow infrastructure** — Comet scripts handle hashes, YAML fields, state machines,
|
|
137
|
+
and archive flow, showing how workflow control that is easy to scatter across prompts can become testable, reusable
|
|
138
|
+
tooling.
|
|
139
|
+
- **How to evolve Skills through scientific evaluation** — Comet Eval supports structured rubric scoring plus Pass@k and
|
|
140
|
+
Pass^k metrics, with both local and LangSmith evaluation paths for production use.
|
|
141
|
+
- **How to create Comet-like Skills intelligently** — `/comet-any` composes arbitrary Skills. You describe your Skill
|
|
142
|
+
preferences, and the agent handles stability-related hooks, rules, scripts, and referenced Skill files for you.
|
|
143
|
+
|
|
144
|
+
## Install
|
|
145
|
+
|
|
146
|
+
Requirements:
|
|
147
|
+
|
|
148
|
+
- Node.js 22.16+ (22.x), or 24+
|
|
149
|
+
- npm/npx
|
|
150
|
+
- Git
|
|
151
|
+
|
|
152
|
+
```bash
|
|
153
|
+
npm install -g @rpamis/comet
|
|
154
|
+
```
|
|
155
|
+
|
|
156
|
+
## Quick Start
|
|
157
|
+
|
|
158
|
+
Initialize Comet in the project where you want to use it:
|
|
159
|
+
|
|
160
|
+
```bash
|
|
161
|
+
cd your-project
|
|
162
|
+
comet init
|
|
163
|
+
# Invoke /comet in the host
|
|
164
|
+
```
|
|
165
|
+
|
|
166
|
+
Interactive setup explains and offers Native, Classic, or both. Native is for strong models that can implement and verify autonomously; Classic is for tasks that need full Spec/TDD phase constraints; Both installs two independent entries while keeping `/comet` on Native by default. Non-interactive new projects default to Native, and project configuration is unified at `.comet/config.yaml`:
|
|
167
|
+
|
|
168
|
+
```bash
|
|
169
|
+
comet init --workflow classic
|
|
170
|
+
comet init --workflow both
|
|
171
|
+
```
|
|
172
|
+
|
|
173
|
+
### Project configuration
|
|
174
|
+
|
|
175
|
+
`comet init` generates `.comet/config.yaml` with field-level comments in the selected language. `comet update` fills new managed defaults while preserving user values and unknown extensions.
|
|
176
|
+
|
|
177
|
+
<details>
|
|
178
|
+
<summary>View the compact config shape when Native and Classic are both enabled</summary>
|
|
179
|
+
|
|
180
|
+
```yaml
|
|
181
|
+
schema: comet.project.v1
|
|
182
|
+
default_workflow: native
|
|
183
|
+
workflows: [native, classic]
|
|
184
|
+
ambient_resume: true
|
|
185
|
+
|
|
186
|
+
memory:
|
|
187
|
+
learning: true
|
|
188
|
+
retrieval: true
|
|
189
|
+
knowledge:
|
|
190
|
+
provider: local
|
|
191
|
+
hook:
|
|
192
|
+
allow_paths: []
|
|
193
|
+
|
|
194
|
+
native:
|
|
195
|
+
artifact_root: docs
|
|
196
|
+
language: en
|
|
197
|
+
clarification_mode: batch
|
|
198
|
+
archive_confirmation: automatic
|
|
199
|
+
max_verify_failures: 5
|
|
200
|
+
|
|
201
|
+
classic:
|
|
202
|
+
artifact_layout: docs
|
|
203
|
+
language: en
|
|
204
|
+
context_compression: off
|
|
205
|
+
review_mode: standard
|
|
206
|
+
auto_transition: true
|
|
207
|
+
```
|
|
208
|
+
|
|
209
|
+
- `default_workflow` selects the default `/comet` entry and must be present in `workflows`. `ambient_resume`, `memory`, `knowledge`, and `hook` are shared by both workflows.
|
|
210
|
+
- `memory.learning` / `retrieval` control personal-memory learning and injection. `knowledge.local.include` can append project-relative Markdown globs. `hook.allow_paths` is empty by default; add project-relative directories only when guarded phases must write shared files. It cannot bypass protection for `.comet` or workflow artifacts.
|
|
211
|
+
- Native stores user-readable artifacts under `docs/comet/` and machine Runtime under `.comet/runtime/native/`. Use `comet init --workflow native --root artifacts` for `artifacts/comet/`. Classic-only defaults stay under `classic:`; `comet init` / `comet update` migrate legacy top-level fields.
|
|
212
|
+
|
|
213
|
+
Cloud Knowledge and self-hosted PR providers remain advanced settings; see [Native configuration](https://docs.comet.rpamis.com/en/native/configuration) and [Classic configuration](https://docs.comet.rpamis.com/en/classic/configuration). Native v4 no longer persists the legacy `snapshot` budgets in user configuration.
|
|
214
|
+
|
|
215
|
+
</details>
|
|
216
|
+
|
|
217
|
+
## Support for OpenClaw and Hermes, and other AI platforms
|
|
218
|
+
|
|
219
|
+
For platforms that use the generic `skills` CLI directly, you can install the Comet skill package with:
|
|
220
|
+
|
|
221
|
+
```bash
|
|
222
|
+
npx skills add rpamis/comet
|
|
223
|
+
```
|
|
224
|
+
|
|
225
|
+
## Screenshots
|
|
226
|
+
|
|
227
|
+
### Classic Spec Skill
|
|
228
|
+
|
|
229
|
+
<p align="center">
|
|
230
|
+
<img src="https://github.com/rpamis/comet/blob/master/img/runner.png" alt="runner">
|
|
231
|
+
</p>
|
|
232
|
+
|
|
233
|
+
<p align="center">Auto-install OpenSpec & Superpowers, one-click dev environment setup</p>
|
|
234
|
+
<p align="center">Multi-phase Skill entry, auto-detects current Spec stage, auto-triggers core flow, manual review at key nodes</p>
|
|
235
|
+
|
|
236
|
+
### Integration with LangSmith/LangFuse
|
|
237
|
+
|
|
238
|
+
Comet Eval's automated dual-agent architecture can integrate online with LangSmith/LangFuse environments, making experiments traceable and skills evolvable.
|
|
239
|
+
|
|
240
|
+
<p align="center">
|
|
241
|
+
<img src="https://github.com/rpamis/comet/blob/master/img/langsmith-dataset.png" alt="runner">
|
|
242
|
+
</p>
|
|
243
|
+
<p align="center">Manage your Skill baseline in LangSmith and view detailed performance metrics, latency, and token consumption</p>
|
|
244
|
+
|
|
245
|
+
<p align="center">
|
|
246
|
+
<img src="https://github.com/rpamis/comet/blob/master/img/langsmith-trace.png" alt="runner">
|
|
247
|
+
</p>
|
|
248
|
+
<p align="center">Trace your Claude Code in LangSmith</p>
|
|
249
|
+
|
|
250
|
+
<p align="center">
|
|
251
|
+
<img src="https://github.com/rpamis/comet/blob/master/img/langsmith-baseline-detail.png" alt="runner">
|
|
252
|
+
</p>
|
|
253
|
+
<p align="center">Trace custom Rubric metrics with Pytest in LangSmith</p>
|
|
254
|
+
|
|
255
|
+
## Supported Platforms
|
|
256
|
+
|
|
257
|
+
`comet init` supports 37 AI coding platforms:
|
|
258
|
+
|
|
259
|
+
<details>
|
|
260
|
+
<summary>View full platform list</summary>
|
|
261
|
+
|
|
262
|
+
| Platform | Skills Dir | Platform | Skills Dir |
|
|
263
|
+
| ------------------ | ------------- | ------------- | ------------ |
|
|
264
|
+
| Claude Code | `.claude/` | Cursor | `.cursor/` |
|
|
265
|
+
| Codex | `.codex/` | OpenCode | `.opencode/` |
|
|
266
|
+
| Devin Desktop (formerly Windsurf) | `.devin/` | Cline | `.cline/` |
|
|
267
|
+
| RooCode | `.roo/` | Continue | `.continue/` |
|
|
268
|
+
| GitHub Copilot | `.github/` | Gemini CLI | `.gemini/` |
|
|
269
|
+
| Amazon Q Developer | `.amazonq/` | Qwen Code | `.qwen/` |
|
|
270
|
+
| Kilo Code | `.kilocode/` | Auggie | `.augment/` |
|
|
271
|
+
| Kimi Code | `.kimi-code/` | Kiro | `.kiro/` |
|
|
272
|
+
| Lingma | `.lingma/` | Junie | `.junie/` |
|
|
273
|
+
| CodeBuddy | `.codebuddy/` | WorkBuddy | `.workbuddy/` |
|
|
274
|
+
| Crush | `.crush/` | Factory Droid | `.factory/` |
|
|
275
|
+
| iFlow | `.iflow/` | Pi | `.pi/` |
|
|
276
|
+
| Qoder | `.qoder/` | Antigravity | `.agents/` |
|
|
277
|
+
| Antigravity 2.0 | `.agents/` | Bob Shell | `.bob/` |
|
|
278
|
+
| ForgeCode | `.forge/` | Trae | `.trae/` |
|
|
279
|
+
| Trae CN | `.trae-cn/` | ZCode | `.zcode/` |
|
|
280
|
+
| MimoCode | `.mimocode/` | CoStrict | `.cospec/` |
|
|
281
|
+
| Grok | `.grok/` | | |
|
|
282
|
+
|
|
283
|
+
</details>
|
|
284
|
+
|
|
285
|
+
## Development
|
|
286
|
+
|
|
287
|
+
See [CONTRIBUTING.md](CONTRIBUTING.md) | [中文版](CONTRIBUTING-zh.md) for development setup, commit
|
|
288
|
+
conventions, PR process, branch workflow, and guidance for adding platforms,
|
|
289
|
+
skills, scripts, or changelog entries.
|
|
290
|
+
|
|
291
|
+
See [CHANGELOG.md](CHANGELOG.md) for version history and updates.
|
|
292
|
+
|
|
293
|
+
## Roadmap
|
|
294
|
+
|
|
295
|
+
Track our development progress and upcoming features on the [Comet Roadmap](https://github.com/orgs/rpamis/projects/1).
|
|
296
|
+
|
|
297
|
+
## Star History
|
|
298
|
+
|
|
299
|
+
[](https://www.star-history.com/?repos=rpamis%2Fcomet&type=date&legend=top-left)
|
|
300
|
+
|
|
301
|
+
## Contributors
|
|
302
|
+
|
|
303
|
+
<a href="https://github.com/rpamis/comet/graphs/contributors">
|
|
304
|
+
<img src="https://contrib.rocks/image?repo=rpamis/comet&columns=12&anon=1" />
|
|
305
|
+
</a>
|
|
306
|
+
|
|
307
|
+
## License
|
|
308
|
+
|
|
309
|
+
[MIT](LICENSE)
|
|
310
|
+
|
|
311
|
+
## Community
|
|
312
|
+
|
|
313
|
+
<table align="center">
|
|
314
|
+
<tr>
|
|
315
|
+
<td align="center" width="180">
|
|
316
|
+
<img src="https://github.com/rpamis/comet/blob/master/img/douyin.png" width="120" height="120"><br>
|
|
317
|
+
<b>DouYin (Recommended)</b>
|
|
318
|
+
</td>
|
|
319
|
+
<td align="center" width="180">
|
|
320
|
+
<img src="https://github.com/rpamis/comet/blob/master/img/wechat.png" width="120" height="120"><br>
|
|
321
|
+
<b>WeChat</b>
|
|
322
|
+
</td>
|
|
323
|
+
<td align="center" width="180">
|
|
324
|
+
<img src="https://github.com/rpamis/comet/blob/master/img/qq.jpg" width="120" height="120"><br>
|
|
325
|
+
<b>QQ</b>
|
|
326
|
+
</td>
|
|
327
|
+
</tr>
|
|
328
|
+
</table>
|
|
329
|
+
|
|
330
|
+
## Reference
|
|
331
|
+
|
|
332
|
+
[LINUX DO - 新的理想型社区](https://linux.do/)
|