From e24db99baa78b2b18cfc3b53fe0ce91a7e0ba3f6 Mon Sep 17 00:00:00 2001
From: zhuyongxin <zhuyongxin@aspirecn.com>
Date: Mon, 30 Mar 2026 17:04:24 +0800
Subject: [PATCH] Add plan for article-deep-summary skill

---
 plans/article-deep-summary-skill.md | 47 +++++++++++++++++++++++++++++
 1 file changed, 47 insertions(+)
 create mode 100644 plans/article-deep-summary-skill.md

diff --git a/plans/article-deep-summary-skill.md b/plans/article-deep-summary-skill.md
new file mode 100644
index 0000000..161e246
--- /dev/null
+++ b/plans/article-deep-summary-skill.md
@@ -0,0 +1,47 @@
+# Plan: article-deep-summary Skill
+
+## 背景
+
+项目已有两个 skill：
+- `keyword-cleanup-review`：关键词索引清理与建议
+- `llm-summary-review`：验证/修复 LLM 生成的日报摘要 JSON
+
+两者均不覆盖「从单篇文章完整正文生成深度知识笔记」这一场景，需新增 `article-deep-summary` skill。
+
+## 目标
+
+封装 `summary_mcp.workflows.article_summary` 的使用方式，让 Claude 在用户需要对单篇文章做深度精读总结时，能正确触发并执行该 workflow。
+
+## 三个 skill 的分工
+
+| Skill | 触发时机 | 处理对象 |
+|-------|---------|----------|
+| keyword-cleanup-review | 审查/清理关键词索引 | term_stats.json + daily 文件 |
+| llm-summary-review | 已有摘要 JSON，需验证或修复 | outputs/result.json |
+| article-deep-summary | 有提取文件，想生成深度知识笔记 | *.extracted.json 的 plain_text |
+
+## 核心入口
+
+python -m summary_mcp.workflows.article_summary \
+  --extracted outputs/freshrss/<run_id>/extracted/selected.extracted.json \
+  --selected-ids <item_id> \
+  --output-dir outputs/article-summaries/
+
+## 关键代码路径
+
+- Workflow：src/summary_mcp/workflows/article_summary.py
+- Validator：src/summary_mcp/validators/article_summary.py
+- 数据模型：src/summary_mcp/models/article_summary_result.py
+- Prompt：outputs/prompts/article-summary-prompt.txt
+
+## Skill 文件结构（待创建）
+
+skills/article-deep-summary/
+  SKILL.md
+  agents/openai.yaml
+
+## 待办
+
+- [ ] 创建 skills/article-deep-summary/SKILL.md
+- [ ] 创建 skills/article-deep-summary/agents/openai.yaml
+- [ ] 用实际 extracted 文件跑一次验证输出