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

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}}/`