29 Commits

Author SHA1 Message Date
Zhang Jiahao
e70b228af3 sync sidecars from ~/.claude/ 2026-04-21 01:49:07 +08:00
Zhang Jiahao
dd80147f39 sync sidecars from ~/.claude/ 2026-04-21 01:42:21 +08:00
Zhang Jiahao
fe140fbd9f sync sidecars from ~/.claude/ 2026-04-21 01:35:56 +08:00
Zhang Jiahao
1524b15cd0 sync sidecars from ~/.claude/ 2026-04-21 01:31:39 +08:00
Zhang Jiahao
1d0a04c158 sync sidecars from ~/.claude/ 2026-04-21 01:13:43 +08:00
Zhang Jiahao
8e7abb2092 Add tool.md catalog to sidecar imports
note.md 写"怎么用"越写越重, 每次查"装了什么"要翻半天; tool.md 只做
一行一工具的索引表 (name + 用途), 和 note 解耦。CLAUDE.md §5 导入
链同步加入 @~/.claude/tool.md; mdTemplet 提供初始快照。
2026-04-21 01:04:56 +08:00
Zhang Jiahao
211c0f05d8 Strengthen push policy: don't ask, just push
原条目 "push by default" 留了模糊空间, 实测我仍然会在 commit 后反复确认
"要不要 push", 用户明确要求消除这种冗余询问; 加 "don't ask first, just push"
固化下来, 只在用户显式拒绝或仓库没 remote 时才跳过。
2026-04-21 00:58:51 +08:00
Zhang Jiahao
23c7037b57 Add session-end-log hook with per-session token tally
既有 Stop 钩子 token-stats-hook 记的是跨会话累计快照, 无法区分"这次会话
用了多少"; session-end-log 在 SessionEnd 时按 session_id 解析本次 transcript
做单会话统计, 产出一行可回溯的索引写入 ~/.claude/log.md, 方便事后盘点
哪场会话烧了哪些 token。Python 写零依赖, Ubuntu 自带 python3 免构建。
2026-04-21 00:58:00 +08:00
Zhang Jiahao
484a9225f3 Ignore repomix output files
repomix 默认把打包结果写到仓库根的 repomix-output.xml, 会污染工作区
和未来的意外提交; 作为生成产物不应进版本控制。
2026-04-21 00:52:39 +08:00
Zhang Jiahao
d99ac3a142 Add mdTemplet/ sidecar templates for CLAUDE.md @-imports
主仓库的 CLAUDE.md 用 @~/.claude/note.md 等路径引用本地侧边文件, 克隆者
机器上默认没有这些文件会导致 @ 解析为空。提供 mdTemplet/ 下的现成样本
(note.md 工具笔记/debug.md 踩坑记录/log.md 会话日志空壳) 方便克隆者直接
拷到自己的 ~/.claude/ 作为起点。
2026-04-21 00:51:56 +08:00
Zhang Jiahao
e99b5fe482 Split tooling notes and pitfalls into @-imported sidecars
主文件不断累积实测工具细节和踩坑记录让核心准则变难扫读;通过 Claude Code
的 @ 导入语法把这些拆到本地 note.md / debug.md, 主文件只保留指针和纲领,
后续新增工具经验或坑直接往子文件加, 主文件保持稳定。log.md 作为会话索引
由本地 SessionEnd hook 维护, 不跟随仓库同步。
2026-04-21 00:50:16 +08:00
Zhang Jiahao
04efa2d72e Refine locate tooling notes based on hands-on testing
eza 的 --tree 在没有路径参数时会静默输出空结果,实测踩坑,需
明确写出必须加 `.`;broot 实测需要 TTY 且首次运行会改 shell rc,
对 CLI/Claude Code 没有增量价值,标注跳过避免后续误用。
2026-04-21 00:37:01 +08:00
Zhang Jiahao
ef183636fc Add apt to package manager list
Linux 环境的系统级依赖安装默认走 apt,明确写出避免在 Ubuntu 上
误用其他发行版的包管理器(yum/dnf/pacman)。
2026-04-21 00:34:05 +08:00
Zhang Jiahao
0a5d283dfd Add locate tooling and plan-stage token/time estimates
Mature repos benefit from structured scans (repomix / eza / fd / rg)
over blind Reads; explicit token and wall-clock estimates in the Plan
step let the user redirect early before a scope mismatch burns context.
2026-04-21 00:31:38 +08:00
Zhang Jiahao
bc16d00ea7 Add TypeScript preference for web stack
Web 项目默认 TypeScript 可减少运行时类型错误并与既有 Node/前端工程保持一致;
对接既有 JS 项目时仍尊重项目自身的语言选择。
2026-04-21 00:19:24 +08:00
Knowit
36b1759243 Add Gitea management boundaries to §0
Why: Charles asked whether I can proactively manage repos on his Gitea.
Define explicit allow / confirm / forbid tiers so I don't accidentally
delete a repo or force-push main.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
v0.1.0
2026-04-20 21:28:54 +08:00
Knowit
708665d734 Add Locate → Plan → Execute workflow to §1
Why: Charles wants an explicit three-phase workflow alongside the
existing "Think Before Coding" checklist, not a replacement.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
2026-04-20 21:26:46 +08:00
Knowit
ce33e4351a Unify CLAUDE.md in English; update git/address preferences
Why: keep a single language register for the global guide, and reflect
Charles's updated defaults (push when possible, address as Charles).

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
2026-04-20 21:23:12 +08:00
Knowit
6406ef36a5 Add global CLAUDE.md with behavioral guidelines
Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
2026-04-20 21:15:21 +08:00
53d7951744 test 2026-04-18 20:18:43 +08:00
Knowit
36310b97d9 Simplify hook install: use precompiled binary directly 2026-04-18 10:07:26 +08:00
Knowit
a9404d0fdd Add precompiled binary (linux/amd64) 2026-04-18 10:07:15 +08:00
Knowit
73a948fb32 Add hook install instructions to README 2026-04-18 10:06:09 +08:00
Knowit
e29e3ec91c Add token-stats-hook Go module and update README 2026-04-18 10:05:00 +08:00
Knowit
e04f79b1d1 Default output in Chinese, switch language with --lang 2026-04-18 09:51:16 +08:00
Knowit
81950e263e Add note about root user for full stats 2026-04-18 09:47:18 +08:00
Knowit
198a8bffbb Add mkdir step to install instructions 2026-04-18 09:46:19 +08:00
Knowit
ae3856cc71 Update README with git clone install instructions 2026-04-18 09:38:54 +08:00
Knowit
770c1f3d19 Add token-stats slash command 2026-04-18 09:34:17 +08:00