progress-tracker
收集零散想法、整理成结构化任务、追踪进度并生成报告。支持两种输入:(1) 被动收集 - 扫描 docs/temp/ideas/ 文件夹;(2) 主动输入 - 用户直接说,AI 记录。支持 HTML 可视化编辑和拖拽排序。触发词:记录想法、整理ideas、收集想法、进度报告、总结进展、idea、想法。
用 Codex 或 Claude 帮你安装 复制这段 Prompt,粘贴到 Codex、Claude 或其他助手里,让它检查 Skill 页面并帮你完成安装。
菜单
收集零散想法、整理成结构化任务、追踪进度并生成报告。支持两种输入:(1) 被动收集 - 扫描 docs/temp/ideas/ 文件夹;(2) 主动输入 - 用户直接说,AI 记录。支持 HTML 可视化编辑和拖拽排序。触发词:记录想法、整理ideas、收集想法、进度报告、总结进展、idea、想法。
用 Codex 或 Claude 帮你安装 复制这段 Prompt,粘贴到 Codex、Claude 或其他助手里,让它检查 Skill 页面并帮你完成安装。
基于 SOC 职业分类
为 AI Agent 创建元规则和领域知识,帮助用户在不熟悉领域建立 Agent 的思考方式和行为准则。专注于抽象的行事风格而非具体技术约束。适用场景:(1) 创建新 Agent 缺少行为准则,(2) 更新现有 Agent 的元规则或知识,(3) 用户不熟悉目标领域需要搜索最佳实践,(4) 希望 Agent 跨项目保持一致工作风格。
记录 AI 犯错或可改进点,生成可复用的学习资产。支持两种模式:(1) 当前会话 - 会话结束时触发,引导用户回顾本次会话中的纠正和可改进点;(2) 指定会话 - 通过 session_id 或 JSONL 文件路径分析历史会话。存储位置:D:\desktop\quackDocs\my_notes\ai_mistake\(index.md 索引 + records.md 实体)。触发词:记录错误、记录问题、AI 错误记录、会话总结、记录教训、record mistakes。
记录 AI 犯错或可改进点,生成可复用的学习资产。支持两种模式:(1) 当前会话 - 会话结束时触发,引导用户回顾本次会话中的纠正和可改进点;(2) 指定会话 - 通过 session_id 或 JSONL 文件路径分析历史会话。存储位置:D:\desktop\quackDocs\my_notes\ai_bug_history\(index.md 索引 + records.md 实体)。触发词:记录错误、记录问题、AI 错误记录、会话总结、记录教训、record mistakes。
指导 Manager 设计和创建 Loop 循环。当 Manager 需要创建自动化循环(如 Executor-Reviewer、Writer-Editor 模式)时使用。 提供完整的设计流程:需求澄清 → 节点设计 → 用户确认 → Subagent 验证 → 创建循环。 确保循环提示词质量,避免因上下文设计不当导致循环失败。 触发词:创建循环、loop、循环设计、迭代执行、自动审查。
记录架构决策(ADR)。触发条件:(1) 艰难选择——在方案间纠结、选了A但B也有优势、知道有副作用 (2) 重构/重大修改后——改了3+次才定方案、每次改有新考虑 (3) 奇怪代码——被问"为什么这样写"、审查被质疑、自己回看也觉得奇怪 (4) 用户做出重大决策或出现决策疑问
Grilling session that challenges your plan against the existing domain model, sharpens terminology, and updates documentation (CONTEXT.md, ADRs) inline as decisions crystallise. Use when user wants to stress-test a plan against their project's language and documented decisions.
| name | progress-tracker |
| description | 收集零散想法、整理成结构化任务、追踪进度并生成报告。支持两种输入:(1) 被动收集 - 扫描 docs/temp/ideas/ 文件夹;(2) 主动输入 - 用户直接说,AI 记录。支持 HTML 可视化编辑和拖拽排序。触发词:记录想法、整理ideas、收集想法、进度报告、总结进展、idea、想法。 |
收集零散想法,整理成结构化任务,追踪进度并生成报告。
docs/
├── temp/
│ └── ideas/ # 用户随手写的地方(原始输入)
└── progress/ # AI 整理后的地方
├── ideas.md # Ideas 收集箱
├── tasks.md # 任务列表(AI 读写)
└── reports/ # 定期报告
└── YYYY-MM-DD.md
首次使用时:如果 docs/progress/ 不存在,自动创建。
HTML 编辑器支持:
文件位置:
skills/progress-tracker/assets/tasks.html(skill 资源,勿修改)docs/progress/tasks.html(实际数据文件,由脚本生成)同步脚本:skills/progress-tracker/scripts/sync_tasks.py
# markdown -> html(AI 修改 tasks.md 后同步到 HTML)
python skills/progress-tracker/scripts/sync_tasks.py md2html
# html -> markdown(用户在 HTML 编辑器修改后同步回 md)
python skills/progress-tracker/scripts/sync_tasks.py html2md
# 验证数据一致性
python skills/progress-tracker/scripts/sync_tasks.py validate
典型工作流:
docs/progress/tasks.md(AI 侧的主要操作)md2html 生成 docs/progress/tasks.htmldocs/progress/tasks.html 拖拽排序、编辑任务html2md 同步回 markdown| 场景 | 触发词 | 动作 |
|---|---|---|
| 被动收集 | "整理 ideas"、"收集想法" | 扫描 docs/temp/ideas/ → 提取 → ideas.md |
| 主动输入 | "记一下..."、"我有个想法..." | 直接记录到 ideas.md |
| 确认想法 | "看看 ideas"、"哪些可以做" | 展示待确认 → 转化为任务 |
| 进度报告 | "总结进展"、"进度报告" | 读取 tasks.md → 生成报告 |
| 可视化编辑 | "打开任务面板"、"编辑任务" | 用 HTML 编辑器 |
| 字段 | 格式 | 说明 |
|---|---|---|
| 编号 | ### N. | 任务编号,递增 |
| 标题 | ### N. [标题] | 任务标题 |
| 来源 | **来源**: | idea #N / 用户直接指定 |
| 状态 | **状态**: | ⏳ 待开始 / 🚧 进行中 / ✅ 已完成 / ❌ 已取消 |
| 创建时间 | **创建时间**: | YYYY-MM-DD |
| 描述 | **描述**: | 任务描述 |
| 字段 | 格式 | 何时使用 |
|---|---|---|
| 优先级 | **优先级**:N | 有待排序时,数字越小优先级越高 |
| 完成时间 | **完成时间**: | 状态为✅时 |
| 取消原因 | **取消原因**: | 状态为❌时 |
| 分支名称 | **分支**:type/id-description | 需要并行开发时 |
| 分支状态 | **分支状态**:✅ 已创建 / ⏳ 未创建 | 有分支时 |
| 涉及模块 | **涉及模块**: | 跨模块任务 |
| 需求清单 | **需求清单**: | 复杂任务 |
| 背景 | **背景**: | 需要上下文时 |
| 子任务 | **子任务拆分**: | 可拆分的任务 |
| 相关文档 | **相关文档**: | 有文档时 |
| 进度 | **进度**: | 进行中的详细进度 |
| 备注 | **备注**: | 补充说明 |
[type]/[task-id]-[short-description]
类型:
feat - 新功能fix - Bug 修复refactor - 重构docs - 文档chore - 其他示例:
feat/30-agent-qualityfix/23-concurrency-racefeat/12-single-chat-continue### 30. Agent 质量提升四件套 ⭐
- **来源**:用户直接输入
- **状态**:🚧 进行中
- **创建时间**:2026-06-09
- **优先级**:1
- **分支**:feat/30-agent-quality
- **分支状态**:✅ 已创建
- **描述**:提升 Agent 响应质量和闭环能力
- **背景**:CLI 模式下 Agent 表现"降智"
- **涉及模块**:
- 后端:提示词优化、Hook 机制
- 前端:状态展示
- **需求清单**:
1. 系统提示词优化
2. 延缓闭合提醒
3. MCP 连接失败检测
4. Hook 机制
| 字段 | 格式 | 说明 |
|---|---|---|
| 标题 | ### [emoji] YYYY-MM-DD [标题] | 想法标题 |
| 来源 | **来源**: | 文件路径 / 用户直接输入 |
| 内容 | **内容**: | 想法内容 |
| 类型 | **类型**: | 灵感 / 观察 / 需求 / 问题 |
| 字段 | 格式 | 何时使用 |
|---|---|---|
| 优先级 | **优先级**: | 有待排序时 |
| 背景 | **背景**: | 需要上下文时 |
| 决定 | **决定**: | 已确认时 |
| 任务 | **任务**: | 已转化为任务时 |
| 讨论点 | **讨论点**: | 状态为❓时 |
| 原因 | **原因**: | 状态为❌时 |
| 状态 | Emoji | 说明 |
|---|---|---|
| 待确认 | 💭 | 新收集的想法 |
| 已确认 | ✅ | 可转化为任务 |
| 需要讨论 | ❓ | 有疑问需讨论 |
| 已废弃 | ❌ | 不再需要 |
| 进行中 | 🚧 | 已转化为任务,正在执行 |
步骤:
docs/temp/ideas/ 下所有 .md 文件docs/progress/ideas.md用户 vs AI 内容判断:
| 特征 | 用户编写 | AI 编写 |
|---|---|---|
| 格式 | 松散、不统一 | 整齐、有结构 |
| 内容 | 零散、跳跃 | 完整、有逻辑 |
| 标记 | 少用 emoji/checkbox | 大量使用 |
| 长度 | 短句、碎片化 | 长段落 |
处理方式:
触发:
步骤:
docs/progress/ideas.md触发:"看看 ideas"、"哪些可以做"、"确认想法"
步骤:
docs/progress/ideas.md💭 待确认 的想法根据用户反馈:
| 决定 | 操作 |
|---|---|
| 可以做 | 状态改为 ✅,创建任务到 tasks.md |
| 需要讨论 | 状态改为 ❓,记录讨论点 |
| 暂时搁置 | 保持 💭,添加备注 |
| 废弃 | 状态改为 ❌,记录原因 |
从已确认的想法创建任务:
md2html 同步到 HTML触发:"总结进展"、"进度报告"
步骤:
docs/progress/reports/YYYY-MM-DD.mdtype/id-description场景 1:主动输入
你:记一下,我想做一个 xxx 功能
AI:好的,已记录到 ideas.md
- 内容:做一个 xxx 功能
- 类型:需求
- 状态:💭 待确认
场景 2:被动收集
你:整理一下 ideas
AI:正在扫描 docs/temp/ideas/...
发现 3 个新想法,已添加到 ideas.md:
1. [06-06] xxx - 来自 temp/ideas/xxx.md
2. [06-06] yyy - 来自 temp/ideas/yyy.md
3. [06-06] zzz - 来自 temp/ideas/zzz.md
场景 3:确认转化
你:看看 ideas,哪些可以做
AI:当前有 3 个待确认的想法:
1. xxx - ...
2. yyy - ...
3. zzz - ...
哪些可以转化为任务?
你:1 和 3 可以做
AI:已创建 2 个任务:
- tasks.md #1: xxx (feat/1-xxx)
- tasks.md #2: zzz (feat/2-zzz)
已同步到 tasks.html
场景 4:可视化编辑
你:打开任务面板
AI:HTML 编辑器位于:
skills/progress-tracker/assets/tasks.html
功能:拖拽排序、优先级排序、搜索筛选、右侧面板编辑。
编辑完成后运行:
python scripts/sync_tasks.py html2md