用途
log-to-project 用于把项目相关的工作活动记录到项目文件夹中，为持续进行的工作保留历史与上下文。其核心理念是：没有文档的项目会变成黑盒；通过项目日志，可以在数周后恢复工作、让决策有据可查、使进度可见可追踪，并让后续会话拥有完整上下文。
主要能力
- 维护项目文件夹结构，包含 PROJECT.md（规范状态文件）、CHANGELOG.md（版本历史）、Sessions/（会话日志）和 Decisions/（决策记录）。
- 提供 CHANGELOG.md、会话日志、决策记录三类文件模板。
- 按流程识别项目、确保结构存在、分析会话内容、更新变更日志、创建会话日志与决策记录。
- 提供变更日志条目的编写规范（好条目与坏条目示例）。
使用方式
配置
在 CLAUDE.md 中添加：
## Vault Configuration
Projects location: 02 Projects/
Code repositories: ~/Dev/
项目文件夹结构
02 Projects/[Project Name]/
├── PROJECT.md # Canonical status file
├── CHANGELOG.md # Version history
├── Sessions/ # Session logs
│ └── session-YYYYMMDD.md
└── Decisions/ # Decision records
└── decision-YYYYMMDD-topic.md
快速开始
- 识别所工作的项目。
- 在 02 Projects/ 中查找或创建项目文件夹。
- 用变更更新 CHANGELOG.md。
- 若工作量较大，创建会话日志。
- 若做出架构选择，创建决策记录。
文件模板
CHANGELOG.md：
# Changelog
All notable changes documented here.
## [Unreleased]
### Added
- New features
### Changed
- Modifications
### Fixed
- Bug fixes
### Removed
- Removed features
## [X.X.X] - YYYY-MM-DD
### Added
- Initial features
会话日志（Sessions/session-YYYYMMDD.md）：
# [Project Name] - Session YYYY-MM-DD
## Summary
[Brief summary of what was accomplished]
## Changes Made
### [Category]
- Change 1
- Change 2
## Decisions Made
| Decision | Rationale |
|----------|-----------|
| Decision 1 | Why |
## Next Steps
- [ ] Task 1
- [ ] Task 2
决策记录（Decisions/decision-YYYYMMDD-topic.md）：
# Decision: [Title]
**Date:** YYYY-MM-DD
**Status:** Proposed | Accepted | Deprecated
## Context
[What issue motivated this decision?]
## Decision
[What change are we making?]
## Consequences
[What becomes easier or harder?]
## Alternatives Considered
- Alternative 1: Why rejected
流程
步骤 1：识别项目
- 将工作匹配到 02 Projects/ 中的现有项目。
- 或在开发文件夹中识别代码仓库。
- 若是新项目，先使用 /start-project。
步骤 2：确保结构存在
- 如需要，创建 Sessions/ 和 Decisions/ 文件夹。
- 确认 PROJECT.md 存在。
步骤 3：分析会话内容
识别：新增或修改的功能、修复的缺陷、架构决策、配置变更、修改的文件、后续步骤。
步骤 4：更新 CHANGELOG.md
- 在 [Unreleased] 下添加条目。
- 归类为 Added、Changed、Fixed 或 Removed。
- 要具体：写“Add user authentication”而非“Updates”。
步骤 5：创建会话日志（针对大量工作）
- 创建 Sessions/session-YYYYMMDD.md。
- 包含摘要、变更、决策、后续步骤。
步骤 6：创建决策记录（针对重要决策）
- 创建 Decisions/decision-YYYYMMDD-topic.md。
- 记录上下文、决策与后果。
变更日志条目指南
好条目：
- “Add password reset flow with email verification”
- “Fix calculation error in monthly totals”
- “Change database from SQLite to PostgreSQL”
坏条目：
- “Fixed stuff”
- “Updates”
- “Bug fix”
成功标准
- 项目文件夹存在。
- PROJECT.md 存在且为最新。
- CHANGELOG.md 已用会话变更更新。
- 会话日志已创建（若工作量较大）。
- 决策记录已创建（若做出决策）。
- 后续步骤已记录。
适用场景
适用于需要长期维护文档、追踪变更与决策依据的项目管理工作，尤其是希望跨会话保留上下文、便于日后恢复工作的场景。
限制
资料未提供关于平台兼容性、收费、价格或具体效果的信息。