shiplog
将AI编码的思考过程永久记录到Git历史中
安装使用
复制下面这段提示词发给你的 AI（Claude / Cursor / TRAE / Codex / WorkBuddy 等），它会自动帮你完成安装：
帮我安装这个 AI Skill：shiplog。 它的用途是：将AI编码的思考过程永久记录到Git历史中 完整的 Skill 内容见：https://321skill.com/skills/shiplog/raw/index.md 请读取该页面内容，如果是 SKILL.md 格式直接安装，如果是 README 提炼核心 prompt 后安装。
提示词包含完整的 Skill 内容链接，AI 读取后即可完成安装。你也可以 查看完整内容 确认无误。
使用示例
“让我们为新的用户服务设计一下API接口。” shiplog会立即将这次讨论转化为一个结构化的GitHub Issue，包含设计决策、备选方案和待办清单。当你后续说：“开始处理#15号issue”，它会自动创建分支并加载上下文，确保AI能无缝衔接上次的思考。
介绍
shiplog 解决了AI助手在会话间遗忘上下文的核心痛点。在编码过程中，AI的每一次设计讨论、决策权衡和临时发现，都会随着代码变更被自动捕获并记录到GitHub的Issue、Commit和PR中，形成可追溯的知识轨迹。
使用时，你只需像往常一样与AI讨论和编码。当你启动一次头脑风暴（如“让我们设计一下认证中间件”），shiplog会自动创建一个GitHub Issue来记录讨论结果和任务清单。当你开始处理某个Issue时，它会创建一个独立的工作分支。在提交代码时，它会自动附加上下文注释，说明“为什么”要这样修改。最终，PR会包含从构思到完成的完整时间线。
这个Skill非常适合依赖AI进行编码的开发者，尤其是全栈开发、后端开发和智能体开发者，他们经常需要跨多个会话完成复杂功能，并希望保留决策脉络以供未来查阅或团队协作。
建议在个人项目或开源项目中先使用“完整模式”，让所有知识直接进入主分支的PR。在团队协作中，可以切换到“安静模式”，将详细的推理过程记录在一个单独的--log分支，保持主PR的整洁，同时知识仍一键可达。
核心特点
与仅记录代码变更的Git工具不同，shiplog强制记录“为什么”变更的上下文，并首创了跨模型审查机制，禁止同一AI模型自写自审，确保代码质量。其“模型身份签名”功能让所有AI产出的工件都可溯源和搜索。
注意事项
不适合仅进行简单、一次性代码片段生成的场景，其价值在长期、复杂的项目开发中才能充分体现。
常见问题
shiplog会改变我现有的Git工作流吗？
不会，它在你的现有工作流之上添加了知识捕获层，你仍然使用熟悉的Git命令。
记录的信息会公开吗？
取决于你的仓库权限。如果你使用私有仓库，所有记录的信息都是私有的。
给 AI 助手的安装指引
如果你的 AI 编程助手（Claude Code、Cursor、TRAE 等）能看到这个页面，把下面这段发给它即可自动完成安装：
请访问 https://321skill.com/skills/shiplog/raw/index.md 读取 shiplog 的原始 Skill 定义（Markdown 格式），按其中说明在我的环境里完成安装和配置。
AI 可直接读取的原始 Markdown 地址：/skills/shiplog/raw/index.md（查看排版版本）