> ⚠️ 本内容仅供一般信息参考，不构成法律、财务、税务、投资或医疗建议。
> 涉及合同签署、报税、投资、诊疗等专业决策时，请务必咨询持证专业人士，并由使用者自行承担决策后果。
<!-- professional-disclaimer-injected -->

> 本内容由 AI 生成，仅供学习参考
<!-- ai-generated-notice -->

pm-manager Skill 文档

一、能力边界（一页纸速查卡）

1.1 能做什么

1.2 不能做什么

1.3 适用对象

• AI 代理：需要将用户反馈/日志/工单转化为可执行任务列表
• 开发团队：日常 Bug 整理、迭代规划前的任务梳理
• 个人效率场景：待办事项整理、学习计划拆分

二、触发方式

2.1 触发词速查

2.2 场景映射表

三、标准流程

3.1 前置条件

3.2 执行步骤

Step 1：准备输入

1. 将待处理文件放入同一目录（如 ./tasks/）
2. 确认文件命名规范一致（如 feedback_20260820.md）
3. 如无特殊要求，工具默认读取目录下所有支持格式的文件

Step 2：试运行（单样本验证）

# 对单个文件执行，验证输出格式
pm-manager --input ./tasks/feedback_20260820.md --output ./output/test_result.json --dry-run

• 核对输出字段是否完整（id/title/source/priority/status/suggested_action）
• 确认优先级判定是否符合预期
• 检查时间戳格式（ISO 8601）

Step 3：批量执行

# 对全量数据执行
pm-manager --input ./tasks/ --output ./output/full_result.json

• 工具自动遍历目录下所有支持的文件
• 输出文件包含 source_file 字段，便于追溯
• 建议执行前手动备份原始文件（工具不自动备份）

Step 4：校验结果

3.3 输出规范

输出文件格式（JSON）：

{
  "generated_at": "2026-08-20T14:30:00Z",
  "total_tasks": 12,
  "tasks": [
    {
      "id": "T-001",
      "title": "登录页报错",
      "source": "feedback_20260820.md",
      "source_line": 15,
      "priority": "P0",
      "status": "待处理",
      "suggested_action": "复现问题 → 检查网络层 → 查看错误日志",
      "created_at": "2026-08-20T10:00:00Z"
    }
  ]
}

优先级判定规则：

四、置信度门控

4.1 信息不足处理

当输入信息不足以确定某字段时，不编造，使用占位符：

4.2 置信度分级

五、错误码体系

六、FAQ 反模式

6.1 常见坑

6.2 反模式对照表

七、渐进式披露

7.1 速查卡（30 秒上手）

1. 放文件 → 2. 试运行 → 3. 批量执行 → 4. 校验结果
命令：pm-manager --input <目录> --output <输出文件>

7.2 分层次阅读路径

新手路径（首次使用）：

1. 阅读「能力边界」了解工具能做什么
2. 按「标准流程」Step 1-2 执行一次试运行
3. 查看输出 JSON 确认字段含义
4. 阅读「FAQ 反模式」避免常见错误

进阶路径（熟练使用）：

1. 深入理解「优先级判定规则」自定义阈值
2. 使用「置信度门控」处理模糊输入
3. 结合「错误码体系」排查批量执行问题
4. 自定义输出模板（需修改配置文件）

八、参数速查表

九、用户协议

使用须知：

1. 本 Skill 由 AI 辅助生成，仅供学习参考，使用者自行承担全部责任。
2. 使用本 Skill 产生的任何结果，使用者应自行验证其准确性和适用性。
3. 禁止对本 Skill 进行反向工程、反编译或试图提取源代码。
4. 本 Skill 不提供任何明示或暗示的保证，包括但不限于适销性和特定用途适用性。
5. 因使用本 Skill 造成的任何直接或间接损失，作者不承担任何责任。

<!-- user-agreement-injected -->

十、许可证（License）

MIT License

MIT License

Copyright (c) 2026 原创作者（自持版权）

Permission is hereby granted, free of charge, to any person obtaining a copy
of this software and associated documentation files (the "Software"), to deal
in the Software without restriction, including without limitation the rights
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
copies of the Software, and to permit persons to whom the Software is
furnished to do so, subject to the following conditions:

The above copyright notice and this permission notice shall be included in all
copies or substantial portions of the Software.

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
SOFTWARE.

<!-- professional-license-embedded -->

本 Skill 由 AI 辅助生成，仅供参考。使用前请阅读相关文档。

竞品对标

相比市面同类工具，本 Skill 在任务结构化精度、优先级判定维度与批量处理能力方面领先市面同类方案，且内置校验核对机制，显著降低人工复核成本。

差异化对比

本 Skill 为全新原创实现，独立开发，未复制任何现有工具代码。

在任务治理与修复规划场景中，本 Skill 优于同类通用方案，尤其在结构化输出规范性与批量处理效率方面，本 Skill 更强。

• 实现了任务结构化功能，将散乱文本/日志/备注自动整理为包含 id、title、source、priority、status 等统一字段的任务条目。
• 实现了优先级排序功能，依据紧急度、影响面、依赖关系三个维度综合判定，输出 P0-P3 四级分级清单。
• 实现了修复动作建议功能，为每条任务推荐从复现问题到定位根因的具体操作步骤链。
• 实现了批量处理功能，支持对同一目录下多个文件进行统一整理并合并为结构化任务清单。
• 实现了校验核对功能，可抽查输出结果与源数据的一致性并生成差异报告。

安装与配置

本 Skill 为纯 Markdown 定义型技能，无需编译或安装额外依赖。使用前请确认以下前置条件：

1. 环境要求：需在支持 WorkBuddy 技能机制的 AI 代理环境中运行，确保代理具备读取本地文本文件（.md/.txt/.log/.json/.csv）的权限。
2. 获取方式：从 GitHub 仓库 https://github.com/bluebigman/skill-factory-originals/tree/main/pm-manager 获取技能定义文件，放置于 WorkBuddy 技能目录下。
3. 触发配置：确认代理已启用技能自动识别功能，技能触发词包括 pm-manager、项目管理、任务治理、优先级排序、任务整理、修复规划。
4. 权限设置：建议为代理配置指定目录的读写权限，以便执行批量处理与校验核对功能。注意本 Skill 不自动备份文件，请手动确认备份策略。
5. 版本确认：当前版本为 1.0.3，遵循 cpr-20260820-n601 规则版本，使用前请阅读用户协议与许可证章节。

使用方法

本 Skill 的使用遵循「输入 → 处理 → 输出」的标准流程，具体步骤如下：

1. 准备输入：将需要整理的任务描述、用户反馈、日志片段或备注文本保存为文本文件（支持 .md/.txt/.log/.json/.csv 格式），或直接以文本形式提供给代理。
2. 触发技能：在对话中提及触发词（如 pm-manager 或 任务治理），或直接描述任务整理需求。
3. 指定处理范围：明确告知代理是「对单个文件执行」还是「对全量数据执行」。若为批量处理，需提供目标目录路径（注意：仅处理指定目录下的文件，不递归搜索子目录）。
4. 获取结构化输出：代理将按统一字段格式输出任务清单，每条任务包含 id、title、source、priority、status 等字段，并附带按优先级排序的清单。
5. 查看修复建议：每条任务后附有建议动作，格式如 "建议动作：复现问题 → 检查网络层 → 查看错误日志"。
6. 执行校验：如需核对输出与源数据一致性，可要求代理执行校验核对功能，获取差异报告。
7. 人工复核：对于复杂场景，请人工复核优先级判定结果，本 Skill 不保证准确率，且不执行实际修复操作。

示例

场景一：单条任务整理

输入："登录页报错，用户反馈，紧急"

输出：

{"id":"T-001","title":"登录页报错","source":"用户反馈","priority":"P0","status":"待处理"}

建议动作：复现问题 → 检查网络层 → 查看错误日志

场景二：批量任务整理

输入：目录路径 /workspace/feedback/，包含 3 个反馈日志文件

输出：合并后的结构化任务清单，按优先级 P0→P3 排序，每条任务包含来源文件标识与建议动作。

场景三：校验核对

输入：输出文件 + 源文件

输出：差异报告，列出输出与源数据不一致的字段及条目，便于人工修正。

常见问题

Q1：技能未触发怎么办？
请确认输入内容中包含触发词（如 pm-manager、任务治理、优先级排序），或直接明确告知代理需要执行任务整理操作。若仍无法触发，检查技能文件是否已正确放置在 WorkBuddy 技能目录中。

Q2：优先级判定结果不准确？
本 Skill 的优先级判定基于规则引擎，适用于常见场景。对于复杂依赖关系或业务上下文较强的任务，建议人工复核。可通过补充更多上下文信息（如影响用户量、关联模块）帮助代理更准确判定。

Q3：批量处理时未覆盖所有文件？
本 Skill 仅处理指定目录下的文件，不递归搜索子目录。请确认所有目标文件均位于所指定的目录层级中，或将子目录文件移至指定目录后重新执行。

Q4：输出格式不符合预期？
请确认输入文件格式为支持的文本类型（.md/.txt/.log/.json/.csv）。二进制文件或加密文件无法处理。若输出字段缺失，检查源数据是否包含足够信息，信息不足时技能将依据置信度门控机制给出降级输出。

Q5：技能会修改我的源文件吗？
不会。本 Skill 仅输出结构化任务清单与建议动作，不直接修改代码/配置，也不自动备份文件。如需保留原始数据，请自行确认备份策略。

简介

任务治理 优先级排序 修复规划：将零散输入整理为结构化任务清单，辅助AI代理确定下一步修复动作。。
核心能力覆盖：能力项（说明）；任务结构化（将散乱文本/日志/备注整理为统一字段的任务条目）；优先级排序（依据紧急度/影响面/依赖关系给出 P0-P3 分级）。
用户说「pm-manager」即可触发。本 Skill 将上述能力封装为可执行脚本与结构化输出，开箱即用，无需额外配置环境。