跳至正文
OpenAgentSkill
浏览已开放 · 目录记录日期 2026-11-21 · 自动更新和账户服务暂时关闭。
浏览器与自动化

goga-brainstorm-contracts-annotations

Writing annotations at all levels for a single cell in the brainstorm contracts pipeline

qarium · 已有静态检查记录

安装与使用

运行命令前先阅读来源与依赖说明。复制命令不会自动安装或执行。

npx skills add qarium/goga --skill goga-brainstorm-contracts-annotations

技能说明


name: goga-brainstorm-contracts-annotations description: Writing annotations at all levels for a single cell in the brainstorm contracts pipeline

goga-brainstorm-contracts-annotations

Algorithm

Write the implementation instructions for the given cell. Process every annotation target in order — cell header, then each Entity/Routine, then each method/property — and for each one:

  1. Determine the level: global (cell header), type-level (per Entity/Routine), or member-level (per method/property). The level selects the content — see goga-cookbook "When to write annotations". The global level additionally includes the base annotations from goga-codemanifest-base (the contract must comply with their constraints).

  2. Decide what content the annotation needs. Do not invent content — derive it:

    • From [TYPE_DETAIL_REPORT] — responsibility, signature (params and return), methods/properties, interactions.
    • From the usages-inline result — the connected Usages keys; place each on the level where the practice applies.
    • From goga-cookbook ("Why") — the content categories that fit the level.
  3. Write the annotation by goga-cookbook Annotations writing standard (elements, the Algorithm: placement rule), references, and the sufficiency criterion: if not sufficient for implementation, add the missing element (Algorithm: / Requirements: / Constraints:).

  4. Verify against goga-cookbook Annotations — references resolve, no cross-level duplication, no implementation details.