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 / 适用场景

When NOT to use / 不适用场景

Prerequisites / 前置条件

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_DIR env 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 / 错误处理

Input / Output / 输入与输出