From 86101357f0b3af3fe6c436e60712a10c7f82f3ce Mon Sep 17 00:00:00 2001
From: root <root@localhost.localdomain>
Date: Thu, 2 Apr 2026 11:10:03 +0800
Subject: [PATCH] refine reader digest and ima deposition rules

---
 reader-digest-flow/SKILL.md                   | 15 ++++++--
 .../references/ima-markdown-example.md        | 34 +++++++++++++++++++
 2 files changed, 46 insertions(+), 3 deletions(-)
 create mode 100644 reader-digest-flow/references/ima-markdown-example.md

diff --git a/reader-digest-flow/SKILL.md b/reader-digest-flow/SKILL.md
index 6b3e471..edf16c0 100644
--- a/reader-digest-flow/SKILL.md
+++ b/reader-digest-flow/SKILL.md
@@ -20,8 +20,8 @@ Run the reader-based daily digest as a fixed SOP. Treat this skill as the orches
 - **Do not upload the full daily digest to IMA.**
 - **Do not upload any selected article summary to IMA until the user has explicitly confirmed the selection.**
 - Upload **only user-selected articles** to IMA as individual knowledge notes.
-- **The formal IMA upload object must be the generated single-article summary content (Markdown note / note content), not the original article webpage URL.**
-- **Importing original article URLs into IMA can be used only as temporary source collection, and does not count as completing the daily summary deposition flow.**
+- **The formal IMA upload object must be the generated single-article summary content, uploaded directly into the target knowledge base as a Markdown knowledge item (`media_type=7`), not the original article webpage URL.**
+- **Do not use webpage URL import or note-then-link (`media_type=11`) as the default daily deposition path. Importing original article URLs into IMA can be used only as temporary source collection, and does not count as completing the daily summary deposition flow.**
 - Default IMA target for daily single-article summaries is the `daily` knowledge base.
 - Resolve that default target from reader `.env` (`IMA_DAILY_KNOWLEDGE_BASE_ID`, `IMA_DAILY_KNOWLEDGE_BASE_NAME`) and verify it at runtime before upload.
 - If the configured daily knowledge base is missing, try to locate it by name; if still missing, create `daily` and continue.
@@ -176,13 +176,15 @@ Completion criteria for this phase:
 
 - a selected article has been summarized from extracted content
 - a single-article Markdown summary file has been generated
-- the object uploaded into IMA is the summary content / note content derived from that Markdown
+- the Markdown file is uploaded directly into the target knowledge base as a Markdown knowledge item (`media_type=7`)
+- the uploaded object preserves source link context and uses IMA-friendly layout for readability
 - the upload target is the `daily` knowledge base unless the user explicitly requests otherwise
 
 Do not treat the following as completion of summary deposition:
 
 - importing the original article webpage URL into IMA
 - storing the original article only as source material without the generated summary content
+- creating a note first and then linking that note into the knowledge base as the default path
 
 Do not upload:
 
@@ -190,6 +192,13 @@ Do not upload:
 - raw payloads
 - raw extraction output
 
+IMA Markdown layout guidance for selected article deposition:
+
+- Prefer direct Markdown file upload into the knowledge base (`media_type=7`).
+- Remove stiff metadata headers such as `Source:` / `Category:` when preparing the IMA-facing Markdown.
+- Keep source traceability by placing `原文链接：` near the top, followed by the original URL on the next line.
+- Break long prose under `核心结论` and `主要论点` into short paragraphs for IMA readability instead of relying on platform auto-formatting.
+
 ## Operational Guidance
 
 - Prefer real run outputs over examples.
diff --git a/reader-digest-flow/references/ima-markdown-example.md b/reader-digest-flow/references/ima-markdown-example.md
new file mode 100644
index 0000000..c6c06fd
--- /dev/null
+++ b/reader-digest-flow/references/ima-markdown-example.md
@@ -0,0 +1,34 @@
+# 示例文章标题
+
+原文链接：
+https://example.com/article
+
+## 核心结论
+
+这里先用一段短句概括最重要的判断。
+
+如果结论较长，继续拆成第二个短段，而不是塞成一个大长段。
+
+## 主要论点
+
+先交代文章的核心主张。
+
+再单独起一段解释支撑这个主张的关键论据。
+
+如果还有补充判断，继续拆段，保证在 IMA 中阅读时不会挤成一整坨。
+
+## 关键方法 / 机制
+
+- 要点一
+- 要点二
+- 要点三
+
+## 重要细节
+
+- 细节一
+- 细节二
+
+## 可复用启发
+
+- 启发一
+- 启发二