- name
SKILL.md
技能檔案保留在發布者的儲存庫中。
在終端機中貼上複製的指令。它會將這個 SKILL.md 安裝到對應的代理中。
npx skills add waynesutton/builder-skills --skill update-project-docs -a cursor -y在終端機中貼上複製的指令。它會將這個 SKILL.md 安裝到對應的代理中。
npx skills add waynesutton/builder-skills --skill update-project-docs -a claude-code -y在終端機中貼上複製的指令。它會將這個 SKILL.md 安裝到對應的代理中。
npx skills add waynesutton/builder-skills --skill update-project-docs -a codex -y在終端機中貼上複製的指令。它會將這個 SKILL.md 安裝到對應的代理中。
npx skills add waynesutton/builder-skills --skill update-project-docs -a grok -y在 Grok Bot 聊天中傳送複製的訊息。Bot 會從 GitHub 取得這個 SKILL.md,並加入你所有 Bot 共用的技能中。
Install this skill: https://github.com/waynesutton/builder-skills/tree/HEAD/skills/update-project-docs來自發布者
Activate with /update, @update, update project docs, or sync project docs.
Three files describe a project to the next person who opens it. Keep them true.
Truth comes from the repo, not from the conversation. If the diff does not show it, it did not ship.
git rev-parse --show-toplevel, or the workspace root without git.git log --date=short -n 20, git status --short, git diff --stat, and for the current change git diff HEAD --stat or the staged diff. See references/evidence-rules.md for what counts.Sections: ## To Do, ## In Progress, ## Completed.
- [x] YYYY-MM-DD HH:mm UTC <what>. <PRD path if any>. <files touched>. Verified: <command or outcome>.task.md does not exist, create it with the three headings and the current change under Completed or In Progress based on the evidence.Keep a Changelog format. ## [Unreleased] at the top, then ## [x.y.z] - YYYY-MM-DD blocks, each with ### Added, ### Changed, ### Fixed, ### Removed as needed.
git log --date=short. The release date is the date of the commit that bumped the version, or today's UTC date if it has not been committed yet. Never a placeholder, never a future month.package.json with no matching heading, add the heading.One line per file that matters. Grouped by folder.
## convex/
- `schema.ts` tables and indexes
- `stats.ts` heartbeat mutation with 10s dedup window, page view inserts
## src/hooks/
- `usePageTracking.ts` sends heartbeats, debounced 5s, path change aware
node_modules, _generated, lockfiles, build output, and assets unless they are hand written.When the repo has a convex/ folder, the changelog and files.md can name Convex features, but only ones the source proves. references/convex-detection.md lists what file shows what.
Short version:
convex/convex.config.ts registers it. A dependency in package.json is not proof.convex/crons.ts exists and registers a job.convex/http.ts has a route.convex/auth.config.ts or an auth component is present.Prefer none over an invented value.
changelog.md and files.md are often public. Treat them that way.
.env, .env.local, or any secret store to fill in a doc. Env var names are fine to mention. Values never.[redacted] and say so in one line.task.md, changelog.md, files.md, and PRDs the user points at. Nothing else unless asked.After syncing, print the commit message as plain text in a code block. No git add, no git commit, no heredoc, no shell at all.
<type>: <short summary of the main change>
- optional bullet when the change touches more than two concerns
feat, fix, docs, style, refactor, test, chore.docs: sync task, changelog, and files.Synced project docs.
changelog.md added 2.1.0 (2026-09-15): 3 added, 1 fixed
files.md added 2 files, updated 1 description
task.md moved 1 item to Completed, 1 still In Progress (verification pending: e2e)
Suggested commit: docs: sync changelog, files, and tasks for 2.1.0
Brings task.md, changelog.md, and files.md back in sync with what the code says shipped, then prints a commit message as plain text. Reads git history and the working tree, never memory, and refuses t
---name: update-project-docsdescription: Brings task.md, changelog.md, and files.md back in sync with what the code says shipped, then prints a commit…---# skills/update-project-docs/SKILL.md總覽
Brings task.md, changelog.md, and files.md back in sync with what the code says shipped, then prints a commit message as plain text. Reads git history and the working tree, never memory, and refuses to log features it cannot see in source. Use when a feature or fix lands, when the user says /update, @update, update project docs, sync changelog, or update files.md, or when task.md and the code disagree.
常見問題
從發布者下載 skills/update-project-docs/SKILL.md,或複製路徑後開啟儲存庫。PlugMCP 只收錄這項技能,不代管檔案。
發布者將它存放在 https://github.com/waynesutton/builder-skills。
Claude、Cursor、Codex 和 Grok Build 可以讀取你從發布者儲存庫加入的 SKILL.md。在聊天中傳送技能的 GitHub 資料夾連結,Grok Bot 就會安裝它。