SuperAPI AI 工具集
合作ENAI 行业资讯收藏
Skill 广场context-add

context-add

部署与运维

查看项目

更新于 10-23 23:07

技能介绍

用途

context-add 是一个引导式向导技能，目标是把组织内部的 Snowflake/Cortex 标准捕获到版本化的上下文文件中，路径为 .cocoplus/context/<category>.md。这些文件属于治理产物，会被 CocoScout 在相关任务中加载使用。

主要能力

  • 提供六类标准菜单供选择：
    • approved-models：哪些 Cortex 模型被批准使用
    • quality-thresholds：最低准确率与性能标准
    • pii-policy：AI 函数的 PII 处理规则
    • warehouse-policy：不同查询类型使用哪些仓库
    • naming-conventions：Snowflake 对象的命名标准
    • governance-gates：生产部署前所需的审批步骤
  • 将选择映射到对应文件名，如 1 → approved-models.md，2 → quality-thresholds.md，3 → pii-policy.md，4 → warehouse-policy.md，5 → naming-conventions.md，6 → governance-gates.md。
  • 若目标文件已存在，会读取并展示内容，然后询问是更新（增改条目）还是完全替换。
  • 通过多轮对话收集标准，每个类别提出 5–10 个针对性问题，并根据先前回答动态调整。
  • 将回答编译为结构化 Markdown，按主题使用清晰标题，追求简洁可执行的条目。
  • 强制行数限制：编译内容若超过 200 行，会提示优先排序或总结，迭代直到不超过 200 行。
  • 写入文件并创建 git 提交，提交信息格式为 feat(context): <category> standards captured。

使用方式

  1. 预检：检查 .cocoplus/ 是否存在。若不存在，输出“CocoPlus not initialized in this directory. Run $pod init to begin.”并停止。
  2. 展示类别菜单，等待开发者选择数字 1–6。
  3. 检查已有内容：若 .cocoplus/context/<category>.md 已存在，读取并展示，询问更新还是替换，等待回应后再继续。
  4. 通过对话收集标准：针对所选类别提出 5–10 个问题，示例问题包括：
    • approved-models：哪些 Cortex 模型被批准用于生产分类任务？哪些用于提取/NER？是否有明确禁止的模型及原因？未指定时的默认模型？成本或延迟约束？
    • quality-thresholds：生产所需的最低分类准确率？AI 函数调用的最大可接受 p95 延迟？提升模型前的最小评估数据集大小？提取任务所需的精确率/召回率下限？
    • pii-policy：Snowflake 环境中哪些列被归类为 PII？AI 函数是否允许直接处理 PII 列，还是必须先脱敏？要求哪种脱敏方式（如动态数据脱敏、列级安全）？包含 PII 的 AI 函数结果是否允许写入非 PII 表？
    • warehouse-policy：哪些仓库被批准用于 AI/Cortex 函数执行？哪些仓库仅保留用于报表？开发/预发与生产运行的最大仓库规模？大型仓库使用是否有时间限制？
    • naming-conventions：Cortex UDF 名称的前缀/后缀约定（如 udf_、_ai）？评估表的命名约定？AI/ML 对象所需的 schema 名称？大小写约定：UPPER_SNAKE、lower_snake 还是 CamelCase？
    • governance-gates：将模型提升到生产前需要哪些门禁（如数据管家签字、CDO 审查）？生产 AI 函数是否强制要求 SecondEye 评审？每个门禁需要哪些干系人？通过门禁前必须存在哪些文档？
  5. 编译与校验：将回答编译为结构化 Markdown，统计行数，若超过 200 行则要求优先排序或总结，迭代至不超过 200 行。
  6. 写入与提交：若 .cocoplus/context/ 目录不存在则创建，写入编译内容，然后执行：
    git add .cocoplus/context/<category>.md
git commit -m "feat(context): <category> standards captured"
    若 git 提交失败，仍写入文件，但输出提示手动提交的命令。
  7. 输出确认：显示文件路径、行数以及提交信息。

适用场景

  • 团队需要将 Snowflake/Cortex 相关的组织标准（模型审批、质量阈值、PII 策略、仓库策略、命名规范、治理门禁）固化为版本化上下文文件。
  • 希望这些标准能被 CocoScout 在涉及相应类别的任务中自动加载和使用。
  • 需要审计追踪，因为上下文文件被视为治理产物，要求有版本历史。

限制

  • 运行前必须已初始化 CocoPlus（存在 .cocoplus/ 目录），否则会停止并提示运行 $pod init。
  • 编译后的上下文文件不得超过 200 行，超过会要求优先排序或总结。
  • 必须创建 git 提交；若提交失败，文件仍会写入，但需手动提交。
  • 问题数量为每类别 5–10 个，采用多轮对话而非一次性表单。
  • 关于收费、价格、平台支持范围等具体信息，资料中暂未提供。