技能使用指南

project-health（项目健康检查）Skill 是什么？如何一键扫描项目阻塞与停滞？

项目健康检查Skill（project-health）能一键扫描 04-Projects 下的所有活跃项目，从活动时间、周优先级、阻塞情况与下一步行动四个维度给出绿黄红三色仪表板，帮助你在周计划与会议前快速定位停滞和卡住的项目。本文详解安装步骤、使用方法、竞品对比与典型场景，帮你把项目巡检从半小时压缩到一句话，立即上手试试。

项目健康检查Skillproject-health
10 个章节 约 13 分钟阅读 AI 智能生成

项目健康检查Skill：一次扫描，看清所有活跃项目的停滞、阻塞与下一步

  • 一句话定义：这是一个面向 Markdown 项目库的「项目巡检员」，自动扫描 04-Projects/ 下的每个项目，判断它是健康、停滞还是阻塞，并输出一张带颜色状态的项目健康仪表板。
  • 核心判断逻辑：从活动水平、周优先级、阻塞情况、下一步行动清晰度四个维度打分，7 天无活动为黄色、14 天为红色，任何已记录的阻塞直接判定为红色。
  • 输出即结论：直接产出一张 Markdown 表格（项目 / 状态 / 问题 / 距上次活动天数）加一行汇总统计，一眼看清有几个绿、几个黄、几个红。
  • 典型用法：每周计划前、一对一会议前、或者「感觉自己和大目标脱节」的时候，让 AI 帮你做一次全量体检。
  • 零侵入：只读项目目录和 00-Inbox/Weekly_Plans.md，不会改动你的项目笔记内容，仅在 System/usage_log.md 记录一次使用痕迹。

1. 该技能叫什么？如何一键安装 AI 技能提升开发效率？

技能中文名：项目健康检查Skill 技能英文名：project-health 技能ID：11899

它解决的问题非常具体：当你同时推进多个项目时，最危险的状态不是「忙」，而是「不知道哪个项目已经悄悄烂掉了」。有的项目两周没人碰，有的项目卡在等某个人回复，有的项目看起来在推进但根本没有明确的下一步行动——这些信息散落在几十个文件夹里，人工巡检成本极高，于是往往没人做。这个技能把「巡检」这件事变成一句话指令。

一键安装的思路与步骤

安装前提：

  1. 你使用的 AI 客户端/Agent 环境需要支持「AI 技能（Skill）」机制，能够加载技能描述文件并允许其读取本地文件；
  2. 你的笔记或项目库采用该技能约定的目录结构——项目放在 04-Projects/，周计划放在 00-Inbox/Weekly_Plans.md，系统文件放在 System/；
  3. 技能需要具备读取本地目录和文件的能力（部分客户端需要你显式授权工作目录）。

安装步骤：

  1. 打开你所使用平台的技能市场、技能库或插件中心（具体入口名称与位置以官方说明为准）；
  2. 在搜索框中输入技能名称 project-health，或直接输入技能ID 11899 进行精确查找；
  3. 点击安装/添加，将技能启用到你当前的工作空间或项目库所在的工作目录（具体安装命令与授权方式以官方说明为准）；
  4. 确认技能已出现在你的已启用技能列表中。

验证是否生效：

安装完成后，回到对话中直接说一句「检查一下我的项目健康度」，如果技能生效，它应当先列出 04-Projects/ 中的项目清单，再逐个检查活动时间、周优先级、阻塞词与下一步行动，最后输出一张「项目健康仪表板」表格。若它只是泛泛而谈而没有读取你的目录，说明技能未启用或目录未授权——此时检查授权范围即可。

这种「一键安装 AI 技能」的思路，本质上是把一套固定的巡检方法论（什么算停滞、什么算阻塞、输出什么格式）固化下来，你不需要每次重复描述规则，装一次，之后每次调用都拿到一致口径的结果。

2. 该技能的主要功能和特点

  • 全量项目扫描：自动列出 04-Projects/ 下的所有项目文件夹或文件，不遗漏、不靠记忆。
  • 活动水平判定：读取每个项目的最后修改时间，超过 7 天没有活动标记为 🟡 黄色，超过 14 天标记为 🔴 红色，量化「多久没动」。
  • 周优先级存在性检查：扫描 00-Inbox/Weekly_Plans.md 中是否提及该项目，超过 2 周没有任务即判为黄色，识别「项目还在但已经不在你的注意力里」。
  • 阻塞识别：在项目笔记中检索「阻塞」「等待」「卡住」等词，只要存在记录在案的阻塞，直接升为红色——这是最需要人工介入的信号。
  • 下一步行动清晰度检查：判断项目是否有明确的下一步行动，没有则标记黄色，避免「看起来在推进、实际无方向」的假活跃。
  • 结构化仪表板输出：固定输出 Markdown 表格，含项目、状态、问题、距上次活动天数四列，并附一行 N 个项目（X 🟢 / Y 🟡 / Z 🔴） 的汇总。
  • 三色状态统一口径：🟢 绿色 = 活跃、下一步明确、无阻塞；🟡 黄色 = 停滞 7–14 天，或无活跃任务，或下一步不明确；🔴 红色 = 有阻塞，或停滞超过 14 天。
  • 附带后续行动建议：对黄色项目建议「加进本周优先级、澄清下一步」，对红色项目建议「定位阻碍、必要时升级处理、或干脆暂停/归档」。
  • 静默使用记录：仅在你选择加入分析时，更新 System/usage_log.md 并上报 projects_reviewed、blockers_found 两项统计；若返回 analytics_disabled 则不做任何操作。

和普通任务管理工具相比，它强在两点：一是判定规则透明可解释（为什么红、为什么黄，仪表板里写得明明白白），二是它直接读你的原始笔记，不需要你先花时间把项目状态手工录入到另一个系统里。

3. 如何使用该技能？

步骤 1：确认目录就绪 确保你的工作库中存在 04-Projects/ 目录，且项目以文件夹或文件形式放在其中；周计划文件位于 00-Inbox/Weekly_Plans.md。

步骤 2：用自然语言发起调用 常见调用方式举例：

  • 「帮我做一次项目健康检查」
  • 「扫描所有活跃项目，看看哪些停滞或阻塞了」
  • 「本周计划前，先给我一张项目健康仪表板」

步骤 3：技能自动执行扫描 它会先执行目录列举（对应技能内置的 ls -la 04-Projects/ 流程），再对每个项目依次做四项检查：最后修改时间、周计划提及情况、阻塞关键词、下一步行动是否存在。

步骤 4：读取输出结果 你会得到类似下面这样的仪表板（项目名为示意）：

项目健康仪表板

项目 状态 问题 距上次活动天数
官网改版 🟢 正常进行 2
数据看板重构 🟡 无活跃任务 8
客户交付系统 🔴 阻塞 - 等待第三方接口权限 15

总结： 3 个项目（1 🟢 / 1 🟡 / 1 🔴）

步骤 5：按颜色采取行动

  • 对黄色项目：把任务补进本周优先级，或在项目笔记中写清下一步行动；
  • 对红色项目：找出具体阻碍因素，需要时升级处理，或者果断决定暂停/归档。

步骤 6（可选）：追问细节 如果某个红色项目你想深入了解，可以继续追问「客户交付系统具体卡在哪一步」，让技能回到该项目笔记中定位阻塞描述所在位置。

4. 同类型竞品对比分析

方案名称 定位 核心功能 安装/使用门槛 适用场景 优势与不足
项目健康检查Skill（project-health） 面向本地 Markdown 项目库的自动化巡检技能 活动时间、周优先级、阻塞词、下一步行动四维检查 + 三色仪表板 需支持 Skill 的 AI 环境，且目录结构符合约定；安装入口与命令以官方说明为准 个人或多项目并行的周度复盘、会议前准备 优势：零录入、规则透明、输出格式统一；不足：依赖约定的目录结构与命名，非该结构的库需先整理
人工逐个翻看项目笔记 传统手工巡检 靠人阅读和记忆判断状态 无技术门槛，但时间成本高 项目数量少（3 个以内）时 优势：灵活、能捕捉语义细节；不足：不可持续，项目一多就流于形式，且判断标准每次都不一样
通用看板类项目管理工具 任务流转与可视化 卡片状态、截止日期、提醒通知 需注册账号并把任务逐条录入 团队协作、需要多人同步进度 优势：可视化强、协作能力好；不足：状态靠人工维护，一旦不更新就失真，且与你的原始笔记是两套数据
通用 AI 助手直接对话询问 无技能封装的临时提问 你描述现状，AI 给建议 最低，直接开聊 临时性、一次性的项目梳理 优势：无需安装；不足：每次都要重复描述规则，输出格式不固定，且通常不会主动读取你的项目目录

5. 该技能的典型应用场景与实际体验情况

场景一：每周计划会议前的例行体检 角色：同时推进 5–8 个项目的独立开发者或小团队负责人。 痛点：制定周计划时凭印象挑项目，结果总是优先处理「最近在做的」，长期停滞的项目被无限推后。 使用方式：每周固定时间说一句「做一次项目健康检查」，拿到仪表板后，把所有黄色项目拉进 Weekly_Plans.md。 实际体验：上手几乎没有学习成本，第一次运行就能拿到结构化结果。需要注意：如果你的项目笔记里从不写「下一步行动」，黄色项目会偏多，这不是技能误判，而是暴露了记录习惯问题。

场景二：一对一会议前的准备 角色：带人的技术负责人。 痛点：会前想快速知道下属负责的项目哪些卡住了，但翻笔记要花二十分钟。 使用方式：会前调用一次，重点看红色项目列出的阻塞原因，直接把「阻塞 - 等待 X」作为会议开场话题。 实际体验：效果取决于项目笔记中对阻塞的记录是否及时。技能是靠检索「阻塞」「等待」「卡住」等词来判断的，如果阻塞只存在于口头沟通中，就会漏检——所以它同时也在倒逼你把阻塞写下来。

场景三：长期多项目并行后的「脱节感」自救 角色：被日常琐事淹没的开发者。 痛点：隐约觉得有些项目已经停摆，但说不清是哪几个、停了多久。 使用方式：任意时刻发起扫描，用「距上次活动天数」这一列直观看到时间都去哪了。 实际体验：这一列数字的冲击力很强，14 天、21 天这样的数字会直接推动你做「暂停还是继续」的决策，比模糊的焦虑有用得多。

场景四：决定下一步做什么时的客观依据 角色：自由职业者或斜杠工作者。 痛点：多个项目都能做，选择困难。 使用方式：扫描后优先处理红色项目中的阻塞项，其次给黄色项目补上明确的下一步行动。 实际体验：三色分级让优先级判断有了客观依据，而不是靠当天心情。建议配合每周固定节奏使用，单次使用的价值有限，长期坚持才能形成「项目不腐烂」的惯性。

6. 该技能能为用户带来的价值

  • 把巡检从「想起才做」变成「一句话就能做」：原本需要半小时以上的逐个翻看，压缩为一次调用，时间成本下降一个数量级。
  • 统一判断口径：7 天黄、14 天红、有阻塞即红——规则写死在技能里，避免了「今天心情好就都算健康」的自我欺骗。
  • 提前暴露风险：阻塞项目在变成事故之前就被标红，而不是等到交付日才发现卡了两周。
  • 降低决策成本：仪表板把「我该做什么」转化为「先处理红色、再补黄色」，减少选择内耗。
  • 倒逼记录习惯：由于判断依赖笔记中的下一步行动与阻塞描述，长期使用会自然形成更规范的项目记录方式，这是一份可累积的长期资产。
  • 零侵入、可回退：不修改你的项目内容，只在 System/usage_log.md 留一条使用记录，且分析上报需你主动选择加入，对隐私敏感的用户也友好。

7. 常见问题 FAQ

Q1：怎么安装这个技能？需要付费吗？ A：在支持 AI 技能的平台中，通过技能市场/技能库搜索 project-health 或技能ID 11899 安装，具体入口、命令与授权方式以官方说明为准。至于是否收费，取决于你所使用平台的技能计费策略，请以官方说明为准。

Q2：我的项目不在 04-Projects/ 目录下，还能用吗？ A：该技能默认按 04-Projects/ 扫描项目、按 00-Inbox/Weekly_Plans.md 检查周优先级。如果你的目录结构不同，可以先调整目录或在调用时说明你的实际路径，让技能按你的结构执行；若差异较大，建议先做一次目录整理。

Q3：它会不会修改我的项目笔记？ A：不会。整个流程以读取和检查为主，唯一的写入动作是更新 System/usage_log.md 记录使用情况，且分析上报仅在你选择加入时才触发，返回 analytics_disabled 时不做任何操作。

Q4：为什么我的项目被标成黄色，但它其实一直在推进？ A：黄色有三种可能：停滞 7–14 天、连续 2 周以上没有出现在周计划中、或者项目笔记里没有明确的下一步行动。如果是第三种，问题出在记录上——补上一句「下一步做什么」，下次扫描就会恢复正常。

Q5：它和看板类项目管理工具比，该选哪个？ A：如果你主要用 Markdown 笔记管理个人项目，且不想额外维护一套任务系统，选这个技能更省事；如果团队需要多人实时协作、卡片流转和通知提醒，看板工具更合适。两者也可以并存：看板管协作，技能管你个人笔记库的健康度。