Community研究與資料分析github.com

Lucian1u/material-to-deliverable

把散乱资料,沉淀成自己的知识资产。将真实材料整理成可复用的文稿、摘要和来源索引。

material-to-deliverable 是什麼?

material-to-deliverable is a Claude Code agent skill that 把散乱资料,沉淀成自己的知识资产。将真实材料整理成可复用的文稿、摘要和来源索引。.

相容平台~Claude Code~Codex CLI~Cursor
npx skills add Lucian1u/material-to-deliverable

Installed? Explore more 研究與資料分析 skills: obra/superpowers, affaan-m/quarkus-verification, affaan-m/uspto-database · View all 6 →

在你喜歡的 AI 中提問

開啟一個已預先載入此 Agent Skill 的新對話。

說明文件

Material to Deliverable

00_input/ 中的真实资料整理成可检查、可追溯、可交付的文字文件。

启动条件

仅在同时满足以下条件时执行。

  • 用户提供或指定了本地项目目录。
  • 00_input/ 中至少有一份真实材料。
  • 用户希望得到汇报、方案、复盘、调研或课程展示之一。

目录不明确时,只问项目目录。交付类型不明确时,只问交付类型。没有真实材料时停止,不生成示例或替代材料。

每次都要读取

开始处理前完整读取:

确认交付类型以后,再读取 交付类型规则 中对应的一节。

工作流程

1. 确认项目与初始化

项目尚未初始化时,从本 Skill 的安装目录调用脚本,并传入明确的项目路径:

python3 <skill-directory>/scripts/init_project.py /absolute/path/to/project

不要假设用户项目当前目录中存在 scripts/。先根据本文件位置解析 <skill-directory>,再执行脚本。

如果 01_working/ 已存在,读取已有状态并继续,不重新初始化,不覆盖文件。

2. 检查输入与敏感信息

列出 00_input/ 中全部文件,记录无法读取或来源不明的文件。不要修改、移动或重命名原始材料。

先做敏感信息检查。发现姓名、个人联系方式、账号、客户资料、合同、财务、健康、教育记录、凭证、内部路径或其他可能受限的信息时:

  1. 只在 02_material-index.md 记录风险类型与文件位置,不复制敏感值。
  2. 立即暂停。
  3. 请用户确认其有权处理这些材料,或请用户提供脱敏副本。

未经用户确认,不继续提纲、写作和交付。

3. 澄清任务

每次只问一个会改变成品的问题,最多七个。优先确认接收者、使用场景、希望促成的决定、截止时间、交付类型、必须保留和禁止出现的内容。

用户回答“不知道”时,写入待确认事项,不替用户补答案。将结果写入 01_task-brief.md,展示摘要,等待用户确认。

4. 建立材料索引与缺口

逐份材料填写 02_material-index.md,分清:

  • 来源能够直接支持的事实
  • 当事人或机构自述
  • 访谈、反馈或局部观察
  • 用户本人判断
  • 待确认信息

将冲突、缺失、无法读取、需要脱敏和证据不足的内容写入 03_gaps-and-conflicts.md。少量材料不能扩大为普遍结论。

阻断性缺口仍存在时继续提问或停止,不生成主成品。

5. 创建带来源提纲

根据交付类型创建 04_source-backed-outline.md。每个部分必须写清要回答的问题、使用的材料、允许得出的结论、用户判断、待确认项和验收方式。

展示提纲摘要与来源覆盖情况,等待用户确认。未确认前不写主成品。

6. 生成成品与来源索引

根据确认后的提纲生成:

  • 05_main-deliverable.md
  • 06_one-page-summary.md
  • 07_source-index.md

每个关键事实都要在来源索引中对应到具体文件和位置。不得补写材料中没有的数字、人物、案例、引语或结果。个人判断必须与来源事实分开。

7. 回到原始材料审核

重新读取 00_input/,不要只根据刚生成的成品自我检查。将事实、范围、逻辑、隐私、任务一致性和表达问题写入 08_audit-report.md

只修改能够由现有材料明确修复的问题。需要用户判断的内容保持待确认。

8. 整理交付包

只有审核中没有阻断问题时,才把通过审核的内容写入:

02_delivery/
  main-deliverable.md
  one-page-summary.md
  source-index.md
  readme.md

02_delivery/ 不得包含原始材料、提示词、聊天记录、内部草稿或敏感值。最后仍从本 Skill 的安装目录运行:

python3 <skill-directory>/scripts/validate_project.py /absolute/path/to/project --stage delivery

验证脚本通过后,仍要提醒用户做最终人工放行。脚本只检查文件结构与明显残留,不能证明事实正确。

停止条件

遇到以下任一情况就停止,并说明缺少什么。

  • 00_input/ 为空或材料无法读取。
  • 用户未确认敏感材料可以继续处理。
  • 接收者、交付类型或核心目标仍不明确。
  • 当前材料无法支持主结论。
  • 用户尚未确认任务单或提纲。

不要用虚构材料、联网搜索或常识推断绕过停止条件,除非用户另行明确授权新的资料来源。

输出语言

默认跟随用户当前使用的语言。文件名保持英文,便于跨环境使用;文件内容使用用户语言。

相關技能