SuperAPI AI 工具集

chalk

通用与其它

查看项目

更新于 10-16 06:21

技能介绍

用途:chalk 用于把一次工作会话对应到某个 GitHub Issue 上进行跟踪,并把该 Issue 描述作为事实来源,评论作为追加式会话日志,记录尝试过什么、做了什么决定、学到了什么。主要能力:维护 Issue 描述中的 ## Progress 区块(含工作项清单、Status 行、Open Questions),并创建和更新每会话一条的评论;评论采用 chalk voice,含检查清单与 details 详情块;通过父子、blocked-by 等 Issue 关系补充描述无法表达的结构。

使用方式:命令包括 chalk #N(跟踪会话对应 Issue N)、chalk new(新建 Issue 并跟踪)、chalk status(报告 Issue 编号与当前进度摘要)、chalk off(通过 agent 定稿当前评论并停止跟踪)。开始前需加载 chalk:voice、chalk:mindmap 等技能;描述与 PR 描述分别由 chalk:issue 和 chalk:pr 负责。所有 GitHub 交互都必须经 agent(Task(subagent_type="chalk:github"))执行,主对话不得直接调用 gh issue 或 gh api;写入调用在后台执行,读取调用需等待结果。

适用场景:适合需要跨会话、跨人或跨 agent 接续的 GitHub Issue 开发工作,尤其是希望留下决策、死路和未验证假设记录的任务。每次会话仅一条评论,工作开始时创建,随进展频繁更新而不必先询问;完成项须真实验证后才勾选。

限制:chalk 不得在未获明确许可时编辑他人撰写的评论;不修改 ## Progress 之外的描述内容;精简评论块属于判断,需由主上下文决定并明确声明。若激活前用户仅在普通对话中提及 Issue 编号,只能简短询问是否跟踪,不得在显式调用前读取 Issue。