Project Tracker / 项目追踪
When to use this skill / 什么时候使用
English: Activate when the user starts discussing a new project, feature, or requirement that needs multi-turn conversation with decisions to track.
中文： 当用户开始讨论一个新项目、功能或需求，需要在多轮对话中持续跟踪决策时激活此 Skill。
Good candidates / 适用场景
| English | 中文 |
|---|---|
| User describes a new feature or product idea | 用户描述新功能或产品想法 |
| Multi-step task that needs architecture decisions tracked | 多步骤任务，需要跟踪架构决策 |
| Requirements gathering that spans multiple messages | 跨多条消息的需求收集 |
| Any project where decisions made early will be needed later | 早期决策后续需要回顾的项目 |
When NOT to use / 不适用场景
| English | 中文 |
|---|---|
| Single-turn / one-shot tasks | 一次性任务，无需多轮对话 |
| Tasks already tracked in an external system (Notion, Jira, etc.) | 已在外部系统（Notion、Jira 等）中跟踪的任务 |
| Transient questions that won't need recall later | 无需后续回顾的临时问题 |
Prerequisites / 前置条件
| Dependency | Required? | Notes |
|---|---|---|
| File read/write tools / 文件读写工具 | ✅ | Uses read/write operations / 使用文件读写操作 |
| Write permission to default directory / 目标目录写权限 | ✅ | Directory is auto-created if missing / 目录不存在时自动创建 |
| No external commands / 无需外部命令 | ❌ | Pure agent tool calls — no binaries, no APIs / 纯 agent 工具调用 |
Storage / 存储位置
English: Notes are stored in ~/.project-notes/:
中文： 笔记存储在 ~/.project-notes/ 目录：
~/.project-notes/
├── INDEX.md ← Auto-maintained project index / 自动维护的项目索引
├── <project-slug>.md ← Individual project notes / 单个项目笔记
└── ...
> Custom path / 自定义路径: Set PROJECT_NOTES_DIR environment variable to override.
> 设置 PROJECT_NOTES_DIR 环境变量可覆盖默认路径。
Cross-platform / 跨平台兼容
English: Works identically on Windows, macOS, and Linux:
中文： 在 Windows、macOS、Linux 上行为一致：
~expands to user home directory on all platforms / 在所有平台展开为用户家目录- Use
$PROJECT_NOTES_DIRenv var for custom paths / 通过环境变量自定义路径 - Never uses hardcoded drive letters or absolute paths / 不写死盘符或绝对路径
Workflow / 工作流程
Step 1: Create project note / 创建项目笔记
Path / 路径: {{notes_dir}}/<slug>.md
Step 2: Fill template / 填入模板
# 🏗️ {{Project Name}} / {{项目名称}}
> Created: YYYY-MM-DD | Slug: {{slug}}
## ✅ Confirmed / 已确认
- [x] Decision (YYYY-MM-DD) / 决策记录
## ❓ Pending / 待定
- [ ] Open item / 待处理事项
## 🧠 Technical Decisions / 技术决策
| Decision / 决策 | Options / 选项 | Chosen / 选择 | Reason / 理由 |
Step 3: Update INDEX.md / 更新索引
English: Sync the project index table when creating or updating.
中文： 创建或更新项目笔记时同步更新索引表。
Step 4: Keep updated / 持续更新
English: Move items between Confirmed/Pending as conversation progresses.
中文： 随着对话推进，在「已确认」和「待定」之间移动条目。
Error handling / 错误处理
| Scenario / 场景 | Expected behavior / 预期行为 |
|---|---|
| Directory doesn't exist / 目录不存在 | Create it recursively / 递归创建 |
| Not writable / 不可写 | Report and suggest custom path via $PROJECT_NOTES_DIR / 提示并建议自定义路径 |
| File conflict / 文件冲突 | Append to existing, don't overwrite / 追加到已有文件，不覆盖 |
Input / Output / 输入与输出
| English | 中文 | |
|---|---|---|
| Input / 输入 | User starts discussing a project or feature | 用户开始讨论一个项目或功能 |
| Output / 输出 | Persistent Markdown files at {{notes_dir}}/ |
持久化 Markdown 文件保存在 {{notes_dir}}/ |
