用途:Starlight Chronicle 是 FrankX OS 的「见证层」,用于对已完成的工作进行反思性记录,与记录实际交付内容的 Changelog 形成两个不同语域。其核心是四种节律的实践:每周 Palace Review、每月 Survey、每季 Constellation Census、每年 Legacy Audit。
主要能力:每周 Palace Review 读取一周内各规范仓库的 git 历史、本周 data/changelog-entries.json、MEMORY.md 索引及上一份 Palace Review,输出固定六段结构的 markdown 文件,路径为 docs/chronicle/weekly/YYYY-W##-palace-review.md,依次为结构真相、应予祝福或保留的内容、结构重要但未完成的部分、未来 7 天可忽略项、周一的单一最高杠杆执行路径、交接说明;长度目标 800–1500 字,硬性不超过 1500 字,并同步更新 docs/_moc/MOC-Chronicle.md 索引。另有 /bless <slug> 用于单件确认,以及 /chronicle month、/chronicle quarter、/chronicle year 等节律命令。
使用方式:实践为手动调用,禁止以 hook 自动触发,跳过的节律视为沉默。若 data/changelog-entries.json 缺少当周条目,需先运行 scripts/chronicle-roll-week.mjs。脚本通过识别 feat:、fix:、ship:、feat(scope): 等 conventional-commit 前缀自动汇总 git 历史。
适用场景:适合高频交付、需要把「已建成之物」沉淀为可读记录的创作者工作流;可选配一张由 scripts/nb-generate.mjs 生成的主图、最多 3 张本周已交付界面的截图及一句本周引用,纯文本版本即为完整版本。
限制:v1 只激活每周节律,月度需前 4 次周审中实际发生 ≥3 次后启用,季度需前 12 次中发生 ≥10 次或月度连续 3 个月,年度在 2026-12-21 冬至启用。禁止自动触发、代写未要求的周、使用未来时态、把季度或年度节律提前,或在实践未被验证前建议构建 Phase 2 工具。默认输出为私有存档,仅在明确要求时才产出公开信草稿。收费、价格与平台等信息暂未提供。