effort-accountinglisted
Install: claude install-skill xingtu1996/xingtu-skills
# 投入核算
## 你要解决的事
用户的原话通常是这样:
> "我要填报公司系统,协助分析 9 月 1 号开始在这个项目的投入。"
> "这个月我在 XX 项目投了多少人天?"
> "工时填报要逐日的,每天大概几个小时。"
他的处境:**工时填报没有客观依据,只能靠回忆** —— 结果要么少报(白干),要么多报(被追问答不上),要么几个项目混在一张工时表里分不清(同一小时双计)。
你要把他从「感觉这阵子挺忙」带到「一张能提交、被追问能当场演示证据的逐日工时表」。
---
## 这个技能为什么存在
- **解决什么问题**:工时填报缺乏客观依据。销售/售前/FDE 这类跨项目角色尤其严重——工时全挂在一个项目名下,实际分摊到多个项目,项目成本统计失真(实测案例:某角色工时全挂在 A 项目,其中约 1/5 实际属于 B、C 项目)。
- **不解决什么(边界)**:
| 不做 | 原因 |
|------|------|
| 不替你决定报多少 | 口径选择权在用户手里,技能只把三个口径摆出来并给推荐 |
| **不算「未经 AI 工具产出」的工作** | **大前提**:本核算面向 **AI Native 工作方式**——产出必须经过某个 AI 工具(当前支持 Claude Code)。线下会议、出差、纯手工写文档这类没有 AI 会话痕迹的工作,无法核算也无法证伪,**不计入,需另行说明** |
| 不做跨工作空间全盘扫描 | 只认当前工作空间(含其子目录)对应的会话;跨空间的工作会漏,需人工补 |
| 不适用团队/多人工时 | 会话记录是单人视角 |
> 💡 **大前提说明了什么**:这套方法能成立,靠的是「工作痕迹天然带时间戳」。
> 一旦某个动作没走 AI 工具,它就脱离了可核算范围——**不是它不算工作,而是它不可证伪**。
> 所以核算结论的措辞永远是「**至少**这么多」,不是「正好这么多」。
- **决策依据**:
| 选了 | 否决了 | 为什么否决 |
|------|--------|-----------|
| 会话时间戳做时间基准 | 让用户自己回忆填表 | 无证据链,被追问第一句就崩 |
| 同上 | 按 git commit 数折算工时 | 提交数 ≠ 工时;夜间批量提交、格式化提交会严重失真 |
| 同上 | 按 AI token 消耗折算 | token 与人的投入非线性,同一个人不同天的 token/小时 差异可达数��� |
| 会话 span 与有效工时**并列**给出 | 只给一个区间 | 单值经不起质疑;并列才能让人自己判断并说明取舍 |
> 💡 **为什么"否决理由"要写**:只写"选了什么",后人会问"为什么不按 commit 数算";
> 写清了,后人不必重新纠结一遍。
---
## 三条铁律
1. **三口径并列,不藏中间值。** 下限(可证伪)/ 中性(建议填报)/ 上限。填报值必须落在区间内,且说得清为什么取它 —— 别只给一个数就完事。
2. **必须读会话正文,不能只看时间戳。** 只看时间戳会把挂机、以及**在同一目录里干的别的事**算进来(实测:某天 0.7h 的会话内容其实是查另一个项目的接口,与本次核算无关)。
3. **产出必须落盘 Markdown,且附可复算命令。** 未落盘 = 未完成。被追问时要能当场演示"这个数是怎么来的"。
---
## 第 0 步:确认工作空间与区间(能推断就别问)