القائمة
记录本次会话变更背后的"为什么"——决策依据、方案选择、考虑过的替代方案——追加到 docs/decisions/log.md。凡产生文件改动或技术决策的任务完成后触发。
التثبيت باستخدام Codex أو Claude انسخ هذا Prompt والصقه في Codex أو Claude أو مساعد آخر ليراجع صفحة Skill ويثبّتها لك.
استنادا إلى تصنيف SOC المهني
| name | whylog-record |
| description | 记录本次会话变更背后的"为什么"——决策依据、方案选择、考虑过的替代方案——追加到 docs/decisions/log.md。凡产生文件改动或技术决策的任务完成后触发。 |
在产生文件改动或技术决策的任务完成后，记录决策上下文到
docs/decisions/log.md。
回顾本次对话，按以下规则判断：
记录：修改了项目源码/配置/依赖、修复了 bug、做出了技术决策或方案选择
酌情记录：仅修改了文档或测试——满足以下任一条件则记录，否则跳过：① 修改时存在多个方案的选择（有取舍行为）；② 修改原因不显而易见（非单纯的格式整理或拼写修正）
跳过：纯问答、纯阅读/探索、任务未完成或被取消、whylog skill 自身执行、仅修改了 docs/decisions/ 下的文件
若判断为跳过，输出一行说明（如"无需记录：纯问答"）后直接结束，不执行后续步骤。
若 docs/decisions/log.md 不存在，创建目录和文件，写入 # Decision Log。
新 entry 必须追加到文件最末尾。不得插入已有 entry 之间。 写入后确认：新 entry 是文件中最后一个
## YYYY-MM-DD HH:MM标题，且其日期不早于前一条 entry 的日期。
写入前执行以下命令获取当前日期和时间（自动适配平台），填入标题：
date "+%Y-%m-%d %H:%M" 2>/dev/null || powershell -Command "Get-Date -Format 'yyyy-MM-dd HH:mm'"
格式自由，外层结构统一：
## YYYY-MM-DD HH:MM — {简短标题}
{1~5 句话，不要硬凑。包含以下要素，按需取舍：}
- 做了什么、为什么
- 选了什么方案、考虑过什么替代方案
- 涉及哪些关键文件
不同场景的写法参考：
src/auth/middleware.tssrc/api/list.ts写入后输出一行摘要，格式固定为：
已记录: {标题} → docs/decisions/log.md
其中 {标题} 与写入的标题保持一致。用户可要求修正。
统计 log.md 中以 ## YYYY-MM-DD HH:MM 开头的标题数量，若 >= 150：
log.md 中第一条 entry 标题的月份（YYYY-MM）作为归档文件名，避免跨月内容被错误归入当前月log.md 全部内容追加到 docs/decisions/log-YYYY-MM.md（不存在则创建）log.md，写入 # Decision Log 和排序说明log-YYYY-MM-01.md、log-YYYY-MM-02.md …（按序递增）