@rpamis/comet 0.3.8 → 0.4.0-beta.1

package/assets/skills-zh/comet-any/reference/bundle-authoring.md

@@ -0,0 +1,166 @@
+# Bundle Authoring 参考
+
+`comet creator` 是 `/comet-any` 的普通 CLI 表面，背后复用 `comet bundle` 的确定性后端。普通用户不需要记忆 Bundle 子命令；Skill Creator 负责把用户确认的 Workflow Contract 写成 plan，再调用 CLI 维护状态。
+
+## Workflow Contract 输入
+
+新的 `plan.json` 使用 `workflow` 作为主输入：
+
+```json
+{
+  "goal": "基于 Comet 现有 Skill 的五阶段定制，要求组件库和白盒审查。",
+  "skillCreatorIntent": "customize-comet",
+  "workflow": {
+    "kind": "comet-five-phase-overlay",
+    "name": "team-comet",
+    "goal": "要求组件库和白盒审查。",
+    "nodes": {
+      "execute": {
+        "requiredSkillCalls": [
+          {
+            "skill": "elementui",
+            "reason": "Use project component library during direct implementation."
+          }
+        ]
+      },
+      "subagent-execute": {
+        "requiredSkillCalls": [
+          {
+            "skill": "elementui",
+            "scope": "handoff"
+          }
+        ]
+      },
+      "review": {
+        "requiredSkillCalls": [
+          {
+            "skill": "whitebox-code-standard",
+            "scope": "review"
+          }
+        ]
+      }
+    }
+  },
+  "engineMode": "deterministic",
+  "runnerMode": "standalone"
+}
+```
+
+字段约定：
+
+- `workflow.kind`: `comet-five-phase-overlay` 或 `workflow-kernel`。
+- `workflow.nodes`: 按 Node id 覆盖或增强 Workflow Node。
+- `implementation`: 替换 Node implementation。只能用于允许 override 的 Node。
+- `requiredSkillCalls`: Required Skill Call，要求 Node 内必须调用 Skill。
+- `augmentations`: 增强 Node，不替换主 implementation。每个新增 binding 或 schema 都必须声明 enforcement：`guarded`、`handoff-guarded`、`evidence-only` 或 `advisory`。
+- `satisfies`: producer override 满足的 Output Schema id。
+- `outputSchemas`: 高级 `workflow-kernel` 可以声明自定义 Output Schema。Output Schema 必须挂到具体 Workflow Node 才算生效；只定义在 `workflow.outputSchemas` 里不会触发 guard、eval 或 readiness。
+- `customNodes[].responsibility`: 自定义 Node 必须声明它在 Agent workflow 中承担的职责。
+- `customNodes[].requiredSkillCalls`: 自定义 Node 可直接声明必须调用的 Skill，生成脚本会按 evidence 阻断。
+
+## 内置 Comet Nodes
+
+`comet-five-phase-overlay` 内置这些 Workflow Node：
+
+- `comet-five-phase-overlay` 的主状态只来自 `openspec/changes/<name>/.comet.yaml`；没有 active change 或多个 active changes 时必须阻塞并请用户选择。
+- 不得创建 `.comet/runs/<workflow>/state.json` 作为 Comet overlay 主状态；overlay 脚本只能读取并推进 `.comet.yaml`，其他文件只能作为 draft、eval 或 publish evidence。
+- `open`: control，保留 Comet intake 和 `.comet.yaml` 初始化。
+- `design`: producer，可 override，但必须满足 `comet.design.v1`。
+- `plan`: producer，可 override，但必须满足 `comet.plan.v1`。
+- `execute`: control，可 require / augment，例如要求 `elementui`。
+- `subagent-execute`: Handoff，可要求子代理使用 `elementui` 并回传 evidence。
+- `review`: Guardrail，可要求 `whitebox-code-standard`。
+- `verify`: control，保留验证和分支收尾。
+- `archive`: control，保留 OpenSpec archive 和 delta sync。
+
+自定义 `workflow-kernel` Node 示例：
+
+```json
+{
+  "id": "delegate-notes",
+  "label": "Delegate Notes",
+  "kind": "handoff",
+  "responsibility": "Delegate release note drafting and require returned evidence.",
+  "implementation": {
+    "skill": "handoff-coordinator",
+    "scope": "handoff"
+  },
+  "requiredSkillCalls": [
+    {
+      "skill": "release-notes",
+      "scope": "handoff"
+    }
+  ],
+  "operations": ["require", "augment"],
+  "outputSchemas": ["release.notes.v1"],
+  "guardrails": [
+    {
+      "id": "handoff-returned",
+      "label": "Handoff returned evidence",
+      "validation": "semantic"
+    }
+  ]
+}
+```
+
+## 生成物
+
+Factory 必须生成：
+
+- entry `SKILL.md`
+- 每个 Workflow Node 对应的 internal Skill
+- `reference/workflow-protocol.json`
+- `reference/resolved-skills.json`
+- `reference/decision-points.md`
+- `reference/recovery.md`
+- `reference/authoring-lanes.json`
+- `reference/skill-review.md`
+- `scripts/workflow-state.mjs`
+- `scripts/workflow-guard.mjs`
+- `scripts/workflow-handoff.mjs`
+- `scripts/comet-plan.mjs`
+- `scripts/comet-check.mjs`
+- `scripts/comet-hook-guard.mjs`
+- `comet/eval.yaml`
+
+三个 `workflow-*.mjs` 按 workflow 契约创作；三个 `comet-*.mjs` 由 factory 确定性生成（plan 别名、必需文件检查、hook guard），同样读取 `workflow-protocol.json`。
+
+`workflow-protocol.json` 是 runtime、eval、review、publish readiness 的共同事实源。
+
+## CLI 生命周期
+
+常用 Creator 命令：
+
+```bash
+comet creator guide --project . --json
+comet creator candidates --json
+comet creator propose <name> --file <plan.json> --json
+comet creator init <name> --file <plan.json> --confirmed-proposal --json
+comet creator resolve <name> --candidate <query> --source <root-or-hash> --json
+comet creator generate <name> --json
+comet bundle compile <name> --platform <id> --json
+comet eval <generated-skill>/comet/eval.yaml --quick --html
+comet eval <generated-skill>/comet/eval.yaml --full --html
+comet publish review <name> --platform <reference-platform> --json
+comet publish approve <name> --reviewer <reviewer> --json
+comet publish run <name> --platform <reference-platform> --json
+comet publish distribute <name> --platform <id> --scope project --preview --json
+```
+
+`<generated-skill>` 是 compile 后生成 Skill 的目录。eval 结果必须登记为当前 draft hash 的 eval evidence；readiness 只读取该 hash 对应的证据，旧 hash 证据只能保留作审计，不能推进 ready。
+
+## Readiness
+
+readiness 必须检查：
+
+- resolved Skills 无 missing / ambiguous。
+- proposal 已确认。
+- `workflow-protocol.json` 可加载。
+- control Node 没有普通 override。
+- producer override 满足 Output Schema。
+- 每个新增 binding 或 schema 都有 `guarded`、`handoff-guarded`、`evidence-only` 或 `advisory` enforcement。
+- 当前 draft hash 的 eval evidence 已存在且未过期。
+- 人工 review 已批准当前 hash。
+- capability gap 和 executable disclosure 已展示。
+
+非 JSON 输出也必须向用户展示 `Readiness:`、`Blockers:`、`Warnings:`、`Evidence:`。

package/assets/skills-zh/comet-any/reference/eval-provider.md

@@ -0,0 +1,66 @@
+# Eval Evidence 参考
+
+## Eval 选择
+
+在任何验证动作前，必须展示：
+
+- `quick` 的预计运行次数、覆盖组件和 token 消耗。
+- `full` 的预计运行次数、覆盖组件和 token 消耗。
+- `skip / quick / full eval` 三个选择。
+
+skip、eval 失败或证据 hash 过期时不得进入 ready；也不得 publish 或 distribute。
+
+普通用户的验证路径保持单一：日常评估统一走 `comet eval`。`/comet-any` 可以在内部登记 eval evidence，但不要把内部登记步骤包装成面向普通用户的替代命令。对普通用户，解释时优先使用“验证”，不要把 `Publish readiness:` 当成第一层概念。
+
+## 结果记录
+
+eval evidence 必须输出结构化 JSON，至少包含：
+
+- 当前 draft hash。
+- 覆盖的 entry Skill 和 internal Node Skill。
+- `workflow-protocol.json` hash。
+- quick 或 full 的选择、token 消耗和结果摘要。
+- Bundle 编译、安全检查和 capability evidence。
+
+只有当前 draft hash 的 eval evidence 可以推进状态。旧 hash 证据可以保留在磁盘用于审计，但不能让当前 draft 进入 ready。
+
+## 人工评审
+
+eval 通过后仍必须人工批准。评审摘要至少包含：
+
+先运行 `comet publish review <name> --platform <reference-platform> --json`，再基于其输出展示：
+
+- Bundle 名称、版本、hash。
+- 多个 entry 与 internal Skill 列表。
+- `planHash`、`preferenceHash` 与 `reference/resolved-skills.json` 真实 Skill 证据，包括项目级偏好模式、required Skill、`sourceSummaries` 与“整理后的工作方式”摘要。
+- 推荐调用顺序与 `preferenceIndex`。
+- 偏离偏好顺序的项和原因。
+- `.comet/skill-preferences.yaml` 是否在 Factory 初始化后发生漂移；`advisory` 模式给出 warning，`strict` 模式阻塞。
+- 稳定组合 Skill Bundle 的 required capability set（必需能力集合）`skills/scripts/rules/hooks/references` 是否声明完整，且 `scripts/rules/hooks` 是否继续作为 required control plane。
+- 是否生成 `comet/skill.yaml`、`comet/guardrails.yaml`、`comet/checks.yaml` 与 `comet/eval.yaml`。
+- `hooks/*.yaml` 是否仅被当作 portable hook descriptor，等待 `comet publish distribute` 编译到目标平台。
+- 能力缺口和可执行披露。
+- eval 选择、token 消耗和结果摘要。
+- `Validate this Skill` 与下一步提示，让用户知道 readiness 为什么可发布或被阻塞。
+
+readiness blockers 会阻止 publish。只要存在当前 draft hash 的 eval evidence 缺失、人工 approval 缺失、required capability gap 或 executable disclosure 未确认，就必须停在评审阶段，不能继续发布。
+
+只有用户显式批准后，才能运行 `comet publish approve` 并发布。
+
+## 分发预览
+
+执行真实分发前，必须先跑 preview：
+
+```bash
+comet publish distribute <name> --platform <id> --scope project --preview --json
+```
+
+preview 是强制检查，不是可选附加项。它应向用户展示：
+
+- `Install preview`
+- planned files
+- unsupported capability
+- executable disclosures
+- `No files were written`
+
+只有当用户确认 preview 结果后，才可以移除 `--preview` 执行真实分发。

package/assets/skills-zh/comet-any/reference/subagents/pause-points-author.md

@@ -0,0 +1,79 @@
+# 停顿点作者 subagent
+
+本文件是 portable lane brief，不是 platform-native custom agent；如需 Claude Code custom agent，必须另行生成平台 agent 资源和 frontmatter。
+
+## 职责
+
+设计用户在 Skill 中必须停顿选择的位置，以及跨设备断点恢复方式。停顿点必须是明确的用户选择，
+不能被默认推荐、历史偏好或自动推进绕过。
+
+必须覆盖：
+
+- `reference/decision-points.md`
+- `reference/recovery.md`
+
+## 输入
+
+读取主会话提供的通用输入，尤其关注：
+
+- Skill Creator 方案确认页中的 `confirm-generate`、`revise-proposal`、`cancel`。
+- eval 工作量选择 `skip / quick / full eval`，以及当前 draft hash 的 eval evidence 缺失或过期时的阻塞恢复。
+- 安装前人工批准。
+- unresolved、ambiguous、capability gap、executable disclosure 等阻塞点。
+- runner 恢复状态和跨设备恢复入口。
+
+使用文件交接：主会话提供路径，不粘贴大段全文。不要继承主会话历史；只使用本 brief、通用输入、
+workflow protocol 和已有草稿。
+
+## 派发模板
+
+主会话派发时使用当前平台的 subagent 机制，形状应包含：
+
+```text
+description: "设计 <bundle-name> 的用户停顿点和恢复"
+model: <必须显式指定 model>
+prompt:
+  你是停顿点作者 subagent。
+  先读取本 brief、通用输入路径、workflow protocol 路径、Skill 草稿路径和报告文件路径。
+  开始前先提出问题：如果用户选择项、阻塞恢复或跨设备状态不清楚，先返回 NEEDS_CONTEXT。
+  不要猜测或自行补全缺失停顿点。
+  只产出 decision-points 和 recovery 草稿，不写 Bundle state，不执行候选脚本。
+  把完整停顿点草稿写入报告文件路径，并只返回 15 行以内状态摘要。
+```
+
+## 输出要求
+
+返回停顿点草稿，说明：
+
+- 每个停顿点的触发条件。
+- 用户可选择项。
+- 每个选择会进入哪个阶段。
+- 停顿点证据写入哪里。
+- 恢复时如何显示当前阶段、阻塞原因、建议下一步和可选项。
+
+停顿点必须适配当前 workflow protocol，不得只列 Comet 原始停顿点。
+
+## 自检
+
+返回前逐项检查：
+
+- 每个用户停顿点都有触发条件、选项、下一阶段和证据位置。
+- 默认推荐、历史偏好和自动推进都不能绕过必须停顿点。
+- 恢复摘要能显示当前阶段、阻塞原因、建议下一步和可选项。
+- 跨设备恢复不依赖当前会话记忆。
+- 停顿点适配当前组合 Skill，不只是照列 Comet 原始停顿点。
+
+## 必须返回的 claim
+
+- `pause:decision-points`
+- `pause:recovery`
+
+缺少任一 claim 时，Skill 审查必须阻塞。
+
+## 状态返回
+
+状态必须是 `DONE`、`DONE_WITH_CONCERNS`、`NEEDS_CONTEXT`、`BLOCKED`。
+
+完整报告写入报告文件路径。返回给主会话的摘要只返回 15 行以内状态摘要，包含状态、报告文件路径、
+claim 列表、未解决疑虑和恢复风险。若状态是 `BLOCKED` 或 `NEEDS_CONTEXT`，必须直接说明缺什么上下文、
+尝试过什么、需要主会话如何处理。

package/assets/skills-zh/comet-any/reference/subagents/reference-author.md

@@ -0,0 +1,81 @@
+# reference 作者 subagent
+
+本文件是 portable lane brief，不是 platform-native custom agent；如需 Claude Code custom agent，必须另行生成平台 agent 资源和 frontmatter。
+
+## 职责
+
+编写和整理候选 Skill 的 reference 层，让审计、恢复、评审和后续维护有真实依据。
+reference 层承载证据，不把内部审计内容塞进用户可见 `SKILL.md`。
+
+必须覆盖：
+
+- `reference/workflow-protocol.json`
+- `reference/resolved-skills.json`
+- `reference/composition-report.md`
+- `reference/authoring-lanes.json`
+
+## 输入
+
+读取主会话提供的通用输入，尤其关注：
+
+- resolved Skill 的名称、来源、description、hash、reference、rules、scripts、hooks。
+- `sourceSummaries`，必须来自真实 `SKILL.md` 正文和直接 reference。
+- 项目级偏好、缺失/歧义候选处理、偏离原因和可执行披露。
+- `/comet` 定制时保留的五阶段语义。
+
+使用文件交接：主会话提供路径，不粘贴大段全文。不要读取主会话历史，也不要把来源 Skill 原文整段搬进
+reference。
+
+## 派发模板
+
+主会话派发时使用当前平台的 subagent 机制，形状应包含：
+
+```text
+description: "整理 <bundle-name> 的 reference 证据"
+model: <必须显式指定 model>
+prompt:
+  你是 reference 作者 subagent。
+  先读取本 brief、通用输入路径、resolved skills 路径、workflow protocol 路径和报告文件路径。
+  开始前先提出问题：如果来源证据、hash、偏好决策或可执行披露不清楚，先返回 NEEDS_CONTEXT。
+  不要猜测或自行补全缺失来源。
+  只产出 reference 草稿和 claims，不写 Bundle state，不执行候选脚本。
+  把完整 reference 草稿写入报告文件路径，并只返回 15 行以内状态摘要。
+```
+
+## 输出要求
+
+返回 reference 草稿，说明：
+
+- workflow protocol 中每个阶段的目标、守卫、下一阶段条件和恢复点。
+- resolved Skill 证据如何支持组合流程。
+- 组合与用户偏好哪里一致、哪里偏离、为什么偏离。
+- 哪些内容属于用户可见流程，哪些内容只保留在 reference 审计层。
+
+不要把 reference 写成原 Skill 的复制粘贴；必须提炼为组合 Skill 可用的证据和协议。
+
+## 自检
+
+返回前逐项检查：
+
+- 每个 source summary 都能追溯到真实 `SKILL.md` 或直接 reference。
+- workflow protocol 能解释阶段目标、守卫、自动推进和恢复。
+- 偏好、缺失、歧义、偏离和可执行披露都有记录。
+- 用户可见流程和内部审计内容边界清楚。
+- 没有把原 Skill 全文复制进 reference。
+
+## 必须返回的 claim
+
+- `reference:workflow-protocol`
+- `reference:resolved-skills`
+- `reference:composition-report`
+- `reference:authoring-lanes`
+
+缺少任一 claim 时，Skill 审查必须阻塞。
+
+## 状态返回
+
+状态必须是 `DONE`、`DONE_WITH_CONCERNS`、`NEEDS_CONTEXT`、`BLOCKED`。
+
+完整报告写入报告文件路径。返回给主会话的摘要只返回 15 行以内状态摘要，包含状态、报告文件路径、
+claim 列表、证据缺口和疑虑。若状态是 `BLOCKED` 或 `NEEDS_CONTEXT`，必须直接说明缺什么来源、
+尝试过什么、需要主会话如何处理。

package/assets/skills-zh/comet-any/reference/subagents/script-author.md

@@ -0,0 +1,84 @@
+# 脚本作者 subagent
+
+本文件是 portable lane brief，不是 platform-native custom agent；如需 Claude Code custom agent，必须另行生成平台 agent 资源和 frontmatter。
+
+## 职责
+
+设计候选 Skill 的脚本契约，而不是复制 Comet Classic 的脚本。脚本必须根据当前 workflow protocol、
+用户选择的阶段名和组合 Skill 的真实产物，定义自动推进、退出检查、断点恢复和证据记录。
+
+必须覆盖：
+
+- `scripts/workflow-state.mjs`
+- `scripts/workflow-guard.mjs`
+- `scripts/workflow-handoff.mjs`
+
+factory 还会从同一份 `workflow-protocol.json` 确定性生成 `scripts/comet-plan.mjs`、`scripts/comet-check.mjs`、`scripts/comet-hook-guard.mjs`。不要重复设计这三个脚本；你的契约只针对 skill-core 作者与 entry 作者引用的 `workflow-*.mjs`。
+
+## 输入
+
+读取主会话提供的通用输入，尤其关注：
+
+- `reference/workflow-protocol.json`
+- `plan.json` 的 `workflow.kind`、`workflow.nodes`、`engineMode`、`runnerMode`，以及规范化后的 `workflow-protocol.json`
+- `reference/resolved-skills.json`
+- `/comet` 定制时的 `.comet.yaml` 受保护语义；`comet-five-phase-overlay` 的主状态只来自 `openspec/changes/<name>/.comet.yaml`，不得创建 `.comet/runs/<workflow>/state.json` 作为 Comet overlay 主状态
+
+使用文件交接：主会话提供路径，不粘贴大段全文。不要读取主会话历史，也不要要求用户重新解释已经写入
+artifact 的内容。
+
+## 派发模板
+
+主会话派发时使用当前平台的 subagent 机制，形状应包含：
+
+```text
+description: "编写 <bundle-name> 的脚本契约"
+model: <必须显式指定 model>
+prompt:
+  你是脚本作者 subagent。
+  先读取本 brief、通用输入路径、workflow protocol 路径、resolved skills 路径和报告文件路径。
+  开始前先提出问题：如果脚本边界、Node 完成条件、状态写入或恢复语义不清楚，先返回 NEEDS_CONTEXT。
+  不要猜测或自行补全缺失协议。
+  不要调用 comet bundle、comet publish、comet skill，也不要执行候选 Skill 的脚本。
+  把完整脚本契约写入报告文件路径，并只返回 15 行以内状态摘要。
+```
+
+## 输出要求
+
+返回脚本契约草稿，说明每个脚本：
+
+- 读取哪些状态。
+- 写入哪些状态和 evidence。
+- 对 `comet-five-phase-overlay`，如何在没有 active change 或多个 active changes 时阻塞并请用户选择。
+- 如何判断当前阶段目标是否完成。
+- 如何输出 `NEXT:`、`SKILL:` 和阻塞原因。
+- 如何在阶段未完成时继续停留，而不是强制退出。
+- 如何支持跨设备断点恢复。
+
+退出检查必须来自当前 workflow protocol 和组合 Skill 的目标，不得照搬 Comet Classic 脚本。
+
+## 自检
+
+返回前逐项检查：
+
+- 每个脚本都有输入、输出、状态读写、evidence 写入和失败行为。
+- Node 完成条件来自 workflow protocol，而不是来自固定阶段名。
+- `NEXT:` 和 `SKILL:` 的输出条件可被 Skill 核心作者直接引用。
+- 跨设备恢复不依赖当前会话记忆。
+- 没有执行候选脚本，也没有写入 Bundle state。
+
+## 必须返回的 claim
+
+- `script:workflow-state`
+- `script:workflow-guard`
+- `script:workflow-handoff`
+
+缺少任一 claim 时，Skill 审查必须阻塞。
+
+## 状态返回
+
+状态必须是 `DONE`、`DONE_WITH_CONCERNS`、`NEEDS_CONTEXT`、`BLOCKED`。
+
+完整报告写入报告文件路径。返回给主会话的摘要只返回 15 行以内状态摘要，包含状态、报告文件路径、
+claim 列表、测试/校验说明和疑虑。若状态是 `BLOCKED` 或 `NEEDS_CONTEXT`，必须直接说明缺什么上下文、
+尝试过什么、需要主会话如何处理。

package/assets/skills-zh/comet-any/reference/subagents/skill-core-author.md

@@ -0,0 +1,129 @@
+# Skill 核心作者 subagent
+
+本文件是 portable lane brief，不是 platform-native custom agent；如需 Claude Code custom agent，必须另行生成平台 agent 资源和 frontmatter。
+
+## 职责
+
+编写 internal Node Skill 的用户可见核心内容。entry Skill 由 workflow entry 作者单独负责。目标是产出 Comet-like 的多 Node workflow，
+不得把来源 Skill 简单串联，也不复制粘贴原 Skill 全文。
+
+必须覆盖：
+
+- 每个 internal Node Skill
+- `comet/skill.yaml` 中的阶段调用语义
+- 每个 `node-skill:<skill-name>` claim
+
+## 创作区（你写什么）
+
+生成器把每个 Node SKILL.md 组装成确定性 **Auto 区**（frontmatter、Node Goal、Entry Check、Skill Implementation、Required Skill Calls、Output Schemas、Evidence Record、Guardrails、Exit Check、Recovery）+ 由你编写的 **Authored 区**（`## Guidance`）。**你只写 Guidance 正文，不写整个文件**。主会话通过 `comet creator authoring-record <name> --lane skill-core --file <out.json>` 记录你的产出；artifact `../<node-skill>/SKILL.md` 的 `content` 即 Guidance 正文。
+
+质量标尺：真实的 Comet 阶段 skill（如 `comet-build/SKILL.md`）；完整 substance 节点 Guidance 范例见 `reference/authored-zone-example.md`。写决策内容，不写套话。在 Guidance 内用 `###` 子标题（嵌套在 `## Guidance` 之下）：
+
+- `### Prerequisites` — 本 Node 开始前必须成立的前提。
+- `### Steps` — 有序、领域相关的步骤；按名引用绑定的 Skill 并说明何时调用（不要复制它的正文）。
+- `### Completion reasoning` — 本 Node 真正完成的判定（超出机械的 Exit Check），以及其中的判断取舍。
+- `### Red flags` — 看似进展、实则不然的失败模式。
+
+下面是"Research" substance 节点的具体摘录，展示预期深度。注意它是**决策内容**（何时停止、什么算充分、什么该拒绝），不是重述路由表或 output schema。
+
+```markdown
+### Prerequisites
+
+- entry 的 Decision Core 已确认研究主题与范围。
+- `research-skill` 在项目 Skill 池中可解析；若缺失，先停下询问用户，不要临时替代。
+
+### Steps
+
+1. 加载 `research-skill` 并按其发现方法处理已确认主题。当项目 Skill 定义了特定来源顺序时，不要用通用网络搜索替代。
+2. 按优先级收集来源；为每个来源记录来源、日期和你要复用的论点。不通过项目可信度门槛的来源应直接剔除，而不是标注为"偏弱"。
+3. 把发现提炼到 `notes/*.md` 笔记文件——每条独立论点一份，含逐字引用与来源指针。综合写在 writer 节点，不在这里。
+4. 记录 `research.notes.v1` 的 `summary` evidence：一段提炼 + 产出的笔记数量。
+
+### Completion reasoning
+
+本节点完成当且仅当两条同时成立：(a) 已记录 `summary` evidence；(b) 至少一个 artifact 匹配 `notes/*.md`。不要仅仅因为步骤清单走完就退出——如果相对主题范围笔记仍偏稀疏，应继续研究而非宣布完成。Exit Check 脚本会机械地强制 artifact + evidence 要求；你的职责是判断研究是否真正充分。
+
+### Red flags
+
+- 记录了 `summary` 却没有产出任何 `notes/*.md` 就退出（guardrail 会阻塞——不要试图绕过）。
+- 把来源原文复制进笔记却不加引用标记或来源指针。
+- 某来源仍"待核实"就推进到 Write 节点——核实属于本节点。
+- 对需要多视角的主题，仅凭单一来源就认为充分。
+```
+
+节点模式（来自 protocol）：
+
+- **substance** 节点（workflow-kernel 默认）：必须有富 Guidance。缺失时该节点渲染为 `AUTHORING PENDING`，Bundle 不得 ready。
+- **delegates** 节点（comet-five-phase-overlay，委托给已安装的富 Skill）：短 Guidance 注即可——富内容由被委托 Skill 承载，不要复制。
+
+## 输入
+
+读取主会话提供的通用输入，尤其关注：
+
+- 用户确认的阶段名和可输入名字项。
+- `reference/workflow-protocol.json` 的阶段目标、`requiredSkillCalls` 与自动推进条件。
+- `reference/resolved-skills.json` 的真实 Skill 摘要。
+- 脚本作者返回的 `NEXT:`、`SKILL:`、guard 和 recovery 契约。
+
+使用文件交接：主会话提供路径，不粘贴大段全文。不要继承主会话历史；只使用本 brief、通用输入、
+脚本契约和 reference 证据。
+
+## 派发模板
+
+主会话派发时使用当前平台的 subagent 机制，形状应包含：
+
+```text
+description: "编写 <bundle-name> 的 Skill 核心内容"
+model: <必须显式指定 model>
+prompt:
+  你是 Skill 核心作者 subagent。
+  先读取本 brief、通用输入路径、脚本契约路径、reference 证据路径和报告文件路径。
+  开始前先提出问题：如果阶段名、必须调用的 Skill、自动推进或用户停顿点不清楚，先返回 NEEDS_CONTEXT。
+  不要猜测或自行补全缺失流程。
+  只写 internal Node Skill 草稿，不写 entry Skill，不写 Bundle state，不执行候选脚本。
+  把完整 Skill 草稿写入报告文件路径，并只返回 15 行以内状态摘要。
+```
+
+## 输出要求
+
+返回 internal Node Skill 草稿，必须体现：
+
+- internal Node Skill 负责单 Node 目标、必须调用的 Skill、Node 完成证据和脚本守卫。
+- 若 protocol 声明 `requiredSkillCalls`，对应阶段必须明确写出目标槽位、必调 Skill、适用范围和证据要求；subagent 场景必须写明子代理任务提示中也要加载该 Skill。
+- 阶段未达成目标时继续工作，不因为流程清单走完就退出。
+- 自动推进必须来自脚本输出的 `NEXT:` 和 `SKILL:`，而不是让 Agent 猜下一步。
+- 嵌套 Skill 调用只写 Skill 名字，不写 provider 前缀。
+- 对 `/comet` 定制，保留 `open / design / build / verify / archive` 与 `.comet.yaml` 语义。
+- 对任意 Skill 组合，整理为 Comet-like 多 Node workflow。
+
+禁止：
+
+- 复制粘贴原 Skill 全文。
+- 写 `Superpowers writing-plans`、`OpenSpec openspec-propose` 这类 provider 前缀。
+- 在中文 Skill 中混入英文流程句。
+- 把审计报告、source hash、内部 metadata 泄漏到用户可见 `SKILL.md`。
+
+## 自检
+
+返回前逐项检查：
+
+- 每个阶段都说明必须调用的 Skill、完成证据、脚本守卫和恢复入口。
+- 每个 `requiredSkillCalls` 都能在对应Node Skill 中找到明确加载指令和证据要求。
+- 自动推进引用脚本输出的 `NEXT:` 和 `SKILL:`。
+- Skill 调用只写 Skill 名字，不写 provider 前缀。
+- 中文用户可见文案没有混入英文流程句。
+- 没有复制粘贴原 Skill 全文。
+
+## 必须返回的 claim
+
+- 每个 internal Node Skill 的 `node-skill:<skill-name>`
+
+缺少任一 claim 时，Skill 审查必须阻塞。
+
+## 状态返回
+
+状态必须是 `DONE`、`DONE_WITH_CONCERNS`、`NEEDS_CONTEXT`、`BLOCKED`。
+
+完整报告写入报告文件路径。返回给主会话的摘要只返回 15 行以内状态摘要，包含状态、报告文件路径、
+claim 列表、未解决疑虑和建议返工点。若状态是 `BLOCKED` 或 `NEEDS_CONTEXT`，必须直接说明缺什么上下文、
+尝试过什么、需要主会话如何处理。