Skip to content

feat: 添加文章深度解读技能#12

Merged
YeatsLiao merged 6 commits into
trae-community:mainfrom
kingzeus:main
Mar 9, 2026
Merged

feat: 添加文章深度解读技能#12
YeatsLiao merged 6 commits into
trae-community:mainfrom
kingzeus:main

Conversation

@kingzeus

@kingzeus kingzeus commented Mar 7, 2026

Copy link
Copy Markdown
Contributor

name: kz-article-deep-analysis
description: 深度解读非学术类文章(博客、随笔、评论),抽取核心议题与核心主张,评估其对读者认知的增量与张力,输出结构化分析报告。

版本: v1.0.2
作者: K叔
用途: 深度挖掘文章的核心逻辑与认知价值
适用范围: 博客、公众号文章、随笔、评论(不适用于学术论文或书籍)

Copilot AI left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Pull request overview

This PR adds two new TRAE agent skills: kz-article-deep-analysis (the primary skill described in the PR title) for deep-reading non-academic articles, and kz-doc-coauthoring for structured document co-authoring. Both follow the author's custom skill structure with Chinese-language annotations and verification scripts.

Changes:

  • Adds skills/kz-article-deep-analysis/SKILL.md, references/methodology.md, assets/template.md, and scripts/verify.py — a complete skill for deeply analyzing blog posts and essays
  • Adds skills/kz-doc-coauthoring/SKILL.md and scripts/verify.py — a document co-authoring workflow skill with intent routing and structured writing stages

Reviewed changes

Copilot reviewed 6 out of 6 changed files in this pull request and generated 5 comments.

Show a summary per file
File Description
skills/kz-article-deep-analysis/SKILL.md Core SKILL.md for the article deep analysis skill with YAML frontmatter, 4-step workflow, and version history
skills/kz-article-deep-analysis/references/methodology.md Reference document explaining the analysis methodology (topic extraction, cognitive tension, transfer)
skills/kz-article-deep-analysis/assets/template.md Output report template with placeholder sections for the analysis
skills/kz-article-deep-analysis/scripts/verify.py Verification script checking SKILL.md structure and required companion files
skills/kz-doc-coauthoring/SKILL.md Core SKILL.md for the document co-authoring skill with intent routing, 6-step workflow, and version history
skills/kz-doc-coauthoring/scripts/verify.py Verification script with detailed structural checks specific to the co-authoring workflow

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

Comment thread skills/kz-doc-coauthoring/SKILL.md Outdated
Comment thread skills/kz-article-deep-analysis/SKILL.md
Comment thread skills/kz-article-deep-analysis/SKILL.md
Comment thread skills/kz-doc-coauthoring/scripts/verify.py Outdated
Comment thread skills/kz-article-deep-analysis/scripts/verify.py

@MasamiYui MasamiYui left a comment

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Please optimize the skill descriptions and update the README.md file.

@YeatsLiao

Copy link
Copy Markdown
Member

Please update the README.md

@kingzeus

kingzeus commented Mar 7, 2026

Copy link
Copy Markdown
Contributor Author

PR 提交说明:新增 Skill kz-article-deep-analysis

背景

非学术类文章(博客、随笔、评论)的阅读场景里,用户往往需要的不只是摘要,而是:

  • 抽取作者真正试图回应的核心议题与中心命题
  • 梳理论证路径与隐含假设
  • 评估文章对读者的认知增量与张力,并沉淀可复用洞见

本 PR 引入一个“小而专、易验证”的 Skill:kz-article-deep-analysis,用于生成结构化的深度解读报告。

变更内容

1) 新增 Skill:skills/kz-article-deep-analysis/

  • SKILL.md
    • 包含 YAML frontmatter(name / description / version
    • 定义主工作流:获取与预处理 → 深度解构 → 认知增量 → 生成报告
    • 引用目录内文件使用相对路径(references/methodology.mdassets/template.md
  • references/methodology.md
    • 核心议题抽取方法论(看反对 / 看重复 / 看情绪)
    • 认知张力评估(强化 / 补充 / 冲突)
    • 迁移判断标准(同构 + 可操作 + 脱离上下文仍成立)
  • assets/template.md
    • 固定 Markdown 报告模板(核心议题、核心主张、论证骨架、ASCII 推理拓扑、认知卡片、迁移)
  • scripts/verify.py
    • 确定性结构校验脚本(用于 PR 自检与快速回归)

2) 更新 Skills catalog

  • README.md:在 Skills catalog 表格中新增 kz-article-deep-analysis 条目
  • README.zh-CN.md:在“技能目录”表格中新增 kz-article-deep-analysis 条目

使用场景

  • 用户提供文章 URL 或正文,要求“深度解读/拆解/解构/认知增量/迁移”类输出
  • 输出为结构化 Markdown 报告,便于复用、对照与评审

合规性自检(对齐 CONTRIBUTING.md)

  • 语言说明(为什么 Skill 使用中文)

    • 本 Skill 的目标用户与主要使用场景是中文内容的深度阅读(公众号/中文博客/中文评论等),核心产物(核心议题、论证拓扑、认知卡片)需要紧贴中文语义与修辞语境。
    • 若强制英文指令与英文产出,容易引入二次翻译偏差,导致“核心议题”与“认知张力”的判断不稳定,影响可复用性与可验证性。
    • 仓库层面仍保留英文 README.md 的目录条目,方便发现;后续如需面向英文内容,可在不改变本 Skill 定位的前提下补充英文版本或拆分新 Skill。
  • 技能目录名与 frontmatter name 一致:kz-article-deep-analysis

  • 命名风格为 lowercase-hyphenated

  • SKILL.md 存在且包含 name/description/version

  • 至少包含 1 个使用示例(见本提交说明“使用场景”,亦可在后续 PR 补充更完整 I/O 示例文件)

  • 引用目录内文件使用相对路径链接

  • 不包含敏感信息(密钥、Token、内网地址、客户数据等)

  • 输出偏结构化与可复用(模板化 Markdown、固定章节)

  • 已更新 README.zh-CN.md 的技能目录(并同步更新英文 README.md

  • 提交前在 Trae 客户端加载并验证该 Skill(建议附运行截图)

@YeatsLiao YeatsLiao left a comment

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

good SKILL :) Thank you for your submission.

@YeatsLiao
YeatsLiao merged commit 753fddb into trae-community:main Mar 9, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

4 participants