「功能说明」Skill 场景实录：一次完整任务怎么跑

产品经理与项目经理经常要做「功能说明」这类事：撰写单个功能的详细说明。每次都从头写提示词，结果时好时坏；把它做成智能体 Skill，就能让智能体每次按同一套步骤执行，输出结构也更稳定。

背景（虚构）

阿周是一名产品经理，每周都要做几次功能说明。过去靠复制粘贴提示词，结果不稳定。这次团队把它做成了技能，下面记录一次完整运行。

1. 发出请求

阿周在文档、看板与会议工具中输入：

这是今天的功能想法，按团队的功能说明流程处理一下。

2. 技能被触发

智能体根据技能描述判断任务匹配，加载「功能说明」的完整指令。它不需要外部工具，直接按指令处理。

3. 描述场景

智能体完成“描述场景”，并在中间结果里注明依据，方便阿周回看。

4. 写交互流程

这一步的产出会作为下一步的输入。智能体在“写交互流程”时遇到一处含糊的信息，没有自行猜测，而是标注出来等待确认。

5. 写边界情况

这一步的产出会作为下一步的输入。智能体在“写边界情况”时遇到一处含糊的信息，没有自行猜测，而是标注出来等待确认。

6. 定义埋点

智能体完成“定义埋点”，并在中间结果里注明依据，方便阿周回看。

7. 交付与复核

智能体交付功能说明，末尾列出两条需人工确认的内容。阿周对照原始功能想法抽查关键信息，修正一处表述后采用。

复盘：这次做对了什么

• 步骤写在技能里，没有遗漏
• 不确定处被标出，而不是被编造
• 遵守了「优先级与对外承诺需要团队确认」
• 风险较低，但输出仍需快速过目再使用

可以改进的地方

阿周发现智能体对团队内部术语理解不一致，于是在技能目录中加了一份术语表（reference.md），并在 SKILL.md 中写明“遇到术语先查表”。更多改法见定制指南。

平台选择建议

同一个「功能说明」技能可以落在不同平台上，选择时主要看你在哪里工作、要不要执行代码、要不要接外部系统：

• n8n AI Agent：n8n 是可自托管的工作流自动化工具。详见n8n AI Agent 版
• Claude 应用中的 Skills：在 Claude 的网页或桌面应用里。详见Claude 应用中的 Skills 版
• LangChain / LangGraph 工具：LangChain 用 @tool 装饰器把函数变成工具。详见LangChain / LangGraph 工具 版

这个技能纯指令型，不需要额外脚本或外部连接，复制到大多数平台都能用，可据此排除不支持相应能力的平台。

智能体与人的分工

技能不是把工作全部交出去，而是把重复、机械的部分交给智能体，人把住判断和责任：

风险较低，但输出仍需快速过目再使用。

延伸阅读

• 功能说明 · 极简与进阶
• 功能说明 · 定制指南
• 功能说明 · Function Calling 版
• 工作分解 · 场景实录
• 工作量估算 · 场景实录
• 智能体Skills 分类：625 个技能 × 32 个角度

说明：文中的配置、代码与目录结构均为示意，用于说明思路；各平台的入口、字段名与能力会更新，落地前请以对应官方文档为准。示例中的数据与场景为虚构，不代表真实案例。