Time Investment Report Agent Skill — Productivity skill for Claude Code

时间投资评估报告 · Time Investment Report — an Agent Skill

[English](README.en.md) ｜ 中文 ｜ [About this skill](ABOUT.md)

把「要不要投入时间」从一个感觉问题，变成一笔可核验的账。

**这是一个 Agent Skill（给 AI Agent 用的技能包），不是代码库、不是 App。** 把它整个目录放进 agent 的 skills 目录，agent 就会在你说「我在犹豫要不要……」时 自动加载它，产出一份报告。没有服务器、没有构建步骤、不需要 API key。

一门课 95 小时、一部长剧 70 小时、一本书 576 页——这些**高度不可逆**的时间投入， 大多数人靠「豆瓣评分 8.8」或朋友一句话就做了决定。

但 8.8 分既没告诉你前 7 季是稳定高质量，也没告诉你终季会跌到 6.4。 **平均分把最重要的信息压平了。**

这个 skill 提供一套七格方法，在下单 / 开追 / 开读之前，先把时间的**结构账**算清楚。

---

它做什么，不做什么

✅ 做	❌ 不做
算清总时长与按你节奏的完成日期	不打分、不评级、不写「推荐 / 不推荐」
按时间轴拆开结构，标出各段占比	不替你做决定
定位密度异常点：铺垫段、崩塌点、注水段	不给「值不值得」的总结性判断
判定时效折损（更新距今多久、缺了什么）	不为了凑满七格而编数据
找更短的替代来源（尤其作者本人的压缩版）	—
给出三个选项：全量 / 取核心段 / 放弃	绝不省略「放弃」选项

**核心理念**：用户会反驳一个评分，但不会反驳一条可核验的事实。 所以这里输出的永远是「第 68 集起评分跌破 6.0」，而不是「这部剧不值得看」。

---

三条铁律

1. 绝不给「值不值得」打分。 品味无法被代理。
2. 永远保留第三个「放弃」选项。 一份每次都推荐「看」的报告就是软文。
3. 每一格都标置信度。 一次被抓到编数据，信任归零且不可恢复。

---

快速开始

安装（作为 Agent Skill）

它是一个**文件夹**，整体复制到 agent 的 skills 目录即可：

git clone https://github.com/DavidAlpha007/time-investment-report-agent-skill.git

# WorkBuddy / CodeBuddy
cp -r time-investment-report-agent-skill ~/.workbuddy/skills/time-investment-report

# Claude Code
cp -r time-investment-report-agent-skill ~/.claude/skills/time-investment-report

# Codex
cp -r time-investment-report-agent-skill ~/.codex/skills/time-investment-report

然后对 agent 说：

「我在犹豫要不要买 XX 课 / 追 XX 剧 / 读 XX 书，帮我做一份时间投资评估。」

安装（仅用脚本）

脚本是纯 Python 标准库，无依赖，可直接用：

python3 scripts/tir.py budget --hours 70.2 --per-week 6
python3 scripts/tir.py timeline --input segments.json
python3 scripts/tir.py scaffold --title "..." --type course

---

七格结构

格	名称	问什么
0	基础账	总篇幅、价格、评分规模、最近更新时间
1	时间账单	纯时长 ÷ 你的可用节奏 = 需要多少周
2	结构拆解	按章节 / 季 / 模块拆开，时间花在哪些格子里
3	密度异常点	铺垫段、崩塌点、注水段（看分布，不看平均分）
4	时效折损	最近更新距今多久？你的目标是否依赖它没覆盖的内容？
5	更短替代源	有没有作者本人的压缩版、官方摘要、精华段？
6	三个选项	全量 /