> ## Documentation Index > Fetch the complete documentation index at: https://docs.comet.rpamis.com/llms.txt > Use this file to discover all available pages before exploring further. # Comet > Comet: Agent Skill Harness for Turning Ideas into Evaluated Workflows. export const SetupDemoController = () => { useEffect(() => { const demos = Array.from(document.querySelectorAll("[data-setup-demo]")); const reducedMotion = window.matchMedia("(prefers-reduced-motion: reduce)"); const versionTargets = Array.from(document.querySelectorAll("[data-docs-version]")); const versionPattern = /^v?\d+\.\d+\.\d+(?:-[0-9A-Za-z.-]+)?$/; let versionObserver = null; const syncDocsVersion = () => { const version = Array.from(document.querySelectorAll('button[aria-haspopup="menu"] > span')).map(element => element.textContent?.trim() || "").find(value => versionPattern.test(value)); if (version == null) return false; const displayVersion = version.startsWith("v") ? version : `v${version}`; versionTargets.forEach(target => { target.textContent = displayVersion; }); return true; }; if (versionTargets.length > 0 && syncDocsVersion() === false && window.MutationObserver != null) { versionObserver = new MutationObserver(() => { if (syncDocsVersion()) versionObserver?.disconnect(); }); versionObserver.observe(document.body, { childList: true, subtree: true }); } const cleanups = demos.map(demo => { const viewport = demo.querySelector("[data-setup-viewport]"); const status = demo.querySelector("[data-setup-status]"); const lines = Array.from(demo.querySelectorAll("[data-setup-line]")); const stages = Array.from(demo.querySelectorAll("[data-setup-stage-card]")); const timers = new Set(); let observer = null; const clearTimers = () => { timers.forEach(timer => window.clearTimeout(timer)); timers.clear(); }; const setStage = stageName => { if (status != null) { status.textContent = stageName === "ready" ? "/comet ready" : stageName === "init" ? "comet init" : "npm install"; } stages.forEach(stage => { const isActive = stage.getAttribute("data-setup-stage-card") === stageName; stage.classList.toggle("is-active", isActive); stage.setAttribute("aria-current", isActive ? "step" : "false"); }); }; const scrollToLatest = () => { if (viewport == null) return; window.requestAnimationFrame(() => { viewport.scrollTop = viewport.scrollHeight; }); }; const showAll = () => { lines.forEach(line => line.classList.add("is-visible")); setStage("ready"); scrollToLatest(); }; const reset = () => { clearTimers(); lines.forEach(line => line.classList.remove("is-visible")); if (viewport != null) viewport.scrollTop = 0; setStage("install"); }; const run = () => { reset(); let elapsed = 280; lines.forEach(line => { const pause = Number(line.getAttribute("data-setup-pause") || "520"); elapsed += pause; const timer = window.setTimeout(() => { const stageName = line.getAttribute("data-setup-stage"); line.classList.add("is-visible"); if (stageName != null) setStage(stageName); scrollToLatest(); timers.delete(timer); }, elapsed); timers.add(timer); }); }; demo.setAttribute("data-setup-enhanced", "true"); if (reducedMotion.matches || window.IntersectionObserver == null || lines.length === 0) { showAll(); return () => clearTimers(); } observer = new IntersectionObserver(([entry]) => { if (entry.isIntersecting === false) return; run(); observer.disconnect(); }, { threshold: 0.2, rootMargin: "0px 0px -8% 0px" }); observer.observe(demo); return () => { clearTimers(); if (observer != null) observer.disconnect(); }; }); return () => { versionObserver?.disconnect(); cleanups.forEach(cleanup => cleanup()); }; }, []); return null; }; export const RevealController = () => { useEffect(() => { const root = document.querySelector(".comet-home"); if (root == null) return; const elements = Array.from(root.querySelectorAll('[data-reveal="true"]')); const reducedMotion = window.matchMedia("(prefers-reduced-motion: reduce)"); if (reducedMotion.matches || window.IntersectionObserver == null) { elements.forEach(element => { element.classList.add("is-visible"); element.setAttribute("data-reveal-state", "visible"); }); return; } const observers = elements.map(element => { const delay = element.getAttribute("data-reveal-delay") || "0"; const distance = element.getAttribute("data-reveal-distance") || "36"; const threshold = Number(element.getAttribute("data-reveal-threshold") || "0.14"); const rootMargin = element.getAttribute("data-reveal-root-margin") || "0px 0px -10% 0px"; element.style.setProperty("--comet-reveal-delay", `${delay}ms`); element.style.setProperty("--comet-reveal-distance", `${distance}px`); element.setAttribute("data-reveal-state", "hidden"); const observer = new IntersectionObserver(([entry]) => { if (entry.isIntersecting === false) return; element.classList.add("is-visible"); element.setAttribute("data-reveal-state", "visible"); observer.disconnect(); }, { threshold, rootMargin }); observer.observe(element); return observer; }); return () => observers.forEach(observer => observer.disconnect()); }, []); return null; }; export const HeroEntranceController = () => { useEffect(() => { const element = document.querySelector(".comet-home__hero-entrance"); if (element == null) return; const showImmediately = () => { element.classList.add("is-hero-visible"); element.style.opacity = "1"; element.style.transform = "none"; }; const reducedMotion = window.matchMedia("(prefers-reduced-motion: reduce)"); if (reducedMotion.matches) { showImmediately(); return; } if (element.getAttribute("data-hero-entrance-started") === "true") return; element.setAttribute("data-hero-entrance-started", "true"); element.style.removeProperty("opacity"); element.style.removeProperty("transform"); window.requestAnimationFrame(() => { window.requestAnimationFrame(() => { element.classList.add("is-hero-visible"); }); }); }, []); return null; }; export const CapabilityDitherController = () => { useEffect(() => { const ditherMatrix = [0, 48, 12, 60, 3, 51, 15, 63, 32, 16, 44, 28, 35, 19, 47, 31, 8, 56, 4, 52, 11, 59, 7, 55, 40, 24, 36, 20, 43, 27, 39, 23, 2, 50, 14, 62, 1, 49, 13, 61, 34, 18, 46, 30, 33, 17, 45, 29, 10, 58, 6, 54, 9, 57, 5, 53, 42, 26, 38, 22, 41, 25, 37, 21]; const parseHexColor = value => { const normalized = value.replace("#", ""); return [Number.parseInt(normalized.slice(0, 2), 16), Number.parseInt(normalized.slice(2, 4), 16), Number.parseInt(normalized.slice(4, 6), 16)]; }; const shadeChannel = (channel, amount) => { if (amount < 0) return Math.round(channel * (1 + amount)); return Math.round(channel + (255 - channel) * amount); }; const root = document.querySelector(".comet-home"); if (root == null) return; const definitions = [[".comet-home__capability-visual--skill", "#dd7959"], [".comet-home__capability-visual--eval", "#e9e1d4"], [".comet-home__capability-visual--any", "#70a0cf"]]; const createdCanvases = []; const canvases = definitions.map(([selector, color]) => { const container = root.querySelector(selector); if (container == null) return null; const existing = container.querySelector(".comet-home__capability-dither"); if (existing != null) return existing; const canvas = document.createElement("canvas"); canvas.className = "comet-home__capability-dither"; canvas.dataset.ditherColor = color; canvas.setAttribute("aria-hidden", "true"); container.prepend(canvas); createdCanvases.push(canvas); return canvas; }).filter(Boolean); if (canvases.length === 0) return; const reducedMotion = window.matchMedia("(prefers-reduced-motion: reduce)"); const shadeLevels = [-0.1, -0.025, 0.045, 0.13]; const surfaces = canvases.map((canvas, index) => { const context = canvas.getContext("2d", { alpha: false }); const baseColor = parseHexColor(canvas.dataset.ditherColor || "#808080"); let width = 0; let height = 0; let image = null; const resize = () => { const bounds = canvas.getBoundingClientRect(); const nextWidth = Math.max(48, Math.ceil(bounds.width / 3)); const nextHeight = Math.max(48, Math.ceil(bounds.height / 3)); if (nextWidth === width && nextHeight === height) return; width = nextWidth; height = nextHeight; canvas.width = width; canvas.height = height; image = context.createImageData(width, height); }; const draw = time => { resize(); if (image == null) return; const pixels = image.data; const phase = index * 1.75; const elapsed = time * 0.00016; const aspect = width / height; for (let y = 0; y < height; y += 1) { for (let x = 0; x < width; x += 1) { const normalizedX = (x / width - 0.5) * aspect; const normalizedY = y / height - 0.5; const primary = Math.sin(normalizedX * 5.2 + normalizedY * 2.1 + elapsed + phase); const secondary = Math.sin(normalizedY * 7.1 - normalizedX * 1.7 - elapsed * 0.72 + phase); const detail = Math.cos((normalizedX + normalizedY) * 9.4 + elapsed * 0.43 - phase); const field = 0.5 + primary * 0.13 + secondary * 0.1 + detail * 0.055; const threshold = (ditherMatrix[y % 8 * 8 + x % 8] - 31.5) / 64; const level = Math.max(0, Math.min(3, Math.floor((field + threshold * 0.32) * 4))); const shade = shadeLevels[level]; const offset = (y * width + x) * 4; pixels[offset] = shadeChannel(baseColor[0], shade); pixels[offset + 1] = shadeChannel(baseColor[1], shade); pixels[offset + 2] = shadeChannel(baseColor[2], shade); pixels[offset + 3] = 255; } } context.putImageData(image, 0, 0); }; return { canvas, draw, resize }; }); let frame = null; let isVisible = true; let lastFrame = 0; const stop = () => { if (frame == null) return; window.cancelAnimationFrame(frame); frame = null; }; const render = time => { frame = null; if (reducedMotion.matches || isVisible === false || document.visibilityState === "hidden") { return; } if (time - lastFrame >= 42) { surfaces.forEach(surface => surface.draw(time)); lastFrame = time; } frame = window.requestAnimationFrame(render); }; const start = () => { if (frame != null || reducedMotion.matches || isVisible === false || document.visibilityState === "hidden") { return; } frame = window.requestAnimationFrame(render); }; const resizeObserver = window.ResizeObserver == null ? null : new ResizeObserver(() => { surfaces.forEach(surface => surface.resize()); surfaces.forEach((surface, index) => surface.draw(reducedMotion.matches ? 0 : performance.now() + index)); }); surfaces.forEach(surface => { surface.resize(); surface.draw(0); resizeObserver?.observe(surface.canvas); }); const section = root.querySelector(".comet-home__capabilities"); const visibilityObserver = section == null || window.IntersectionObserver == null ? null : new IntersectionObserver(([entry]) => { isVisible = entry.isIntersecting; if (isVisible) start(); else stop(); }, { rootMargin: "160px 0px", threshold: 0 }); visibilityObserver?.observe(section); const handleMotionPreference = () => { stop(); surfaces.forEach(surface => surface.draw(0)); start(); }; const handleVisibility = () => { if (document.visibilityState === "hidden") stop(); else start(); }; reducedMotion.addEventListener("change", handleMotionPreference); document.addEventListener("visibilitychange", handleVisibility); start(); return () => { stop(); resizeObserver?.disconnect(); visibilityObserver?.disconnect(); reducedMotion.removeEventListener("change", handleMotionPreference); document.removeEventListener("visibilitychange", handleVisibility); createdCanvases.forEach(canvas => canvas.remove()); }; }, []); return null; }; export const CopyController = () => { useEffect(() => { const buttons = Array.from(document.querySelectorAll("[data-copy-value]")); const timers = new Map(); const copy = async event => { const button = event.currentTarget; const value = button.getAttribute("data-copy-value"); const label = button.getAttribute("data-copy-label") || "复制"; if (value == null || navigator.clipboard == null) return; try { await navigator.clipboard.writeText(value); } catch { return; } const existingTimer = timers.get(button); if (existingTimer != null) window.clearTimeout(existingTimer); button.classList.add("is-copied"); button.setAttribute("aria-label", "已复制"); button.setAttribute("title", "已复制"); const timer = window.setTimeout(() => { button.classList.remove("is-copied"); button.setAttribute("aria-label", label); button.setAttribute("title", label); timers.delete(button); }, 1800); timers.set(button, timer); }; buttons.forEach(button => button.addEventListener("click", copy)); return () => { buttons.forEach(button => button.removeEventListener("click", copy)); timers.forEach(timer => window.clearTimeout(timer)); }; }, []); return null; };
Comet

从想法到稳定交付
只需要 /comet 一个命令

Comet Skill 让 Agent 在长程任务上稳定执行、状态可恢复；Comet Eval 用真实任务科学评估、驱动 Skill 迭代；/comet-any 把任意 Skill 组合成可复用的能力

Get Comet
Comet Dashboard \~/projects/comet
Comet Dashboard：项目概览的活跃变更、Verify 失败与未完成任务指标，以及变更工作区的生命周期阶段和任务进度

Comet Skill

两种模式，一套阶段守卫

在 AI 编码工具里调用 /comet。Comet 按项目配置进入 Native 或 Classic，让一次变更从想法稳定走到归档——即使跨设备0上下文，依然能够在中断之后从原处继续

Native

面向强模型 · 全面自动的Coding

为 Fable 5、GPT 5.6 这类能自主完成复杂代码推理的强模型设计。模型用结构化问题高强度澄清需求、起草目标 Spec，由用户确认；实现交给模型，Comet 在澄清、目标 Spec 与结果验证上把关

Classic

经典Spec 驱动 · 更多的HITL

Open → Design → Build → Verify → Archive 五阶段工作流，连接 OpenSpec 与 Superpowers；用 Design Doc 与显式确认点约束每一步，适合需要严密流程的较大变更及非Fable级模型

两种模式共享同一套阶段守卫：跨阶段写入被拦截，确认点不被跳过，状态可恢复

了解工作流
Comet Skill · /comet \~/projects/your-app
Comet 检测到 2 个处于 design 阶段的活跃 change，列出 add-cli-virtual-pet 与 add-xiaomi-api 并请求选择要继续的变更

Comet Eval

用真实任务，
验证每一个 Skill

Comet Eval 采用双 Agent 自动化评估架构：被测 Agent 运行 Skill，用户模拟 Agent 在决策点自动回复， 并通过 --resume 续接同一会话，让多阶段工作流自动跑完整条链。 把任意本地 Skill 交给 comet eval，它会在隔离环境里运行真实任务， 产出可浏览的结果、多维度评分和失败归因，让 Skill 的演进有据可依

  • LangSmith / Langfuse 集成 — Trace、数据集与评分接入 LangSmith / Langfuse，跨运行可观测、可对比、可回溯
  • 生产级可用 — 隔离环境运行真实任务，Rubric 多维评分 + Pass\@k / Pass^k，失败归因到 Harness / Workflow / Task / Model 层
  • 驱动 Skill 迭代 — 把“感觉能用”变成可度量证据，评估结果决定 Skill 是否发布、如何演进
运行第一次评估
Comet Eval · Test Suite Results comet-skill-eval / pass5
Comet Eval：评估实验、数据集与多维度评分总览

Skill Creator

把工作方法，
沉淀成可复用 Skill

用 /comet-any 创建、组合或整理任意 Skill 先确认方案与 Workflow Contract，再进入评估、发布和分发——把一次性经验变成可复用能力

  • 组合任意 Skill — 把 brainstorming、writing-plans、TDD 等已有 Skill 编排成新流程
  • Workflow Contract — 先约定阶段、确认点与产物，再写实现，方案稳定后才进入构建
  • 评估与发布 — 创建后直接评估、打包、发布，Skill 的每次演进都可追溯
创建一个 Skill
Comet · /comet-any skill: repo-summarizer
{"$"} /comet-any 把 repo-summarizer 沉淀成可复用 Skill
▸ brainstorming · 明确 Skill 的目标、输入与边界
✓ 方案已确认　Workflow Contract 已生成
{"$"} comet eval --skill repo-summarizer --rubric quality,correctness
✓ pass 4 / 5　artifact\_quality 0.88 · 平均 0.84
{"$"} comet publish --skill repo-summarizer
✓ 已发布　v1.0.0 · 可在任意项目复用

Why Comet

让长任务稳定运行的工程脚手架

ReAct 解决单轮推理，Comet 为完整工作流补上状态管理、阶段守卫与结果评估， 让任务从想法稳定推进到归档

  • 01

    阶段守卫

    用阶段边界、确认点与验证要求约束推进，关键步骤不被跳过，越界操作会被拦截

  • 02

    可恢复状态

    将阶段、决策、证据与失败记录写入项目，中断、压缩或跨设备后仍能从原处继续

  • 03

    意图路由

    /comet 读取项目配置、活跃状态与当前意图，进入正确流程并延续已有工作

  • 04

    评估驱动

    用真实任务评分和失败归因，把“感觉能用”变成可度量的演进

  • 05

    上下文压缩

    把目标、决策、状态、证据与下一步结构化落盘，压缩对话后仍保留推进所需上下文

  • 06

    Skill 组合

    把已有 Skill 编排成新流程，沉淀为可评估、可发布的可复用能力

33 platforms

在你已经在用的工具里运行

Comet 支持 33 个 AI 编码平台，初始化向导按平台完成安装与配置

Claude Code Codex Amazon Q Developer Windsurf GitHub Copilot Gemini CLI Qwen Code Qoder Kiro CodeBuddy Code Cursor
OpenCode Cline RooCode Continue Kilo Code Auggie Lingma Trae Trae CN ZCode MimoCode
Kimi Code Junie CoStrict Crush Factory Droid iFlow Pi Antigravity Antigravity 2.0 Bob Shell ForgeCode
查看全部平台

Live setup

从 npm 安装到第一次 /comet

安装 Comet，初始化当前项目，
然后在你已有的 AI 编码工具中调用 /comet 开始工作

Comet · setup npm install
\$ npm install -g @rpamis/comet
✓ changed 212 packages in 14s
  1. 01

    安装 CLI

    通过 npm 全局安装 @rpamis/comet，让 Comet 命令在终端中可用

  2. 02

    初始化项目

    向导写入 Skill、规则与阶段守卫，并按已检测到的平台完成配置

  3. 03

    开始工作

    设置完成后，直接在你已有的 AI 编码工具里调用 /comet

Comet Eval

用双 Agent 自动化架构运行真实任务，产出评分、证据与失败原因

Comet Any

组合或整理已有 Skill，把一次性工作方法沉淀成可评估、可发布的能力

Comet
Copyright © 2026, Comet.
文档 更新日志 技术博客