work-logs-knowledge-log

work-logs-knowledge-log 技能旨在作为 AI 辅助开发过程中的文件撷取工具。当 AI 代理处理存储库时，它不可避免地会识别出单从原始源代码中无法立即显现的细微差别、架构意图和未记录的业务逻辑。此工具允许代理提取这些发现并将其保存为结构化的 Markdown 知识日志以供未来参考，从而弥合原始源代码与人类可读的项目背景之间的差距。它主要适用于需要维护存储库环境内机构知识的开发人员和技术负责人。

• 自动在 ~/.claude/knowledge/${repo_name}/ 目录中产生带有时间戳的知识日志文件。

• 优先记录推断的代码逻辑与实际用户业务需求或限制之间的差异。

• 捕捉隐性规则、操作实践以及解释代码结构背后原因的具体设计理由。

• 使用标准文件系统工具（Read, Write, Grep, Glob）来检查代码并保存文档文件。

• 支持基于亚洲/东京时区的标准化日期时间前缀，以确保时间顺序的一致性。

• 当遇到代码功能与项目需求之间的差异时，或在任务的发现阶段，请触发此技能。

• 使用所记录的日志作为确定官方项目文档需要扩充或修正之处的基础。

• 确保日期时间格式遵循 +%Y-%m-%d_%H-%M 约定，以便进行文件组织。

• 依靠此技能来记录技术债、具体的业务逻辑例外以及未在提交信息或标准 README 文件中记录的架构决策。

• 该工具限制在定义的 ~/.claude/knowledge 路径内运作，确保知识积累保持在代理的工作空间内。