SuperAPI AI 工具集

communication-analysis

写作与研究

查看项目

更新于 10-16 04:57

技能介绍

用途:该技能只做一件事,接收一个 markdown 源文件,在其旁生成完整的沟通分析报告,适合“读一个 markdown 文件,指出弱点、过度使用的表达、优点及改进方向”的任务。不适用于文件夹,目录级处理由编排器负责。

主要能力:通过 scripts/analyze_file.py 执行分析,输出 analysis/<同名>.md 与 analysis/<同名>.json 两个文件;markdown 报告包含快照、执行诊断、最高杠杆差距、词汇压力点、句子升级实验室、反例与优势、练习系统、每日激活循环、证据附录等部分。JSON 产物是供其他技能使用的结构化契约,不可跳过。报告需证据绑定,每个主要发现要引用支撑片段。

使用方式:仅接受 markdown 输入,可选 YAML frontmatter 键包括 analysis_mode、title、date、tags、context、language;若缺少 frontmatter,脚本会推断转写稿模式或笔记模式。运行时位于 scripts/communication_runtime/,确定性分析总会执行;若存在 OPENAI_API_KEY 且 COMMUNICATION_SKILL_ENABLE_LLM 不为 0,脚本会加入更精细的措辞和教练建议。仅需精确输出契约时,可阅读 references/report-contract.md。

适用场景:针对单份沟通转写稿的教练式复盘与改进建议,包括用词习惯、清晰度、说服力和重复模式等。

限制:仅基于转写稿的分析只能推断措辞习惯,无法推断语调或声音音色;应偏好实用教练建议而非抽象人格评判。若被要求改进该技能本身,应先在真实目标文件上运行脚本,检查生成的 markdown 和 JSON,找出输出质量问题,再收紧运行时或技能描述并重跑。