资源/资产台账范式
术-流程 · 术层 skill 全文
本页是 <code>rules/skills/drafts/bestpractice_resource_asset_ledger.md</code> 的逐字投影(仅隐私清洗,零改写)。
时点提示:本页是仓内文件 rules/skills/drafts/bestpractice_resource_asset_ledger.md 的逐字投影(仅做隐私清洗:仓库根绝对路径→相对路径、家目录→~/;除此零改写)。若源文件后续有修订,以仓内真源为准。
报告元数据(frontmatter)
name: bestpractice_resource_asset_ledger
status: draft (Beta) — 2026-07-20 起草(方法论体系 buildout 批3 B11,蒸馏 lane);晋级前需在 ≥1 个真实任务收口时按本范式登记一条资产并有使用 receipt 佐证
description: 资源/资产台账范式(术·流程,薄)。任务中发现、克隆、调研了外部资源(repo / 工具 / 数据源 / 资源渠道 / 想法 / 方法论)后,收口时把它登记成指针型台账——不只是收集,还带三值状态与有用性判断字段,避免「收集强、有用性判断缺」的堆积。活范例真源 = career/ASSETS.md。
consumption: 任务收口时(状态从进行中→完结),发现产出/接触了可能被未来任务复用的外部资源,需要登记并做有用性判断。触发信号:clone 了 repo、调研了工具选型、发现了资源渠道、沉淀了想法/方法论、要判断某资源「以后还能不能用」。
type: BestPractice(术·流程)资源/资产台账范式
术·流程薄 skill。范式本体活范例 = career/ASSETS.md(fa-3,四类台账 + 三值状态 + 维护纪律,亲读它学全形态)。本 skill 只把范式从 program 绑定里剥出来给跨项目复用,不复制它的正文。
这个 skill 解决什么
仓库长期「收集机制强、有用性判断系统性缺失」:clone 了 55 个 repo 只有一句话描述、蒸馏了 117 本书零判断哪本该复用。收集不带判断 = 堆积,未来任务照样重造轮子。台账范式把「登记」和「有用性判断」焊在一起:登记一条资产的同时必须答「以后什么场景能复用、现在算不算可用、下次什么时候该重核」。
何时用 / 不用
- 用:任务收口时发现产出或接触了外部资源(repo / 工具 / 数据源 / 资源渠道 / 想法 / 方法论),且它可能被未来任务复用。
- 不用:一次性用完即弃的资源;纯代码实现(走各自真源);已有对口台账时(如竞赛域走
career/ASSETS.md,直接加行,别另起平行台账)。
台账 schema(照 career/ASSETS.md,指针型)
一条资产一行,字段:id | 资产名 | 一句话 | 真源路径(绝对路径,指针型不复制内容)| 状态 | 复用场景 | 抽取成本。四类分表登记(不同资产走不同分表,id 各自续号,不重排):
- 技术类(T):代码实现、脚本、工具、可运行工件。
- 资源类(R):外部账号 / 数据源 / 资源渠道 / clone 的 repo。
- 想法类(I):设计想法、格式约定、可复用的思路。
- 方法论类(M):经验教训、工作法、可复用判断。
有用性判断(最小三字段,登记时必答)
登记不是抄路径,是同时做三件有用性判断:
- 复用场景(一句话):将来什么类型的任务会来这里找它。写不出复用场景 = 这条不值得登记。
- 状态三值:
已验证可用/UNKNOWN待核/未通过。不确定就标UNKNOWN待核,绝不擅自升级为「已验证可用」——「进了台账」不等于「已验证可用」;核实是后续轮的独立动作,不与登记动作合并。 - 下次核验触发条件:什么情况下该回头重核这条(如「真正要复用前」「所依赖的系统改版后」「距今超过 N 月」)。
UNKNOWN待核的条目在被真正复用前先花几分钟核实真源。
反模式(一行)
收集不判断 = 堆积:clone/调研了却不登记复用场景与状态,等于没收集——未来任务查不到、照样重造轮子。
边界
本 skill 只给「怎么登记 + 判什么」的范式;具体某个 program 的台账实体、维护纪律全文、id 编号历史以对应台账文件(活范例 career/ASSETS.md 的「维护纪律」节)为准,本 skill 不复述、不覆盖。跨项目资源是否全量回填由消费驱动分批(新条目即用本 schema,存量按需补,不为登记而登记)。