sqhh99/point/project-records
Claude Code and agent skill by sqhh99/point
Trust tier 3
- community
Source check pending
Checking that the SKILL.md file is still in the repository.
为 Point 写必备的项目记录——改动文件后的工作日志、审查代码后的审查归档、开 PR 前的 PR 记录。完成这三类事情时必须使用。
Install
npx vskill@latest install sqhh99/point/project-recordsSKILL.md
项目记录
Point 在 docs/ 下保留三类永久记录。它们是必做项,不是可选的附加物:只存在于对话里的决定,会话一结束就丢了。用户不看 PR,只在用完软件后提意见,所以这些记录就是项目唯一可追溯的过程依据。
三类记录
| 记录 | 何时写 | 目录 | 谁写 | |
|---|---|---|---|---|
| 工作日志 | 任何改动仓库文件的请求 | docs/work-logs/ | 做改动的 bot | |
| 代码审查 | 每次审查 PR | docs/code-reviews/ | PR评审员 | |
| PR 记录 | 开 PR 之前 | docs/pull-requests/ | 开 PR 的 bot |
- 记录用中文写;用户原话按原文引用。
- 文件名统一
YYYY-MM-DD-<topic>.md,<topic>是短的 kebab-case;PR 记录用分支主题。日期写绝对日期(2026-10-12),不写「今天」「上周」。 - 同一件事的三份记录互相链接:日志链到审查和 PR 记录,审查的状态摘要链回日志,PR 记录链到前两者。用仓库内相对路径(
../work-logs/...),保证在 GitHub 上能点开。 - 记录随它描述的改动放在同一个 PR 里提交。审查记录由 PR评审员 在审查时另开一个只改
docs/code-reviews/的小 PR,或直接推到被审 PR 的分支上(作者同意时)。
通用规则
- 没跑过的命令绝不打勾。 留空,并在旁边写明原因。这是最容易被悄悄破坏的一条,破坏了它,其他记录都不可信。
- 明确写出验证状态,包括「未构建、未测试」。两个平台的 CI 结果写清楚是哪个 commit、哪几个 job。
- 写清没做什么、没覆盖什么,和做了什么一样仔细。范围边界是后来的人最难还原的部分。
- 版本号:功能或修复 PR 要写明这次按
va.b.c规则升了哪一位以及理由(a:大升级或架构调整;b:较大的功能调整或优化;c:bug 修复或小优化)。文档、设计稿 PR 写「不升版本」。 - AI 声明:写明哪些部分由哪个 bot 生成,是否经过验证。
1. 工作日志 — docs/work-logs/YYYY-MM-DD-<topic>.md
每个改动文件的请求写一份,覆盖「请求 → 计划 → 改动」全过程。同一天对同一请求的直接追加,在当天文件里加一节。
2. 代码审查 — docs/code-reviews/YYYY-MM-DD-<short-title>.md
每次审查 PR 后写,无论有没有因此修改。
「是否已处理」这一列是这份文档的意义所在,要保持最新。问题后来被修了,就原地更新这份文件,不为同一次审查另开第二份。行号保留审查时的值,表头记了 commit。
3. PR 记录 — docs/pull-requests/YYYY-MM-DD-<branch-topic>.md
开 PR 之前写好,然后直接用作 PR 正文。
PR 正文和这份文件内容要一致。
扩展这个 skill
新增一类记录需要三样东西:触发时机、docs/ 下的目录、这里的模板。在上面的表里加一行、加一个编号章节,再在根目录 AGENTS.md 的「必备记录」里加上触发条件,这样不读本文件也能知道要写。保持 YYYY-MM-DD-<topic>.md 命名,目录才能按日期排序和检索。
Security
- Security scanPassed, 90 of 100Pattern checks on the skill's files.
- Model reviewPassed
Quality evaluation
- Task evaluationNot runNo evaluation yet. Run one in Skill Studio.
Source
- SKILL.md in the repositoryCheckingagents/skills/project-records/SKILL.md
Popularity
- 7-day trend score
- 0
Not refreshed yet.
Works with
Any agent vskill installs to: 56 targets in all. These 39 have a page on this site.
- Claude Code
- Cursor
- GitHub Copilot
- Windsurf
- Codex
- Gemini CLI
- Cline
- Amp
- Roo Code
- Goose
- Continue
- Kilo Code
- Junie
- Trae
- OpenHands
- Qwen Code
- AI Agent
- Tabnine Chat
- Sourcegraph Cody
- Amazon Q
- Firebase Genkit
- Sweep
- Devin
- Phind
- Mentat
- Claude Desktop
- Aider
- GPT Pilot
- Plandex
- bolt.new
- v0
- Replit Agent
- Anse
- TypingMind
- BetterChatGPT
- LibreChat
- Warp AI
- Pieces
- Fig AI
Embed badge
[](https://verified-skill.com/skills/sqhh99/point/project-records)