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/ 中全部文件,记录无法读取或来源不明的文件。不要修改、移动或重命名原始材料。
先做敏感信息检查。发现姓名、个人联系方式、账号、客户资料、合同、财务、健康、教育记录、凭证、内部路径或其他可能受限的信息时:
- 只在
02_material-index.md记录风险类型与文件位置,不复制敏感值。 - 立即暂停。
- 请用户确认其有权处理这些材料,或请用户提供脱敏副本。
未经用户确认,不继续提纲、写作和交付。
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.md06_one-page-summary.md07_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/为空或材料无法读取。- 用户未确认敏感材料可以继续处理。
- 接收者、交付类型或核心目标仍不明确。
- 当前材料无法支持主结论。
- 用户尚未确认任务单或提纲。
不要用虚构材料、联网搜索或常识推断绕过停止条件,除非用户另行明确授权新的资料来源。
输出语言
默认跟随用户当前使用的语言。文件名保持英文,便于跨环境使用;文件内容使用用户语言。