| name | dev-logs |
| description | 为本仓库创建和维护单任务开发日志。用于每个产生仓库文件变更、用户环境变更、数据清理或实质性故障诊断的独立用户任务；要求在 docs/dev_logs 的月/日分区内一任务一 Markdown，并同步日、月、总索引。历史日志不要求追溯改造。 |
单任务开发日志
把开发日志当作任务验收记录，而不是对话汇总。一个可独立验收或回滚的用户任务只写一份日志；用户用“Next”“顺便”“此外”等提出新的独立成果时，新建日志，不追加到旧日志。
任务边界
- 仓库文件变更、用户环境变更、数据清理和实质性故障诊断必须记录。
- 纯解释、闲聊和没有执行诊断的简短问答不记录。
- 同一业务目标的实现、测试、架构同步和日志收尾属于同一任务。
- 可独立验收、独立回滚或影响不同业务目标的工作必须拆开。
- 日志及索引的维护属于当前任务，不能递归创建“记录日志的日志”。
- 本规范生效前的历史日志按原样保留；不要仅为格式一致而迁移、改名或补造时间。
路径与命名
使用任务开始时间创建路径：
docs/dev_logs/YYYY-MM/YYYY-MM-DD/HH-MM-SS+task-slug.md
task-slug 使用小写英文、数字和连字符。若同秒重名，在 slug 后追加简短序号，不覆盖已有记录。
工作流
- 开始实际操作前，运行
date '+%Y-%m-%d_%H-%M-%S %Y-%m %Y-%m-%d %H:%M:%S %z' 固定任务 ID 和开始时间。
- 从 task-log-template.md 创建单任务日志，立即填写用户目标、方案边界与预期验收。
- 执行过程中记录关键动作；完成后填写文件变更、验证证据、风险、回滚方式和最终成果。
- 在当日
README.md 中增加一行任务链接；日期、月份或总索引不存在时按四层结构创建并只登记直属子节点。
- 只有直属子节点变化时才更新直接父索引。根
INDEX.md 不登记任务明细。
- 运行校验器：
python3 .agents/skills/dev-logs/scripts/validate_dev_logs.py \
--root docs/dev_logs \
--record docs/dev_logs/YYYY-MM/YYYY-MM-DD/HH-MM-SS+task-slug.md
- 在最终回复中给出日志路径；若校验失败，先修复再交付。
内容要求
- 使用精确到秒、带时区的真实时间，不推测或伪造历史时间。
- 逐字记录触发当前独立任务的用户原始 Prompt；后续确认或范围修订也按消息顺序记录。
- 原始 Prompt 含密码、令牌、私钥或其他秘密时，用
[REDACTED] 替换秘密值并注明已脱敏，禁止把秘密写入仓库。
- 声明实际执行者的模型身份。只使用当前运行时或系统明确提供的产品与模型名称；无法确认具体子版本时不得猜测。
- 将原始 Prompt 与业务化的用户目标分开保存：前者用于审计，后者用于快速理解成果。
- 文件表只列本任务实际触及的路径，不把工作区既有脏文件算入本任务。
- 验证必须写命令或可复核证据，不能只写“已检查”。
- 没有仓库文件变更时明确写“无”；诊断任务仍需记录证据和结论。
- 删除或回滚任务必须记录
.agents/cache/<task_name>/ 备份位置。
四层索引职责
docs/dev_logs/INDEX.md
└── YYYY-MM/README.md
└── YYYY-MM-DD/README.md
└── HH-MM-SS+task-slug.md
- 总索引：月份级入口与汇总。
- 月份索引：直属日期入口与任务数。
- 日期索引：当天每个独立任务的时间、类型、状态和成果。
- 任务日志：唯一保存任务目标、动作、变更和验证明细。
