feature-spec – 产品功能规格文档编写 Skill

Skill 详细介绍

anthropics/knowledge-work-plugins#feature-spec 是 Anthropic 官方 knowledge-work-plugins 仓库中的一个 Skill，路径标识为 feature-spec。从名称与仓库定位来看，它属于面向知识工作场景的 Skill 集合，核心用途是帮助用户把零散的功能想法、需求描述或产品笔记整理成结构化的功能规格说明（feature specification）。

它本身不是一个可以独立运行的软件，也不是一个 Web 服务或 CLI 工具。它更像是一套安装在 AI Agent 中的提示词与工作流指令集，安装之后，Agent 会多出一项专门处理“功能规格撰写、补全、澄清、结构化”的能力。

它是什么

• 一个面向知识工作场景的功能规格撰写 Skill。
• 属于 Anthropic 官方发布的 knowledge-work-plugins 插件集合。
• 安装后由 Agent 加载，在合适任务中触发。

它不是什么

• 不是独立应用，不需要单独启动进程。
• 不是 MCP Server，也不是 API 服务。
• 不是代码生成器，不负责直接写出可运行的功能实现。

核心功能

根据该 Skill 的命名与所属插件集合的定位，它可以承担以下类型的任务：

• 把一句模糊的功能需求扩展成完整的功能规格。
• 对已有的功能描述做结构化整理，补全缺失部分。
• 梳理目标用户、使用场景、输入输出、边界条件。
• 把讨论记录、会议纪要、产品笔记转成规格文档。
• 识别需求中的歧义点，向用户提出澄清问题。

典型使用场景

• 产品经理有一个新功能想法，想让 Agent 先写出一版规格草案。
• 开发者拿到一句模糊需求，想先让 Agent 帮忙整理清楚再动手。
• 团队会议讨论后，把零散记录整理成可评审的功能规格。
• 写 PRD 之前，先把功能范围、优先级、验收标准梳理清楚。

不适合的需求

• 直接生成完整可运行代码。
• 做代码审查或 Debug。
• 替代正式产品文档评审流程。
• 需要真实业务数据或用户调研的决策。

如果你想区分它和普通 Agent 自身能力：普通 Agent 也能写规格，但通常会缺少固定的结构模板与澄清流程。这个 Skill 的价值在于把“写功能规格”这件事变成一套相对稳定的工作方式，减少每次都要重新交代格式和关注点的成本。

Skill 安全评估

总体判断：来自 Anthropic 官方仓库，来源可信，属于提示词 / 工作流类 Skill，本身通常不包含 Shell 执行、网络请求或凭证操作逻辑。安全风险主要取决于两个方面：一是你把它放在什么样的 Agent 权限环境中运行，二是你往里面输入了什么内容。这两点才是真正需要关注的地方。

一、来源可信度

该 Skill 出自 Anthropic 官方的 knowledge-work-plugins 仓库，属于第一方发布内容。相比第三方同名 Skill、Fork 或镜像版本，官方来源的供应链风险明显更低。安装时请确认你使用的是官方仓库，而不是其他人重新打包的版本。

二、权限范围

这类知识工作 Skill 的典型行为是“读取用户提供的文本 → 生成结构化文档”。它本身不需要 Shell 执行权限、不需要网络访问权限、不需要读取系统凭证。如果发现某个版本要求这些权限，需要确认是否有额外组件。

三、文件读写

是否读写文件，取决于运行它的 Agent 如何管理输出。Skill 本身可能只生成文本内容，具体落盘由 Agent 完成。如果你担心它覆盖已有文档，可以在 Agent 中限定工作目录，或者让它先把结果输出到对话里，由你手动保存。

四、输入内容风险

这是这类 Skill 真正需要注意的地方。功能规格通常来自内部产品讨论、未发布功能、业务逻辑。把这些内容交给 AI Agent 处理时：

• 是否允许这些内容离开本地环境。
• Agent 是否会把内容发送到外部模型 API。
• 公司是否有关于内部产品信息外传的合规要求。

这些不是 Skill 自身能控制的，取决于你使用的 Agent 和模型服务。

五、Prompt Injection 风险

如果你把外部来源的文本（比如用户反馈、第三方文档）直接交给 Agent 处理，其中可能包含试图改变 Agent 行为的指令。功能规格类 Skill 通常会把输入当作内容而非指令，但不同 Agent 的实现强度不同。处理来源不明的文本时保持留意即可。

六、降低风险的建议

• 使用官方来源的 Skill，不要从非官方渠道安装。
• 处理敏感产品需求时，确认所用 Agent 和模型服务符合公司合规要求。
• 如果不希望 Agent 自动写文件，可以关闭其文件写入权限，只保留对话输出。
• 需要正式评审的规格文档，人在交给团队之前先自己过一遍。

Skill 使用要求

一、Agent / 客户端

该 Skill 出自 Anthropic 官方的 knowledge-work-plugins 仓库，与 Claude Code 的 Skills 机制高度适配，可以优先在 Claude Code 中使用。

官方没有提供完整的第三方 Agent 兼容列表。从 Agent Skill 的通用工作方式来看，在支持 Skills、自定义 Skill 或类似指令加载机制的环境中，通常也可以尝试在 Codex、Cursor、Trae、OpenClaw、WorkBuddy 等主流 AI Agent 中使用。不同 Agent 的 Skill 加载方式和兼容程度可能不同，具体以对应 Agent 当前版本为准。

二、运行环境 / 依赖

这是一个提示词 / 工作流类 Skill，官方资料中通常不要求独立的 Node.js、Python、Docker 或其他运行时。运行环境主要由你所使用的 Agent 决定。

三、权限

• 文件读取：通常可选。当 Agent 需要读取你的笔记、需求文档时才会用到。
• 文件写入：通常可选。用于把生成的规格保存成文件；不需要时可关闭。
• Shell：通常不需要。
• 网络：通常不需要（由 Skill 自身发起）。
• 浏览器 / Docker / GitHub：不需要。

四、账号 / API Key

• Skill 本身不需要单独的账号、API Key 或 Token。
• 你使用的 Agent（如 Claude Code）可能需要自己的账号或 API Key，这属于 Agent 层面的要求，与 Skill 无关。
• Skill 生成的功能规格文档中，不会要求你填入凭证。

最小使用条件

1. 一个支持 Skills 或自定义指令加载的 AI Agent。
2. 能向 Agent 提供需求描述或相关笔记的文本。
3. 如需保存结果，Agent 需具备文件写入能力（可选）。

Skill 安装、使用与卸载教程

一、安装

你可以直接使用本页面提供的 Skill 安装指令，复制后粘贴到对应 Agent 或终端中执行。

如果你不清楚自己使用的 Agent 如何安装 Skill，可以直接向当前 Agent 提问：

如何安装 anthropics/knowledge-work-plugins#feature-spec？

如何在 Claude Code 中安装 anthropics/knowledge-work-plugins#feature-spec？

如何在 Cursor 中安装 anthropics/knowledge-work-plugins#feature-spec？

让 Agent 根据自己的 Skill 加载和管理机制，给出适合当前版本的安装方式。不同 Agent 的安装路径、配置方式不同，以 Agent 自身给出的说明为准，不要照搬其他 Agent 的安装命令。

二、安装后如何使用

安装完成后，通常不需要记忆固定命令。你只需要在对话中描述清楚任务，Agent 会在合适场景下加载该 Skill。

适合交给它的任务类型：

• 把一句模糊需求扩展成完整规格。
• 整理会议记录或产品笔记为规格文档。
• 梳理功能的目标用户、使用场景、边界条件。
• 对已有规格做结构化补全或澄清。

自然语言使用示例：

使用 feature-spec，把我这段关于「团队邀请流程」的想法整理成一份功能规格。

使用 feature-spec，帮我梳理这个新功能的边界条件、异常情况和验收标准。

使用 feature-spec，把这份会议纪要转成可以给研发评审的功能规格文档。

三、卸载

卸载方式取决于你所使用的 Agent 的 Skill 管理机制。通常可以：

• 使用对应 Agent 或 Skill 管理器提供的删除 / 移除功能。
• 直接删除对应的 Skill 文件或目录。
• 询问当前 Agent：

如何卸载 anthropics/knowledge-work-plugins#feature-spec？

不同 Agent 的 Skill 安装位置和管理方式可能不同。如果没有统一的卸载命令，直接向当前 Agent 询问如何移除是最稳妥的做法。

常见问题

1. 可以同时安装到多个 Agent 吗？

可以。Skill 本质上是一组文件，你可以在 Claude Code、Cursor 等不同 Agent 中分别安装。不同 Agent 的安装位置和管理方式独立，互不影响。

2. 更新 Skill 后需要重新安装吗？

取决于你使用的 Agent 如何处理 Skill 版本。如果 Agent 支持从源仓库自动拉取最新版本，通常不需要手动重装。如果是手动复制的文件，需要自己重新同步最新版本。

3. 安装后 Agent 没有识别到这个 Skill，怎么办？

可以先检查：Skill 文件是否放在 Agent 期望的 Skill 目录中；Agent 是否需要在配置中显式启用；Agent 是否需要重启或重新加载。仍然不行时，直接问 Agent：「为什么没有加载 anthropics/knowledge-work-plugins#feature-spec？」

4. 中国大陆使用有网络要求吗？

Skill 本身不额外联网。网络要求主要由你使用的 Agent 和模型服务决定。如果 Agent 依赖境外 API，相关网络连通性需要自行确认。

5. 它会修改我已有的项目文件吗？

不会主动修改。它生成的是文本内容，是否落盘由 Agent 决定。如果你不希望它写文件，可以关闭 Agent 的文件写入权限，只保留对话输出。

6. 和让 Agent 直接写规格有什么区别？

普通 Agent 也能写规格，但每次都需要你交代格式和关注点。这个 Skill 的价值在于把「写功能规格」的过程相对固定下来，通常包含固定的结构、澄清流程和补全维度，减少重复沟通成本。

7. 适合直接用于生产环境的正式 PRD 吗？

可以把它当作起草和结构化的辅助工具。正式 PRD 通常还需要结合真实用户调研、业务背景和团队评审，Skill 输出更适合作为初稿或讨论起点。