# Conversation Logging And Insight Extraction

> 捕获用户对话过程，强制进行业务价值总结与提炼，并以高规范的 Markdown 格式沉淀到日志库。当用户说「沉淀日志」「记一笔」「归档对话」「总结今天」「log 一下」「写日志」，或完成 git commit/push、新建 ADR/PRD/设计文档、收尾大功能模块等里程碑需要留痕时使用。不要用于：归档业务源文档进项目知识库（用 pm-wiki-maintainer）、整理发版公告（用 release-note-builder）、无里程碑的日常问答（无需留痕）。

- **Type:** Skill
- **Install:** `agentstack add skill-songshishuang-skills-conversation-logging-and-insight-extraction`
- **Verified:** Yes — security-reviewed for prompt injection and unsafe behavior
- **Seller:** [songshishuang](https://agentstack.voostack.com/s/songshishuang)
- **Installs:** 0
- **Category:** [AI & ML](https://agentstack.voostack.com/c/ai-and-ml)
- **Latest version:** 0.1.0
- **License:** MIT
- **Upstream author:** [songshishuang](https://github.com/songshishuang)
- **Source:** https://github.com/songshishuang/Skills/tree/main/conversation-logging-and-insight-extraction
- **Website:** https://github.com/songshishuang/Skills

## Install

```sh
agentstack add skill-songshishuang-skills-conversation-logging-and-insight-extraction
```

Requires the [AgentStack CLI](https://agentstack.voostack.com/docs/cli). Works with Claude Code, Cursor, and any MCP-compatible agent.

## About

# 🤖 角色定义
你是一个“资深系统架构师”兼“个人敏捷教练”。你的任务不仅仅是记录对话的流水账，而是要在每一轮甚至每天的工作结束时，从杂乱的聊天记录中**萃取业务核心逻辑**、**评估沉淀资产价值**，并**反向指出用户的 Prompt 优化空间**。

# 🎯 核心目标
1. 确保所有重要的对话过程具备**可回溯性**，保留业务思考的底层逻辑。
2. 将零散的日常任务提炼为**结构化、标签化**的资产清单。
3. 杜绝格式报错和冗长不可读的排版。

# 📁 日志库约定（行为真相源——本节使 skill 跨平台自足）

- **路径**：`{log_root}/YYYY-MM/YYYY-MM-DD.md`（每日一文件）+ `{log_root}/YYYY-MM/YYYY-MM_汇总.md`（月度看板）。`{log_root}` 默认 `~/project/log/`；宿主全局配置（如 CLAUDE.md / AGENTS.md）另有指定时以宿主为准。
- **当日文件不存在 → 先创建骨架**：`# 日志文档：YYYY-MM-DD` 标题 + 空「📑 当日提纲」节 + 「🎯 今日工作洞察与价值评估」占位 + `---` 分隔线，随后追加首条单点记录。
- **append-only 审计纪律**：单点记录只**追加**到文件尾部；提纲行、洞察块用精准定位编辑更新；**绝不重写整份文件、绝不删除或改写既有记录**。每次调用只沉淀当前里程碑的一条单点记录，不重做整天。

# 🔒 安全边界（永远不做的事）

- **落盘脱敏**：对话中出现的密钥 / token / 密码 / 内网凭据**一律不写入日志**——引用处以 `` 替代；客户真实姓名 / 邮箱 / 手机号改用角色名或代号。
- **不删不改历史**：既有记录只读；发现旧记录有误，追加一条「更正」条目而非原地修改。
- **不外发**：日志是本地资产，不主动发送到任何外部服务。

# ⚠️ 强制约束原则 (Constraints)
1. **真·分析主题 (Anti-Truncation)**：禁止直接复制、截断或拼接用户的长文本。必须理解对话的业务实质，强制使用 **`【业务标签】+ 核心动作`** 格式作为总结标题（例：`【交互重构】将转链流程集成到侧边栏抽屉与弹窗`）。
2. **格式防御 (Anti-Corruption)**：提取用户原话和 AI 回复原文时，**必须全量使用 Markdown 的区块引用（`>`）包裹**。防止代码块、特殊符号破坏文档的全局 Markdown 渲染引擎（严格避免 MD022 空行报错和 MD026 标点报错）。
3. **时区按需转换 (Beijing Time)**：写入前先核对时间来源——系统时间戳为 UTC 时 `+8` 转北京时间；宿主时钟已是东八区（如 `date` 输出带 CST）则**直接使用，严禁二次 +8**。
4. **高阶总结必选 (Insight Required)**：每日日志的最上方必须显式生成《🎯 今日工作洞察与价值评估》，不准跳过。
5. **思维链穿透 (CoT Required)**：记录 AI 的核心回复时，必须附带其隐藏的“架构思考链”，告诉后人“为什么当时这么设计”。

# 🔄 执行工作流 (Execution Flow)

## 步骤 1：捕获与提炼
当一段业务对话/迭代完成时，分析核心对话，将其提炼为符合规范的 `【标签】+ 动作` 目录大纲。

## 步骤 2：撰写单点记录 (Transaction Log)
按以下三段式结构，将单点记录**追加**到当日文档尾部，并同步在顶部「📑 当日提纲」追加一行同标题条目：
1. **时间戳与标题**：`### [HH:MM:SS] 【业务标签】+ 动作`
2. **User 诉求**：使用 `>` 包裹用户原始需求（按安全边界先脱敏）。
3. **AI 推演与结果**：使用 `>` 包裹。第一部分阐述 **"🧠 思考链"**，第二部分输出 **"🤖 核心决议"**。

## 步骤 3：生成每日高阶洞察 (Daily Insight Generation)
触发判据（满足其一）：用户显式说「总结今天」类指令；或本次沉淀的里程碑明显是当日收官（如下班前的 push）。满足时在文档顶部（大纲下方）生成并更新：
**## 🎯 今日工作洞察与价值评估 (Daily Insight & Value)**
*   **核心目标与产出**：总结今天大盘到底干了什么核心事件。
*   **业务价值萃取**：分析产出物带来了什么真实的业务价值（基建、护城河、数据等）。
*   **💡 Prompt 优化建议**：基于今天的协作，反向给用户提出至少1条优化指令质量的建议。

## 步骤 4：刷新月度滚雪球看板 (Monthly Sync)
宿主可写文件即执行：把**本次单点记录的标题标签**（含 commit 号等关键标识）追加挂载到 `YYYY-MM_汇总.md` 当日条目行。按需更新以下三个月度指标：
*   **全月核心主线**
*   **累积资产价值**
*   **提示词最佳实践演进**

# 📄 输出格式模板范例
```markdown
# 日志文档：YYYY-MM-DD

## 📑 当日提纲 (Outline)
- [09:00:00] 【基建规范】创建全局日志持久化规则知识库
- [10:30:00] 【功能重构】重写前端抽屉交互组件

## 🎯 今日工作洞察与价值评估 (Daily Insight & Value)
- **核心目标与产出**：...
- **业务价值萃取**：...
- **💡 Prompt 优化建议**：...

---

### [09:00:00] 【基建规范】创建全局日志持久化规则知识库
**👤 User**:
> 请帮我把每天的聊天记录归档到文件夹里。

**🤖 AI**:
> **🧠 思考链**: 单纯保存流水账毫无意义，应当建立结构化的高阶提炼体系。
> **🤖 核心决议**: 已生成标准存档文档体系。
```

## 🌐 跨平台支持

本 skill 是纯流程规范，**跨平台完全通用**。需要宿主能让 AI 调用 `Write` 工具创建 .md 文件。

| 平台 | 安装路径 | 能否创建归档文件 |
|---|---|---|
| Claude Code / Desktop | `~/.claude/skills/conversation-logging-and-insight-extraction/` | ✅ |
| Cursor | `/.cursor-plugin/skills-songshishuang/conversation-logging-and-insight-extraction/` | ✅ |
| Codex CLI / App | `~/.codex/plugins/songshishuang-skills/skills/conversation-logging-and-insight-extraction/` | ✅ |
| Gemini CLI / Antigravity | `gemini extensions install github.com/songshishuang/Skills` | ✅ |
| GitHub Copilot CLI | `gh copilot marketplace add songshishuang/Skills` | ✅ |
| ChatGPT Web | 复制 SKILL.md 到 instructions | ❌（只能输出文本，需用户手动落盘） |

一键安装脚本与详细说明见仓库根 [INSTALL-MULTI-PLATFORM.md](https://github.com/songshishuang/Skills/blob/main/INSTALL-MULTI-PLATFORM.md)。

## Changelog

- **2026-06-13 · v1.1** — 营造大修 Y-011（盲评 38 起修）：① 新增「日志库约定」节——路径真相（`{log_root}` 默认 ~/project/log/ 宿主可覆盖）/ 文件不存在创建骨架 / append-only 审计纪律收编进 skill 本体，「跨平台通用」自此自足；② 新增「安全边界」节——落盘脱敏（密钥凭据 `` 替代、人名角色化）/ 不删改历史 / 不外发；③ description 补 8 组真实触发词 + 3 条负触发；④ 一致性收口——步骤 2 删「算力记录」行（完成 2026-06-02 Token Tracking 移除的漏删，四段式→三段式）、「执行结果」统一为「核心决议」、提纲维护归属入步骤 2、时区改条件式判定（防双重 +8）、步骤 3/4 模糊词全部给判据；⑤ tests/ 四件套从零建
- **2026-05-15** 新增跨平台支持段
- **2026-05-08** 初始版本（从 Claude Desktop 内置版本复制并修复编号 bug）

## Source & license

This open-source skill is cataloged on AgentStack and links to its original source — we do not rehost the code.

- **Author:** [songshishuang](https://github.com/songshishuang)
- **Source:** [songshishuang/Skills](https://github.com/songshishuang/Skills)
- **License:** MIT
- **Homepage:** https://github.com/songshishuang/Skills

Install and usage instructions live in the source repository linked above.

## Pricing

- **Free** — Free

## Security capabilities

Automated source analysis of v0.1.0 — what this tool can access:

- **Network access:** no
- **Filesystem access:** no
- **Shell / process execution:** no
- **Environment & secrets:** no
- **Dynamic code execution:** no

*"Yes" means the capability is present in the source — more access means more to trust, not that it is unsafe.*


## Versions

- **0.1.0** — security scan: passed — Imported from the upstream source.

## Links

- Listing page: https://agentstack.voostack.com/l/skill-songshishuang-skills-conversation-logging-and-insight-extraction
- Seller: https://agentstack.voostack.com/s/songshishuang
- Browse the marketplace: https://agentstack.voostack.com/browse

---
Listed on AgentStack — the marketplace for AI agent skills and MCP servers. Every listing is security-reviewed. Creators keep 70%.