comet-dsh-plugin 0.0.0-stage → 0.5.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 -0
- package/README.en.md +176 -0
- package/README.md +152 -2
- package/client.js +349 -0
- package/cordis.patch.yml +4 -0
- package/icon.png +0 -0
- package/index.js +183 -0
- package/locale/en.json +7 -0
- package/locale/zh.json +7 -0
- package/package.json +57 -4
- package/rules/comet-workflow-guard.md +63 -0
- package/rules/migration-assets.json +218 -0
- package/server/comet-plugin-setup.mjs +192 -0
- package/skills/comet/SKILL.md +37 -0
- package/skills/comet/agents/openai.yaml +3 -0
- package/skills/comet/reference/change-walkthrough.md +77 -0
- package/skills/comet/reference/edit-review.md +26 -0
- package/skills/comet/reference/host-check.md +11 -0
- package/skills/comet/reference/platform-execution.md +34 -0
- package/skills/comet/reference/task-learning.md +39 -0
- package/skills/comet/runtime/classic/checks.yaml +6 -0
- package/skills/comet/runtime/classic/guardrails.yaml +13 -0
- package/skills/comet/runtime/classic/skill.yaml +122 -0
- package/skills/comet/scripts/comet-archive.mjs +310 -0
- package/skills/comet/scripts/comet-check.mjs +179 -0
- package/skills/comet/scripts/comet-entry-runtime.mjs +151 -0
- package/skills/comet/scripts/comet-env.mjs +15 -0
- package/skills/comet/scripts/comet-guard.mjs +335 -0
- package/skills/comet/scripts/comet-handoff.mjs +289 -0
- package/skills/comet/scripts/comet-hook-guard.mjs +294 -0
- package/skills/comet/scripts/comet-hook-router-guard.mjs +628 -0
- package/skills/comet/scripts/comet-hook-router.mjs +17 -0
- package/skills/comet/scripts/comet-intent.mjs +181 -0
- package/skills/comet/scripts/comet-plugin-hook.mjs +213 -0
- package/skills/comet/scripts/comet-resume-probe.mjs +205 -0
- package/skills/comet/scripts/comet-runtime.mjs +571 -0
- package/skills/comet/scripts/comet-state.mjs +381 -0
- package/skills/comet/scripts/comet-yaml-validate.mjs +182 -0
- package/skills/comet-any/SKILL.md +47 -0
- package/skills/comet-any/agents/openai.yaml +5 -0
- package/skills/comet-any/reference/sdk-creation.md +100 -0
- package/skills/comet-archive/SKILL.md +28 -0
- package/skills/comet-archive/agents/openai.yaml +5 -0
- package/skills/comet-archive/reference/compat.md +188 -0
- package/skills/comet-build/SKILL.md +35 -0
- package/skills/comet-build/agents/openai.yaml +5 -0
- package/skills/comet-build/reference/compat.md +191 -0
- package/skills/comet-classic/SKILL.md +98 -0
- package/skills/comet-classic/agents/openai.yaml +3 -0
- package/skills/comet-classic/reference/auto-transition.md +34 -0
- package/skills/comet-classic/reference/classic-layout.md +36 -0
- package/skills/comet-classic/reference/comet-yaml-fields.md +82 -0
- package/skills/comet-classic/reference/context-recovery.md +128 -0
- package/skills/comet-classic/reference/debug-gate.md +30 -0
- package/skills/comet-classic/reference/decision-point.md +109 -0
- package/skills/comet-classic/reference/dirty-worktree.md +59 -0
- package/skills/comet-classic/reference/file-structure.md +32 -0
- package/skills/comet-classic/reference/intent-frame.md +132 -0
- package/skills/comet-classic/reference/scripts.md +144 -0
- package/skills/comet-classic/reference/sdk-methods.md +136 -0
- package/skills/comet-classic/reference/subagent-dispatch.md +75 -0
- package/skills/comet-classic/reference/workspace.md +23 -0
- package/skills/comet-design/SKILL.md +25 -0
- package/skills/comet-design/agents/openai.yaml +5 -0
- package/skills/comet-design/reference/compat.md +191 -0
- package/skills/comet-hotfix/SKILL.md +46 -0
- package/skills/comet-hotfix/agents/openai.yaml +5 -0
- package/skills/comet-hotfix/reference/compat.md +240 -0
- package/skills/comet-memory/SKILL.md +68 -0
- package/skills/comet-memory/agents/openai.yaml +5 -0
- package/skills/comet-native/SKILL.md +139 -0
- package/skills/comet-native/agents/openai.yaml +3 -0
- package/skills/comet-native/reference/artifacts.md +118 -0
- package/skills/comet-native/reference/clarification.md +120 -0
- package/skills/comet-native/reference/commands.md +321 -0
- package/skills/comet-native/reference/edit-review.md +26 -0
- package/skills/comet-native/reference/recovery.md +64 -0
- package/skills/comet-native/reference/workspace.md +70 -0
- package/skills/comet-native/scripts/comet-native-archive.mjs +475 -0
- package/skills/comet-native/scripts/comet-native-cancel.mjs +461 -0
- package/skills/comet-native/scripts/comet-native-doctor.mjs +475 -0
- package/skills/comet-native/scripts/comet-native-hook-guard.mjs +470 -0
- package/skills/comet-native/scripts/comet-native-init.mjs +465 -0
- package/skills/comet-native/scripts/comet-native-new.mjs +478 -0
- package/skills/comet-native/scripts/comet-native-next.mjs +464 -0
- package/skills/comet-native/scripts/comet-native-root.mjs +472 -0
- package/skills/comet-native/scripts/comet-native-runtime.mjs +525 -0
- package/skills/comet-native/scripts/comet-native-select.mjs +468 -0
- package/skills/comet-native/scripts/comet-native-show.mjs +462 -0
- package/skills/comet-native/scripts/comet-native-spec.mjs +468 -0
- package/skills/comet-native/scripts/comet-native-status.mjs +467 -0
- package/skills/comet-native/scripts/comet-native-transfer.mjs +466 -0
- package/skills/comet-open/SKILL.md +265 -0
- package/skills/comet-open/agents/openai.yaml +5 -0
- package/skills/comet-open/reference/batch-changes.md +51 -0
- package/skills/comet-review/SKILL.md +121 -0
- package/skills/comet-review/agents/openai.yaml +5 -0
- package/skills/comet-tweak/SKILL.md +49 -0
- package/skills/comet-tweak/agents/openai.yaml +5 -0
- package/skills/comet-tweak/reference/compat.md +232 -0
- package/skills/comet-verify/SKILL.md +30 -0
- package/skills/comet-verify/agents/openai.yaml +5 -0
- package/skills/comet-verify/reference/compat.md +202 -0
|
@@ -0,0 +1,37 @@
|
|
|
1
|
+
---
|
|
2
|
+
name: comet
|
|
3
|
+
description: 'Comet 工作流入口。当用户明确调用 /comet,或明确要求使用 Comet 但未指定 Native/Classic 时使用;按项目配置加载 Native 或 Classic。'
|
|
4
|
+
---
|
|
5
|
+
|
|
6
|
+
# Comet 入口
|
|
7
|
+
|
|
8
|
+
`/comet` 按项目配置选择 Native 或 Classic,再将用户请求交给相应的工作流 Skill 执行。
|
|
9
|
+
|
|
10
|
+
加载本 Skill 后,立即执行下方步骤。此时用户已选择使用 Comet,应继续处理请求,不再判断是否需要使用 Comet,也不能只给出不执行的理由。
|
|
11
|
+
|
|
12
|
+
1. 在当前项目运行 PATH 中安装的 Comet CLI:
|
|
13
|
+
|
|
14
|
+
```text
|
|
15
|
+
comet workflow resolve . --activate --json
|
|
16
|
+
```
|
|
17
|
+
|
|
18
|
+
若项目还没有 `.comet/config.yaml`,该命令会把全局默认配置保存到项目中,并创建对应的产物目录。此后修改全局默认值,不会覆盖这个项目已经保存的配置。
|
|
19
|
+
|
|
20
|
+
若命令返回 `command not found`、`executable not found` 或 `ENOENT`,停止并说明 Comet CLI 安装不完整。不得搜索 Skill 文件、扫描平台配置目录或直接调用内部 bundle。
|
|
21
|
+
|
|
22
|
+
CLI 已启动但返回非零退出码、配置解析失败、输出不是 JSON 或字段无效时,保留原始错误并停止,不自行选择其他入口。
|
|
23
|
+
|
|
24
|
+
2. 解析 JSON。只接受 `schema: comet.workflow-resolution.v1`,且 `skill` 必须是下列两个值之一。
|
|
25
|
+
3. 根据返回的 `skill`,立即使用 Skill 工具加载对应入口。两个入口只能加载一个:
|
|
26
|
+
- `/comet-native` → **立即执行:** 使用 Skill 工具加载 `comet-native` 技能。禁止跳过此步骤。
|
|
27
|
+
- `/comet-classic` → **立即执行:** 使用 Skill 工具加载 `comet-classic` 技能。禁止跳过此步骤。
|
|
28
|
+
|
|
29
|
+
加载后,把用户原始请求完整交给该 Skill 执行。
|
|
30
|
+
|
|
31
|
+
入口完成工作流选择后,由对应 Skill 确定 change 所在的工作区和当前阶段,再加载任务上下文、个人记忆和项目知识;需要时使用 `comet memory context`。
|
|
32
|
+
|
|
33
|
+
对应 Skill 必须按需加载上下文:先通过 `comet task ... --json` 获取 Context Manifest(上下文清单),其中只有摘要、推荐使用的原因和稳定 ID。需要正文、来源或验证方式时,再增加 `--expand-context "<id>"`。
|
|
34
|
+
|
|
35
|
+
实际采用某条上下文且结果已经明确后,用返回的 application ID 调用 `--application "<application-id>" --outcome used-successfully|ignored|overridden|corrected|contributed-to-failure`,记录真实使用结果。未使用的内容不能记为使用成功。
|
|
36
|
+
|
|
37
|
+
不根据任务大小、文件数量、活跃 change 或模型的自行判断更换工作流。Native 与 Classic 分别管理自己的 change、状态和产物。
|
|
@@ -0,0 +1,77 @@
|
|
|
1
|
+
# 按需生成变更说明
|
|
2
|
+
|
|
3
|
+
项目 `.comet/config.yaml` 的 `change_walkthrough` 默认及缺省为 `true`,按本文件生成变更说明;开启会增加讲解内容的 token 消耗。仅显式 `false` 时跳过额外讲解整理、详细指引读取和 HTML 渲染,保留原有完成摘要,不为讲解额外读取差异或请求模型。
|
|
4
|
+
|
|
5
|
+
## Build 收尾
|
|
6
|
+
|
|
7
|
+
复用当前上下文、本次实际差异及已有检查结果,按功能组织简短讲解。不要启动额外 Agent、模型服务或检查。小改动一组即可;大改动先放主要变化,其余由模板折叠。Native Supervisor 只讲已集成结果,未集成子任务明确列为未完成。
|
|
8
|
+
|
|
9
|
+
先用用户能理解的话概括结果,再说明“原来怎样 → 现在怎样”和原因。每组列相关文件、增改删或重命名标签及足以核对的关键代码或局部 diff;路径可附行号或符号。删除解释移除的行为,重命名不虚构功能变化。复用已知比较范围,不确定或混有用户无关修改时说明限制,不把无关工作归为本次成果。不复制密钥、凭据或无关内容,不用整份 diff 填满页面。
|
|
10
|
+
|
|
11
|
+
将以下内容写到项目工作区以外的系统临时 JSON 文件,避免讲解输入影响实现检查。它只是渲染命令的输入,不是新的 workflow 状态或必需交接协议。模型只填内容,不编写 HTML、CSS 或脚本:
|
|
12
|
+
|
|
13
|
+
```json
|
|
14
|
+
{
|
|
15
|
+
"summary": "搜索支持按标签筛选",
|
|
16
|
+
"scope": "已知比较范围与限制,例如 HEAD 与本次工作区差异",
|
|
17
|
+
"changes": [
|
|
18
|
+
{
|
|
19
|
+
"title": "标签筛选",
|
|
20
|
+
"before": "只能输入关键词",
|
|
21
|
+
"after": "关键词与标签可以一起筛选",
|
|
22
|
+
"reason": "缩小结果范围",
|
|
23
|
+
"files": [{ "path": "src/search.ts:12", "kind": "modified", "code": "关键代码或局部 diff" }]
|
|
24
|
+
}
|
|
25
|
+
],
|
|
26
|
+
"verification": [
|
|
27
|
+
{ "label": "Builder 自检", "status": "passed", "detail": "实际命令、结果与覆盖范围" },
|
|
28
|
+
{ "label": "独立验收", "status": "not-run", "detail": "尚未执行" }
|
|
29
|
+
]
|
|
30
|
+
}
|
|
31
|
+
```
|
|
32
|
+
|
|
33
|
+
`kind` 为 `added`、`modified`、`deleted` 或 `renamed`。验证状态只用 `passed`、`failed`、`not-run`、`unknown`;分别列 Builder 自检、Runtime 检查、独立验收和未执行项,包含实际结果、已知风险与限制。讲解不能代替验证证据。
|
|
34
|
+
|
|
35
|
+
### 按需画关系图
|
|
36
|
+
|
|
37
|
+
实际变化涉及执行顺序、调用关系或数据去向时,优先用一张短流程图讲清主路径及关键分支;模块拆分、替换或职责转移时,用前后框线对照。图放在总览之后,按理解顺序关联文件和代码。简单文案、配置值或单点修改可以不画图,不为凑图虚构流程或关联。一般一到两张即可,图不替代说明与验证。
|
|
38
|
+
|
|
39
|
+
在同一临时内容中可选填写 `diagrams` 数组。模型只提供节点、连线和标签,固定模板绘制内嵌 SVG;不编写 SVG、HTML、CSS、Mermaid 或脚本,也不增加 Agent 或模型调用。例如为上面的搜索修改添加流程图:
|
|
40
|
+
|
|
41
|
+
```json
|
|
42
|
+
{
|
|
43
|
+
"diagrams": [
|
|
44
|
+
{
|
|
45
|
+
"type": "flow",
|
|
46
|
+
"title": "搜索路径",
|
|
47
|
+
"nodes": [
|
|
48
|
+
{ "id": "input", "label": "关键词与标签" },
|
|
49
|
+
{ "id": "filter", "label": "组合筛选", "file": "src/search.ts:12", "kind": "modified" },
|
|
50
|
+
{ "id": "result", "label": "匹配结果" }
|
|
51
|
+
],
|
|
52
|
+
"edges": [
|
|
53
|
+
{ "from": "input", "to": "filter" },
|
|
54
|
+
{ "from": "filter", "to": "result" }
|
|
55
|
+
]
|
|
56
|
+
}
|
|
57
|
+
]
|
|
58
|
+
}
|
|
59
|
+
```
|
|
60
|
+
|
|
61
|
+
前后对照使用 `{"type":"comparison","title":"职责变化","before":{"nodes":[...],"edges":[...]},"after":{"nodes":[...],"edges":[...]}}`,两侧各提供同样的节点和连线结构。节点可选 `kind` 沿用文件的增改删/重命名标签;只有真实变化才标记。节点的可选 `file` 必须与本次 `changes[].files[].path` 完全一致,点击后定位到对应代码详情;同一路径存在多个片段时,在两处使用相同的行号或符号限定。
|
|
62
|
+
|
|
63
|
+
短图每侧为 2–6 个节点、1–8 条连线,每层最多两个节点。节点 ID 唯一,按执行或依赖顺序排列,`from`/`to` 指向已有节点且从前向后连线;连线可选 `label` 简短说明条件。复杂循环或过大的关系拆成小图,只展示有依据的主路径,并在正文说明省略的分支。无须画图时省略 `diagrams`;不把页面图误称为真实运行证据。
|
|
64
|
+
|
|
65
|
+
运行 `comet walkthrough <native|classic> <change-name> --project-root <project-root> --file <temporary-json>`。成功返回绝对 `path`,固定模板写入当前 change 目录的 `walkthrough.html`。聊天保留简短摘要并提供 `[查看变更说明](<绝对路径>)`,在既有接受或交付决定前展示。页面可直接在浏览器打开。失败时说明“变更说明未生成”及原因,修正后可重试;原有工作流继续,不新增阶段或审批。
|
|
66
|
+
|
|
67
|
+
临时输入完成后可清除,避免混入实现差异;不能删除用户文件。不要把讲解页加入 brief 正式产物、检查输入、候选或额外绑定。
|
|
68
|
+
|
|
69
|
+
## Verify 更新同一页面
|
|
70
|
+
|
|
71
|
+
沿用实际检查及独立验收结果。仅补验证时,临时 JSON 只写 `verification` 数组,运行同一命令并加 `--verification-only`;渲染器复用页面中保存的讲解和图,无需模型再次整理。代码变了就同步受影响讲解、节点和连线,提交完整内容替换同一页面,并如实更新结果。缺页时可从当前上下文生成,不能把缺页作为验收阻塞。独立 Verifier 先独立核查需求和代码,再把 Builder 讲解作为线索。
|
|
72
|
+
|
|
73
|
+
更新页面不运行代码检查、不改变 Run 或批准。完成回复提供当前页面链接。关闭开关时不更新或补生成;无需删除已有页面。
|
|
74
|
+
|
|
75
|
+
## Archive 保存
|
|
76
|
+
|
|
77
|
+
随现有 change 材料保存已有页面,使用 Runtime 返回的归档目录提供最终本地链接。归档时不补生成、不重新整理讲解、不因缺页阻塞。仅在文件确实存在时提供链接;没有页面时保留原有完成摘要。
|
|
@@ -0,0 +1,26 @@
|
|
|
1
|
+
# 编辑后继续原流程
|
|
2
|
+
|
|
3
|
+
Build、Verify 或待归档阶段发生编辑时,由当前 Agent 判断实际影响。文件内容变化不自动撤回批准、作废检查或重置阶段;不提交文件指纹、hash 或逐文件保留证明。
|
|
4
|
+
|
|
5
|
+
1. 读取实际改动、当前需求、相关调用和已有检查结果。可使用 Git 差异和当前文件;缺少必要上下文时补读原文,不以文件大小、扩展名或摘要替代判断。连续保存合并处理,不逐次增加审查或确认。
|
|
6
|
+
2. 根据实际影响继续工作:说明、注释或排版未改变行为和验收含义时,保留原 Run、阶段、批准、报告和检查;实际实现变化时,沿当前流程修订实现并验收;目标、验收标准、方案或授权范围变化且原决定未覆盖时,只请求受影响的决定。
|
|
7
|
+
3. Agent 使用平台工具执行必要检查并读取实际结果。原检查仍适用时保留其真实来源;需要补查时只执行所需命令。不要求 observe、prepare-applied、record、retainedChecks 或内容证明链。按当前 Action 模板向 CLI 提交实际检查报告,普通编辑不增加独立审查会话。
|
|
8
|
+
4. 新失败、中断、超时、结果未知和未执行均如实保留。修复后用实际新结果更新结论,不能用旧成功覆盖最新失败,也不能把历史检查描述成本轮执行。已经完成的单次操作不自动重放。
|
|
9
|
+
5. 已接受结果尚未归档时,Agent 确认当前改动仍符合原需求和验收结论,再继续原归档;需要修复或补查时按实际影响处理。归档中断沿原事务继续,Runtime 记录哪些写入和目录移动已完成,避免重复副作用。
|
|
10
|
+
|
|
11
|
+
用户确认、明确要求的独立验收、阶段权限、路径和工作区隔离继续生效。Runtime 维护步骤、执行者、命令、退出状态、日志路径、用户决定和归档进度;共享 SDK 的 Action 请求标识、安装包摘要和 Git 提交 ID 保留。
|
|
12
|
+
|
|
13
|
+
完成条件:Agent 已核对改动影响,必要检查有实际结果,当前结论与用户要求一致,原流程能够继续。没有新增信息时不为记账重开 Build 或 Verify。
|
|
14
|
+
|
|
15
|
+
## Agent 判断与 CLI 执行
|
|
16
|
+
|
|
17
|
+
Native 与 Classic 由当前 Agent 判断需求、文档和开发进展;CLI 执行明确选择的操作,保存原 Run、用户决定、真实结果和恢复进度。
|
|
18
|
+
|
|
19
|
+
- 文档是否完整、需求是否明确、是否需要目标 Spec,由 Agent 对照用户请求与项目要求判断。模板是写作参考,固定标题、措辞、语言比例和设计文档 frontmatter 不作为完成证明。机器需要的验收项、任务 ID、路径和结果字段按当前响应填写;存在未解决的用户决定时先处理该决定。
|
|
20
|
+
- 选择与任务匹配的现有 workflow/preset。Classic full 保留设计、实施计划和用户批准;外部工具真正要求的材料继续满足。已有 Run 和正式材料可供交接时直接使用,不为阶段切换重复抄写相同内容。需要独立材料供人阅读或外部工具使用时再生成。
|
|
21
|
+
- Agent 明确选择检查命令、工作目录及本次范围,使用平台工具执行并读取真实退出状态,再向 CLI 提交报告。状态查询和 Guard 只读取结果,不自行猜测并启动 Build。原命令仍在运行或结果未知时,先核对同一执行。
|
|
22
|
+
- 每轮失败后结合实际修改与结果决定继续修复、换方案或请求帮助。验收项 ID 集合未缩小不等于没有进展。使用现有说明表达判断,无需评分或进展证明;用户预算和实际执行上限仍生效。
|
|
23
|
+
- 优先使用当前 workflow 的业务入口和返回模板。CLI 装配 SDK 的 Action、领取和并发控制参数,并连续处理已经授权的内部步骤;用户决定、不同执行者、真实失败或外部等待仍返回当前实际下一步。恢复沿用原 Run 和原执行。
|
|
24
|
+
- Agent 判断是否值得并行及如何拆分任务。Runtime 维护实际依赖、工作区、任务状态和 Git 操作;父级验收覆盖全部已确认验收项,复用适用的子任务结果并补足缺口。用户选定的协作方式和独立验收要求继续保留。
|
|
25
|
+
|
|
26
|
+
完成条件:需要的用户决定已有明确记录,当前任务的实际结果可核对,验收覆盖已确认要求,归档与交付按原授权和真实进度完成。缺少检查、执行失败、超时或未知结果时如实说明,不能写成通过。
|
|
@@ -0,0 +1,11 @@
|
|
|
1
|
+
# 宿主能力核对
|
|
2
|
+
|
|
3
|
+
新任务开始、切换宿主或执行配置改变时,在批准 Shape/Open 或开始依赖该配置的实现前核对本节。沿用当前宿主中已经确认且仍可用的能力,不为每个阶段重复探测。
|
|
4
|
+
|
|
5
|
+
Agent 根据当前平台实际提供的工具、Skill 清单和项目规则核对能力。CLI 不能枚举宿主工具;命令安装成功不代表可以派发审查者,也不代表外部 Skill 已获准使用。
|
|
6
|
+
|
|
7
|
+
- Native 必须能建立与 Builder 分开的 Verifier 会话,并跟踪原任务。Classic 的 `review_mode: standard|thorough` 需要独立 reviewer;选择子代理实施方式时还需要可跟踪的 implementer。只读限制针对项目实现与需求文件,审查者仍须能调用公开 Runtime 命令领取自己的 Action、请求检查和提交结果;不能把整个会话设为禁止 Runtime 写入的沙箱。
|
|
8
|
+
- Classic 新建与规格验证需要当前阶段指定的 OpenSpec Skill 和 CLI。full Design 需要 brainstorming;选定规划、实施、TDD 或审查策略后,再核对该策略指定的 Skill。Native 不增加外部 Skill 依赖。只核对实际采用的策略,不把未选策略的依赖当成当前阻塞。
|
|
9
|
+
- Skill 必须既可加载,又符合当前用户授权和项目规则。安装缺失、明确禁用、会话无法独立或无法回报 Runtime 时,说明具体缺口和恢复条件,在受影响的实现开始前处理。用户已有选择覆盖所需能力时直接继续,不追加确认。
|
|
10
|
+
|
|
11
|
+
能力不明时先核对可用工具说明,不为探测而派发真实实施或验收任务。保留用户可以选择的工作方式;缺口明确时说明需要安装、授权或更换宿主,不能悄悄关闭独立审查、改用另一种执行策略或把未知标为通过。用户后来明确改变策略时,按原 Runtime 决策路径更新。
|
|
@@ -0,0 +1,34 @@
|
|
|
1
|
+
# 普通命令与检查
|
|
2
|
+
|
|
3
|
+
Build、Verify、子任务和固定应用中的开发、测试及普通命令直接使用 Agent 平台工具。Agent 根据项目约定、改动和验收要求选择检查,读取实际结果;平台负责超时、取消和进程清理。Comet 保存业务状态、任务记录、用户批准及验收报告,不启动另一套普通命令执行器。
|
|
4
|
+
|
|
5
|
+
## 执行与结果
|
|
6
|
+
|
|
7
|
+
- 同一工作区和 Run 由一个主 Agent 顺序写入 Comet 状态;前一条写入命令完成后再提交下一条。并行子任务只修改各自隔离的 worktree,并把结果返回主 Agent。主 Agent 用原任务的 Action、真实子会话、领取身份及结果模板逐个提交,任务勾选也由主 Agent 完成;不得改用主会话冒充子执行者或重新领取已完成的任务。普通流程不创建锁或执行锁恢复。
|
|
8
|
+
- 先运行覆盖改动的必要检查。完整验收须覆盖当前候选的全部验收项,不等于仓库全量测试;用户选择的执行方式、TDD、审查和独立会话要求继续有效。
|
|
9
|
+
- 已有检查是否仍适用于当前候选,由 Agent 根据实现、输入与环境变化判断。保留命令、工作目录、真实结果和日志引用;只补缺失或失效的检查,不为向 Comet 提交报告再跑一遍。
|
|
10
|
+
- 已派发的任务沿用同一平台任务和真实会话。等待工具超时不代表任务已失败或停止;先用平台工具核对原任务。用户要求取消时,先按平台方式取消并核对清理结果,再记录业务取消;不伪造检查通过或进程已停止。
|
|
11
|
+
- 大日志保存在平台日志或文件中,工具响应只保留结论、相关失败片段及可读取的位置。需要细节时再读取,不反复返回全部历史、完整日志或已交付上下文。
|
|
12
|
+
- Eval、下载等由 Comet CLI 自己启动的能力按其专门命令管理清理。只有用户明确要求启动 Eval 时才能执行。
|
|
13
|
+
|
|
14
|
+
## 向 Comet 提交
|
|
15
|
+
|
|
16
|
+
Native 沿用当前 Action 模板的 `checks` 和验收条目提交实际结果。Classic SDK 将报告保存为 JSON:
|
|
17
|
+
|
|
18
|
+
```json
|
|
19
|
+
{ "checks": [{ "name": "命令、目录与检查名称", "result": "passed", "note": "实际结果与日志引用" }] }
|
|
20
|
+
```
|
|
21
|
+
|
|
22
|
+
失败项填写 `failed`,未执行项填写 `not-run` 并说明原因。没有适用检查时使用空 `checks` 并填写 `checksReason`。不能把未执行、超时或结果未知写成通过。Build 使用 `comet state complete-build <change> --checks <checks-json-file>`;Verify 使用 `comet guard <change> verify --report <report-ref> --apply --checks <checks-json-file>`。Runtime 继续核对任务、批准、候选和验收要求,失败后沿返回的业务续行修复。
|
|
23
|
+
|
|
24
|
+
Classic Compat 在平台命令结束后记录实际结果:
|
|
25
|
+
|
|
26
|
+
```bash
|
|
27
|
+
comet state record-check <change> <build|verify> --command "<实际命令>" --exit-code <实际退出码> --cwd <实际目录>
|
|
28
|
+
```
|
|
29
|
+
|
|
30
|
+
该命令只记录结果,不执行命令。随后按当前阶段运行 Guard;报告不能代替任务完成、用户批准或验收。旧 `comet check run/rerun` 只返回平台执行指引,不再运行或恢复检查。
|
|
31
|
+
|
|
32
|
+
## 旧版本升级
|
|
33
|
+
|
|
34
|
+
在原 change 和原 Run 继续,使用新版入口返回的模板与续行。自动转换保留原批准、任务、候选和已接受的业务结果,不重新要求用户批准相同决定,不重播归档或交付。旧检查调度不再执行;尚未确定结果的旧平台任务,先由 Agent 在原平台核对,再补实际检查报告。旧记录中的 PID、停止回执和内容快照不作为新流程的执行或验收依据。
|
|
@@ -0,0 +1,39 @@
|
|
|
1
|
+
# 任务学习收尾
|
|
2
|
+
|
|
3
|
+
任务结束前,由 Agent 分别检查个人偏好与项目经验。没有合格观察、可复用经验、已知待评审或待提交的实际使用反馈时,不创建空学习文件,也不为确认空队列运行 review;沿用当前会话与任务参数,用 `--complete --learning-check no-observation --project-learning-check no-observation` 完成收尾。未执行检查时用 `not-run`,不能声明已经检查;完成响应若列出本次 change 的待处理项,仍按返回指引处理。
|
|
4
|
+
|
|
5
|
+
有实际内容需要提交时,准备一个临时 UTF-8 JSON 文件。用户无需编写 JSON;文件不放进 change 产物或提交。
|
|
6
|
+
|
|
7
|
+
```json
|
|
8
|
+
{
|
|
9
|
+
"schema": "comet.task-learning.v1",
|
|
10
|
+
"personal": { "check": "no-observation" },
|
|
11
|
+
"project": { "check": "no-observation" }
|
|
12
|
+
}
|
|
13
|
+
```
|
|
14
|
+
|
|
15
|
+
两个 `check` 分别填写:`submitted` 表示本次提交或已持有对应回执;`no-observation` 表示 Agent 已检查,确实没有可复用内容;未检查时填 `not-run`。缺少记录不能自动推断为已经检查。
|
|
16
|
+
|
|
17
|
+
需要保存内容时,增加相应数组,并将该部分 `check` 改为 `submitted`:
|
|
18
|
+
|
|
19
|
+
- `personal.observations`:可跨任务复用的用户纠正、偏好或协作习惯。每项包含 `scope`(`project` 或 `global`)、`category`、`text` 和稳定 `candidateKey`;`userEvidence` 保留最小用户原话。用户实际限定的阶段、路径、任务类型和操作分别写入 `phases`、`pathPatterns`、`taskTypes`、`operations`。用户明确要求长期记住时,仍立即调用 `comet memory remember`,不延迟到收尾。
|
|
20
|
+
- `project.memories`:当前项目中已验证且未来可复用的经验。每项包含 `title`、`text`,可附 `type`、`description`、`slug`、`paths` 和 `evidence`。`evidence` 为支持结论的项目相对文件路径数组;没有文件依据的已确认协作决策可省略。同一标题默认更新已有经验。
|
|
21
|
+
- `project.memorySlugs`:此前已用 `comet knowledge remember` 保存的本次 change 回执,无需重复提交正文。
|
|
22
|
+
- `project.reviews`:本次 change 的 `{ "id": "...", "actions": [] }` 评审动作。仅在完成响应提示存在待评审时,运行 `comet knowledge review <project-root> --workflow <workflow> --change <change-id> --json` 获取证据与字段要求。Agent 审核后将动作放入本数组;没有可复用结论时用空 `actions`。评审与经验在同一文件提交。
|
|
23
|
+
- `outcomes`:已实际使用且结果明确的上下文反馈,包含 `applicationId`、`outcome`。真实采用且验证通过时才使用 `used-successfully`,并填写 `evidence.decision` 和 `evidence.verification`(`command`、`success: true`)。未使用的条目不能标为成功。
|
|
24
|
+
|
|
25
|
+
个人记忆不保存任务摘要、实现进展、命令输出、测试结果或仓库公共事实。项目经验不保存一次性输出或未验证猜测。每类数组最多 16 项,整个学习文件最多 256 KiB。
|
|
26
|
+
|
|
27
|
+
一次提交并完成收尾:
|
|
28
|
+
|
|
29
|
+
```text
|
|
30
|
+
comet task <project-root> --task "<用户原始请求>" --complete --workflow <native|classic> --change <change-id> --learning-file <临时JSON文件> --json
|
|
31
|
+
```
|
|
32
|
+
|
|
33
|
+
使用文件时不再重复传 `--learning-check`、`--project-learning-check` 或 `--memory`。workflow 与 change 由命令绑定,不在数组中另填。
|
|
34
|
+
|
|
35
|
+
完成标准:`learningSubmission.status` 为 `applied`,个人检查已核验,`projectLearning.submissionVerified` 为 `true`,项目待评审与待处理数量均为 0。`accepted` 表示仍有待处理项,`partial` 表示部分写入失败;读取 `personalObservations`、`errors` 和 `learningSubmission.nextActions`,按实际原因处理,修正后可重交同一文件,已有回执不会重复创建。观察被忽略或跳过时说明原因;确认没有合格观察后,移除该观察并声明 `no-observation`,不创建占位记忆。`not-run`、延迟、来源变化或调用失败需明确说明,学习未完成不阻断已完成的开发任务。
|
|
36
|
+
|
|
37
|
+
隐式工作流事件只写入现有学习队列,不在推进路径等待整理。待处理观察使用 `comet memory sync` 继续;排队不代表记忆已生效,也无需反复提交同一学习文件。显式记住、忘记和有证据的实际采用反馈仍立即处理。平台没有空闲事件适配时,需要显式运行 sync;安装插件不代表所有聊天都已自动接入。
|
|
38
|
+
|
|
39
|
+
旧版本不支持 `--learning-file` 时,沿用单项命令和显式检查参数,不循环重试不支持的选项。
|
|
@@ -0,0 +1,122 @@
|
|
|
1
|
+
apiVersion: comet/v1alpha1
|
|
2
|
+
kind: Skill
|
|
3
|
+
metadata:
|
|
4
|
+
name: comet-classic
|
|
5
|
+
version: '1'
|
|
6
|
+
description: 兼容现有 Classic 状态,按 full、hotfix、tweak 流程调度各阶段 Skill
|
|
7
|
+
goal:
|
|
8
|
+
statement: 保持现有 CLI 的用法,继续执行或恢复 Classic Run
|
|
9
|
+
inputs:
|
|
10
|
+
- name: classic-state
|
|
11
|
+
description: 已通过校验、且与 Run 中对应字段一致的 ClassicState
|
|
12
|
+
required: true
|
|
13
|
+
- name: evidence
|
|
14
|
+
description: Classic Evidence 收集器返回的结构化检查记录
|
|
15
|
+
required: true
|
|
16
|
+
outputs:
|
|
17
|
+
- name: run-state
|
|
18
|
+
description: 已通过一次原子操作同步的 Classic 与 Run 状态
|
|
19
|
+
required: true
|
|
20
|
+
success:
|
|
21
|
+
- 现有 Classic 字段与 Run 中的对应字段保持一致
|
|
22
|
+
- 每个步骤只调用声明的公开 Comet Skill
|
|
23
|
+
- 标记为 completed 前通过完成条件检查
|
|
24
|
+
orchestration:
|
|
25
|
+
mode: deterministic
|
|
26
|
+
entry: full.open
|
|
27
|
+
steps:
|
|
28
|
+
- id: full.open
|
|
29
|
+
action: { type: invoke_skill, ref: comet-open }
|
|
30
|
+
next: full.design.handoff
|
|
31
|
+
- id: full.design.handoff
|
|
32
|
+
action: { type: invoke_skill, ref: comet-design }
|
|
33
|
+
next: full.design.document
|
|
34
|
+
- id: full.design.document
|
|
35
|
+
action: { type: invoke_skill, ref: comet-design }
|
|
36
|
+
next: full.build.configure
|
|
37
|
+
- id: full.build.configure
|
|
38
|
+
action: { type: invoke_skill, ref: comet-build }
|
|
39
|
+
next: full.build.plan
|
|
40
|
+
- id: full.build.plan
|
|
41
|
+
action: { type: invoke_skill, ref: comet-build }
|
|
42
|
+
next: full.build.plan-ready
|
|
43
|
+
- id: full.build.plan-ready
|
|
44
|
+
action: { type: invoke_skill, ref: comet-build }
|
|
45
|
+
next: full.build.execute
|
|
46
|
+
- id: full.build.execute
|
|
47
|
+
action: { type: invoke_skill, ref: comet-build }
|
|
48
|
+
next: full.build.complete
|
|
49
|
+
- id: full.build.complete
|
|
50
|
+
action: { type: invoke_skill, ref: comet-build }
|
|
51
|
+
next: full.verify.run
|
|
52
|
+
- id: full.build.fix
|
|
53
|
+
action: { type: invoke_skill, ref: comet-build }
|
|
54
|
+
next: full.build.execute
|
|
55
|
+
- id: full.verify.run
|
|
56
|
+
action: { type: invoke_skill, ref: comet-verify }
|
|
57
|
+
next: full.verify.branch
|
|
58
|
+
- id: full.verify.branch
|
|
59
|
+
action: { type: invoke_skill, ref: comet-verify }
|
|
60
|
+
next: full.archive.confirm
|
|
61
|
+
- id: full.archive.confirm
|
|
62
|
+
action: { type: invoke_skill, ref: comet-archive }
|
|
63
|
+
next: full.archive.execute
|
|
64
|
+
- id: full.archive.execute
|
|
65
|
+
action: { type: invoke_skill, ref: comet-archive }
|
|
66
|
+
next: completed
|
|
67
|
+
- id: hotfix.open
|
|
68
|
+
action: { type: invoke_skill, ref: comet-hotfix }
|
|
69
|
+
next: hotfix.build.execute
|
|
70
|
+
- id: hotfix.build.execute
|
|
71
|
+
action: { type: invoke_skill, ref: comet-build }
|
|
72
|
+
next: hotfix.build.complete
|
|
73
|
+
- id: hotfix.build.complete
|
|
74
|
+
action: { type: invoke_skill, ref: comet-build }
|
|
75
|
+
next: hotfix.verify.run
|
|
76
|
+
- id: hotfix.verify.run
|
|
77
|
+
action: { type: invoke_skill, ref: comet-verify }
|
|
78
|
+
next: hotfix.verify.branch
|
|
79
|
+
- id: hotfix.verify.branch
|
|
80
|
+
action: { type: invoke_skill, ref: comet-verify }
|
|
81
|
+
next: hotfix.archive.confirm
|
|
82
|
+
- id: hotfix.archive.confirm
|
|
83
|
+
action: { type: invoke_skill, ref: comet-archive }
|
|
84
|
+
next: hotfix.archive.execute
|
|
85
|
+
- id: hotfix.archive.execute
|
|
86
|
+
action: { type: invoke_skill, ref: comet-archive }
|
|
87
|
+
next: completed
|
|
88
|
+
- id: tweak.open
|
|
89
|
+
action: { type: invoke_skill, ref: comet-tweak }
|
|
90
|
+
next: tweak.build.execute
|
|
91
|
+
- id: tweak.build.execute
|
|
92
|
+
action: { type: invoke_skill, ref: comet-build }
|
|
93
|
+
next: tweak.build.complete
|
|
94
|
+
- id: tweak.build.complete
|
|
95
|
+
action: { type: invoke_skill, ref: comet-build }
|
|
96
|
+
next: tweak.verify.run
|
|
97
|
+
- id: tweak.verify.run
|
|
98
|
+
action: { type: invoke_skill, ref: comet-verify }
|
|
99
|
+
next: tweak.verify.branch
|
|
100
|
+
- id: tweak.verify.branch
|
|
101
|
+
action: { type: invoke_skill, ref: comet-verify }
|
|
102
|
+
next: tweak.archive.confirm
|
|
103
|
+
- id: tweak.archive.confirm
|
|
104
|
+
action: { type: invoke_skill, ref: comet-archive }
|
|
105
|
+
next: tweak.archive.execute
|
|
106
|
+
- id: tweak.archive.execute
|
|
107
|
+
action: { type: invoke_skill, ref: comet-archive }
|
|
108
|
+
next: completed
|
|
109
|
+
- id: completed
|
|
110
|
+
action: { type: checkpoint }
|
|
111
|
+
completionEvals:
|
|
112
|
+
- classic-completed
|
|
113
|
+
skills:
|
|
114
|
+
- id: comet-open
|
|
115
|
+
- id: comet-design
|
|
116
|
+
- id: comet-build
|
|
117
|
+
- id: comet-verify
|
|
118
|
+
- id: comet-archive
|
|
119
|
+
- id: comet-hotfix
|
|
120
|
+
- id: comet-tweak
|
|
121
|
+
agents: []
|
|
122
|
+
tools: []
|