关于 cawplan-internal-qa-coding-humaninputs
这是用于按 CawPlan 分类体系标注单条人工输入的 QA 技能。它依据输入及可选的助手上下文进行推理,无需调用 API 或进行 CawPlan 身份验证。
主要功能
- 01分类单条人工输入
- 02应用分类与主题体系
- 03按需使用整理后的助手上下文
- 04返回有序分类及一个主题
- 05提供理由与置信度
适用场景
- 01手动核验人工输入分类
- 02检查消息所选的类别与主题
- 03评估分类规则是否适用于某条输入
安装
复制下面的命令,在终端中运行。
$
npx skills add https:/ / github.com/ cawcut/ skill-cawplan --skill cawplan-internal-qa-coding-humaninputs安装后在 Claude Code 中输入/cawplan-internal-qa-coding-humaninputs确认已加载。
包含的文件
除 SKILL.md 外,安装时一起下载的参考资料和脚本。
references/CATEGORY_TAXONOMY.mdPRODUCTION_CLASSIFY_PROMPT.mdTOPIC_TAXONOMY.mdscripts/sync-classify-prompt-from-core-product.mjs详细介绍
CawPlan 内部 QA — 对一条人工输入进行分类
任务
给定一段 content(必填),以及可选的配对内容 assistant_message(本轮 AI 回复)和 prev_message(紧邻的上一条助手回复的最后一段——不是上一轮人工输入),使用 references/CATEGORY_TAXONOMY.md 和 references/TOPIC_TAXONOMY.md 进行分类。此操作不会调用任何 CawPlan API,也无需 cawplan 身份验证——它是根据 uid.core-product 当前分类规则进行的纯推理检查,而非查询。
工作流
- 如果本次会话中还没有阅读过,请阅读
references/CATEGORY_TAXONOMY.md、references/TOPIC_TAXONOMY.md和references/PRODUCTION_CLASSIFY_PROMPT.md(完整生产快照)。如果整理后的文档与快照不一致,以快照为准。 new_feature是最后的选择。 当多个主题都有合理依据时,不要选择它——优先选择具体主题(任何关于内容如何呈现的事项,包括新增节点/面板/屏幕且需求关注其显示内容时,选design_ui;需要接线或外部系统必须携带某个字段时,选integration_api;以及security、infra、refactor、bug、investigation)。新增屏幕或新增字段本身并不意味着主题是new_feature。- 按生产环境的方式预处理
assistant_message,然后再阅读——不要基于未经截断的原始文本进行判断:- 将字面量
\n/\t转义符和换行符规范化为空白字符。 - 去掉
[REDACTED]占位符(上传时的脱敏内容——真实的方括号文本,如[Done]/[QA Testing],必须保留)。 - 去掉每个段落中的 Markdown 噪声(表格分隔线、
---水平线、标题/粗体标记、表情符号)。 - 按空行拆分段落;仅保留前 3 个段落。
- 用
\n\n连接这些段落,然后限制为约 1200 个字符(如果更长,从开头截断并加上...)——这与ClassifyAssistantSnippet/AISessionClassifyAssistantMaxRunes的处理方式一致。
- 将字面量
- 如果提供了
prev_message,请进行预处理(采用第 2 步中的段落拆分和逐段清理方式,但只取最后一个段落;限制为约 500 个字符)——这与ClassifyPrevAssistantTail/AISessionClassifyPrevMaxRunes的处理方式一致。省略时,将prev视为空;若没有它,简短的后续消息(如“commit & push”“直接改”)可能会有歧义。 - 严格按照生产环境的方式路由类别(参见
CATEGORY_TAXONOMY.md):- 首要信号:
content。 始终先阅读它。 prev: 仅用于区分简短、直接的后续消息(通常不超过 12 个汉字或 6 个英文单词)属于decision(用户提及或重复了助手提出的具体操作),还是approval(笼统的许可,如“直接改”“可以”“do it”)。对于任何其他类别都不得使用prev;也不得将其视为用户先前提出的要求。assistant_message: 仅当content是不带意图词的纯交接内容(URL、文件路径、截图路径、日志路径)时,才用于判断类别。不得根据助手已经执行或验证的内容推断类别。
- 首要信号:
- 根据分类法确定所有明显适用的类别,然后按照参考文档中的优先级顺序排序(从高到低)。使用准确的 snake_case 叶节点名称(如
direction_constraint、rejection_rollback、question_clarification、other_meta等——不得使用direction/rejection/question/other等简写形式)。不要为了填满列表而凭空添加次要类别。若仅有一个适用类别,列表中就只放一个元素。 - 排序后列表中的第一个元素是主要类别。
- 根据
content和经过预处理的assistant_message,从TOPIC_TAXONOMY.md中恰好选择一个主题——绝不可使用prev_message判断主题。遵循 ASKING 与 CHANGING 的区分、将纯粹的commit & push归为git_ops,以及参考文档中有关 Slack 的提示。 - 撰写一句简短的
topic_reason,并按照TOPIC_TAXONOMY.md的要求设置topic_confidence(0.0–1.0),与生产环境保持一致。
输出
报告:
category— 主要类别(categories的第一个元素)。categories— 按优先级排序的完整列表(可以只有一个值)。topic—TOPIC_TAXONOMY.md中 17 个主题之一,且只能有一个值。topic_reason— 用一个简短句子解释主题选择。topic_confidence— 0.0–1.0 之间的浮点数(表示对主题选择的把握程度)。- 用一个简短句子解释主要类别的选择,并引用
content、prev_message或准备好的assistant_message中促成该判断的具体短语——这样,当调用方对此有异议(例如与已持久化的云类别不一致)时,可以进行审核,而不是面对一个不透明的结果。
参考资料
references/PRODUCTION_CLASSIFY_PROMPT.md— 从 uid.core-product 导出的完整提示词references/CATEGORY_TAXONOMY.md— 精心整理的类别路由规则与示例references/TOPIC_TAXONOMY.md— 精心整理的主题路由规则与示例
提示词发布后的同步快照:
node skills/cawplan-internal-qa-coding-humaninputs/scripts/sync-classify-prompt-from-core-product.mjs
评论
支持 Markdown