email-formatting

分类: 文档与知识管理 | 上传者: provos | 下载: 0 | 版本: v1.0（最新）

电子邮件摘要文档的 Markdown 格式约定 - 标题深度、列表样式、行长度、表情符号策略和强制性出处页脚。在生成总结一封或多封电子邮件的 Markdown 报告时阅读此内容，以便输出与项目的内部风格相匹配。

更新日志: Source: GitHub https://github.com/provos/ironcurtain

目录结构

当前层级: tree/master/src/workflow/workflows/test-email-summary/skills/email-formatting/

📄 SKILL.md 2.0 KB

SKILL.md

---
name: email-formatting
description: Markdown formatting conventions for email summary documents — heading depth, list style, line length, emoji policy, and a mandatory provenance footer. Read this when producing a markdown report that summarizes one or more email messages so the output matches the project's house style.
---

# Email formatting conventions

Use these conventions whenever you write a markdown file that summarizes
email content.

## Heading depth

- The document has exactly one `#` heading at the top: the report title.
- Each individual email gets a `##` heading whose text is the email subject.
- Do not use `###` or deeper for per-email metadata; use a bullet list instead.

## Per-email metadata

For each email, render metadata as an unordered list immediately under the
`##` subject heading, in this order:

- `From: <sender>`
- `To: <recipient(s), comma-separated>`
- `Date: <as it appears in the source, no reformatting>`
- `Summary: <1-2 sentences in prose>`

## Line length and whitespace

- Soft-wrap at roughly 80 columns. Don't hard-break inside a sentence.
- Exactly one blank line between sections; never two or more.
- No trailing whitespace at end of lines.

## Emoji policy

Do not use emoji in summary documents. They render inconsistently across
mail clients that may consume the markdown downstream.

## Preamble and outro

There is no preamble (no "Here is the summary..." opener) and no outro
(no "Let me know if..." closer). The document opens with the `#` title.

## Provenance footer (required)

The document MUST end with the literal HTML comment marker on a line by
itself, separated from the last email's `Summary:` bullet by exactly one
blank line:

    <!-- email-summary/v1 -->

This marker is how downstream tooling identifies the generator and
schema version. Producers that omit it are non-compliant; producers
that change the spelling, casing, or version segment break parsers
that depend on the literal string. Do not localize, prettify, or
expand the marker — it is a machine-readable token, not human prose.

登录后下载/点赞/收藏 ❤ 381 | ★ 0

email-formatting

目录结构

SKILL.md

举报内容

提示