用途
Project Log Skill 用于创建或更新项目交接日志,使任何人(或智能体)在接手项目时能够理解其当前状态。
主要能力
- 确保项目根目录下存在
.docs文件夹,不存在则创建。 - 在
.docs/project-log.md路径下创建或更新日志文件。 - 若文件已存在,则追加新条目而非覆盖。
- 记录的信息包括:
- 已完成的工作:近期工作、变更或决策的摘要。
- 当前状态:正常 / 受阻 / 进行中 / 损坏。
- 下一步:明确的后续行动建议。
- 上下文:相关技术栈、重要文件、环境说明、阻塞项。
- 时间戳:日期与简要背景(如“实现认证后”“会话结束”)。
使用方式
- 列出项目根目录,检查
.docs文件夹是否存在,不存在则创建。所有操作使用工作区根路径。 - 检查
.docs/project-log.md。存在则追加新条目;不存在则按模板创建。 - 按模板填充日志条目:
## [YYYY-MM-DD] — [简要标题,如 "End of auth implementation"]
### Summary
[1–2 句话:本次会话或阶段完成了什么]
### Current State
[ ] Working
[ ] In progress
[ ] Blocked — [原因]
[ ] Broken — [问题所在]
### Next Steps
1. [第一个具体行动]
2. [第二个行动]
3. [第三个行动]
### Context
- **Stack**: [例如 Next.js 14, PostgreSQL]
- **Key files**: [例如 `src/auth/`, `lib/db.ts`]
- **Notes**: [环境配置、凭据位置、已知注意事项]
适用场景
- 用户说:“保存项目状态”“创建项目日志”“记录我们做了什么”“交接”。
- 结束长时间会话或切换到无关工作之前。
- 明确交接给其他人或智能体时。
- 用户要求“记录当前状态”或“注明下一步”时。
限制
资料未提供关于价格、平台支持范围、具体运行时依赖或自动检测机制的信息,暂未提供。