AI导哈

意图跟踪工具

Intention 是一个用于跟踪代码编写意图和演变过程的工具，特别适用于协作编程和AI辅助开发场景。

  • by bickolasliu
  • JavaScript
  • 本地部署
  • 更新于
在 GitHub 查看 bickolasliu/intention-mcp

使用说明

意图-协作振动编码的简单意图跟踪

跟踪为什么编写代码以及使用Cursor或Claude code时代码是如何演变的。

安装

在存储库根目录下运行：

npx setup-intention

脚本将：

  1. 检测您使用的AI助手
  2. 将意图跟踪说明添加到其配置文件中
  3. 创建一个 .intents 用于跟踪的文件夹

工作原理

设置后，每当编码代理创建或修改文件时，它也会在中创建相应的文件 .intents/ 记录：

  • 什么 被请求（提示）
  • 当 它发生了（时间戳）
  • 为什么 已完成（摘要）
  • 谁 请求它（如果可用）

示例

当你问：“在app.js中创建Express服务器”

编码代理创建：

  • app.js -您的Express服务器
  • .intents/app.js.json -创建原因的文档
{
  "intents": [{
    "id": "550e8400-e29b-41d4-a716-446655440000",
    "timestamp": "2024-11-05T10:30:00Z",
    "action": "create",
    "prompt": "Create an Express server in app.js",
    "summary": "Created Express server with basic routing and middleware setup"
  }]
}

支持的AI助手

  • 光标 - .cursorrules
  • 克劳德代码 - .claude/instructions.md （桌面IDE）

查看意向历史记录

# See all tracked files
find .intents -name "*.json"

# View specific file history
cat .intents/src/app.js.json | python -m json.tool

# Count changes per file
for f in .intents/**/*.json; do
  echo "$f: $(grep -c '"id"' $f) changes"
done

版本控制

重要提示： 这 .intents 文件夹应该提交到您的存储库中。这使您的团队能够：

  • 了解编写代码的原因
  • 观察人工智能辅助变革的演变
  • 审查人工智能决策
  • 保持问责制

不添加 .intents 到 .gitignore -这是为了合作。

为什么要跟踪意图？

  • 了解决策 -知道为什么代码是以某种方式编写的
  • 团队协作 -分享人工智能辅助变革的背景
  • 代码考古学 -了解历史决策
  • 质量保证 -更有效地审查AI生成的代码
  • 知识转移 -新团队成员更快地理解代码库

相关 MCP