跳至正文
OpenAgentSkill
浏览已开放 · 目录记录日期 2026-11-21 · 自动更新和账户服务暂时关闭。
其他技能

progress-report

Write a short progress report of what an orchestrated or long session did since the last report (never overlapping): done, what worked, what didn't, concerns, decisions made for the user, manual steps. Use for "update doc", "what's been done", "write up progress".

KrishP147 · 已有静态检查记录

安装与使用

运行命令前先阅读来源与依赖说明。复制命令不会自动安装或执行。

npx skills add KrishP147/skills --skill progress-report

技能说明


name: progress-report description: Write a short progress report of what an orchestrated or long session did since the last report (never overlapping): done, what worked, what didn't, concerns, decisions made for the user, manual steps. Use for "update doc", "what's been done", "write up progress". argument-hint: "[reports folder] [docx] [full]"

A document the user reads in two minutes.

1. Range

  • Folder: the one given, else skilleddocs/reports/ (untracked → exclude skilleddocs/ per TRACKING.md).
  • Ledger: skilleddocs/orchestrator/ledger.md (older runs: ledger.md in the folder). None → reconstruct from git log, merged PRs, issues, and this conversation, and say so in the report.
  • Watermark: .last-reported in the folder, one line <NNN> <report filename> <entry NNN's header timestamp> (e.g. 007 002-2026-10-16-x.md 2026-10-16 14:05 EDT): NNN = last ledger entry reported (no ledger → last reported commit SHA, no timestamp). The report number is that filename's number + 1. No file → report 001, covers everything.
  • Ledger restart (a new run numbers from 001 again): NNN > the latest entry, or entry NNN's timestamp differs from the stored one (no stored timestamp: the first check only) → cover the ledger from 001, keep the stored timestamp for the git scan below, and say "ledger restarted" in the Summary. A range still empty → write no report; say "nothing new since ".

No overlap: cover entries watermark+1 … latest (no ledger: commits after the SHA). Ledger present → also scan git log and merged PRs since the watermark's timestamp; work with no ledger entry goes in the report marked "not in ledger" (skip commits touching only the reports folder, .last-reported or the ledger). Something already reported that later changed (revert, reversed decision, broken "done") goes under Revisions, citing the earlier report. full → ignore the watermark; title it "Full report".

2. Sections (this order; an empty one says "none")

  • Header: Progress report NNN · <date> · covers <start> → <end> (<zone>, ledger NNN–MMM) + repo/branch + previous report. No # before the number (reads as an issue ref).
  • Summary: 3–6 bullets.
  • Done: table, Issue · Title · PR · Tests · CI.
  • What worked / What didn't (each with what was done about it).
  • Concerns: ranked, blockers marked.
  • Decided for you: Q → A · reason · where it landed, reversible.
  • Assumed decisions open: A-n from ledger assumption entries / decision record, still unconfirmed.
  • Manual steps for you: numbered.
  • Revisions to earlier reports.
  • Next up: 2–4 bullets.

Bullets, one idea each, numbers in the table, 1–2 pages. Times in the user's local zone, taken from the ledger, git log --date=format-local, or API UTC timestamps via datetime.fromisoformat(s).astimezone(); zone: reuse the one named at the top of the ledger, else run python -c "import datetime as d; n=d.datetime.now().astimezone(); z=n.tzname(); print(z if ' ' not in z else n.strftime('UTC%z'))" (abbreviation on Unix, UTC offset on Windows). Never estimated or offset by hand.

3. Links

Resolve the repo URL once: gh repo view <o>/<r> --json url -q .url, <o>/<r> per the next skill's BOARD.md, Target repo section (on a fork, the repo the run wrote issues and PRs to; issues read from the parent, as when the fork has issues off, link to the parent: resolve its URL too and use it for rule 4). Link every reference in every section with one left-to-right pass over each paragraph and cell, one combined regex, alternatives tried in this order at each position:

  1. existing markdown link [..](..), <url> or bare https?://\S+ → copy unchanged
  2. inline code span → copy unchanged
  3. PR #n, PR#n or a list PRs #n, #m → link each #n in it to <repo>/pull/n
  4. #n (not preceded by a letter, digit or &) → link "#n" to <repo>/issues/n
  5. hex sha, 7–40 chars of [0-9a-f] with at least one digit and one a–f letter, word-bounded and not inside a branch name or path (not touching /, - or _, and not joined to a word by a single .) → link "<first 7>" to <repo>/commit/<full>
  6. D<k>/A-<k>/ADR id, word-bounded → link to the decisions file (its heading anchor for that id, if it has one); no decisions file → leave as text

Never link: heading lines (#–###### then a space, incl. the report header), decimal-only tokens (CI run ids). Never re-scan output. Then check link count ≥ the #n mentions in the ledger range, counting only mentions outside code spans and URLs (rules 1–2 never link those).

4. Write

Commit mode on a protected <default> → first switch to the docs branch docs/report-<NNN> per TRACKING.md. NNN-YYYY-MM-DD-<slug>.md in the folder (local date; never overwrite). docx → same name .docx, via the docx skill or python-docx: heading styles, real bullets, a Done table, real hyperlinks. Read it back once to check nothing's empty.

5. Advance

Write .last-reported (<NNN> <filename> <timestamp>; no ledger → last reported SHA), append a ledger report entry with the range (no ledger → skip it and say so), and print the report path + range. Commit the report, .last-reported and ledger entry only in commit mode per TRACKING.md and only on <default> (defined there) or §4's docs branch; else leave them on disk.