policy-lookup 技能深度解析在 Claude Cowork 中构建企业政策自助查询 Agent【免费下载链接】knowledge-work-pluginsOpen source repository of plugins primarily intended for knowledge workers to use in Claude Cowork项目地址: https://gitcode.com/GitHub_Trending/kn/knowledge-work-plugins本篇技术指南以 knowledge-work-plugins 仓库中 human-resources/skills/policy-lookup/SKILL.md 为绝对主体系统讲解 HR 插件中/policy-lookup斜杠命令的技能定义、双模式工作架构、政策主题覆盖、标准回答流程与输出模板并结合仓库内的 CONNECTORS.md 与 README.md 还原连接器占位符约定与插件安装方式。读完本文你将掌握如何在 Claude Cowork 中落地一个员工随口提问、Agent 自动查证、引用原文作答的政策查询技能并能独立复刻或改造这一技能骨架。一、技能定位一个面向 HR 场景的斜杠命令在 human-resourcesPeople Operations插件中policy-lookup被定义为一个显式工作流命令。插件 README 的命令清单将其描述为Find and explain company policies — PTO, benefits, expense, travel, remote work即查找并解释公司政策覆盖 PTO、福利、费用、差旅、远程办公等主题。与其并列的同类命令包括/draft-offer起草 Offer、/onboarding新员工入职、/performance-review绩效评审、/comp-analysis薪酬分析、/people-report人事报表详见 README.md 的 Commands 小节。从 SKILL.md 的 YAML frontmatter 可以看到技能的关键元数据这是 Agent 路由与触发判断的依据--- name: policy-lookup description: Find and explain company policies in plain language. Trigger with whats our PTO policy, can I work remotely from another country, how do expenses work, or any plain-language question about benefits, travel, leave, or handbook rules. argument-hint: policy topic — PTO, benefits, travel, expenses, etc. ---三个字段各有分工name技能唯一标识即斜杠命令名description告诉模型何时该调用本技能并显式给出三个触发例句PTO 政策、异地远程办公、费用报销全部是自然语言问句而非关键词argument-hint提示用户调用时应补充的参数形态即政策主题PTO、福利、差旅、费用等。这种name description argument-hint的三段式 frontmatter 在仓库内并非孤例例如 draft-offer/SKILL.md 采用完全一致的结构argument-hint: role and level说明这是整套 HR 插件统一的技能声明规范。二、调用方式与参数语义技能的使用方式是标准的斜杠命令语法/policy-lookup $ARGUMENTS$ARGUMENTS即用户在命令后输入的政策主题或问题。Agent 收到命令后的首要动作是Search for policies matching: $ARGUMENTS——即把用户的参数当作检索条件去知识库中匹配政策文档。命令的语义强调用日常语言提问而非堆砌术语。原文档的 Tips 给出了正反两个例子✅ Can I work from Europe for a month?我能在欧洲工作一个月吗——自然的问句❌ international remote work policy——生硬的文档式关键词。同理问题越具体检索越精准✅ PTO for part-time employees in California加州兼职员工的 PTO❌ PTO policy笼统的 PTO 政策。这一设计背后的原因是员工实际提问时并不知道公司手册的章节划分与官方措辞技能的价值正在于把口语化问题翻译成对政策文档的检索再翻译回员工能听懂的回答。三、双模式工作架构Standalone 与 Supercharged原文档用一个 ASCII 架构图说明了本技能的核心运行模式。将其结构化还原如下运行模式能力前提Standalone纯独立模式始终可用用自然语言提问任何政策问题把员工手册内容粘贴给 Agent 后即可检索获得清晰、无术语的行话解释无需任何工具接入Supercharged增强模式接入知识库后自动检索员工手册与政策文档接入 HRIS 后拉取员工个性化信息PTO 余额、福利参保情况通过 MCP 连接对应工具两种模式并不互斥而是递进关系Standalone 保证技能开箱即用Supercharged 则在连接工具后把回答从通用政策升级为基于该员工本人数据的个性化答案。这一设计是整套 HR 插件的通用哲学。README 的 Standalone Supercharged 表格中/policy-lookup对应的一行是What You Can DoStandaloneSupercharged WithPolicy lookupPaste handbook contentKnowledge base即独立模式下用户负责粘贴手册内容增强模式下由知识库自动完成检索。粘贴即用、连接即强是理解本技能乃至整个仓库的钥匙。四、覆盖的常见政策主题原文档列出的政策主题范围相当完整覆盖员工高频咨询的七大类。逐类展开如下主题类别覆盖内容典型提问PTO and Leave休假年假、病假、育儿假、丧假、学术休假sabbatical我们公司的育儿假是几周Benefits福利医疗保险、牙科、视力、401k、HSA/FSA、健康计划HSA 和 FSA 怎么选Compensation薪酬发薪周期、奖金发放时点、股权归属vesting、费用报销报销流程怎么走Remote Work远程办公WFH 政策、远程地点限制、设备补贴、共享办公我能去国外远程办公一个月吗Travel差旅预订政策、每日津贴per diem、费用申报、审批流程出差订酒店有什么标准Conduct行为准则行为准则、骚扰政策、利益冲突接受供应商赠礼有规定吗Growth成长发展职业发展预算、参会政策、学费报销外部培训费用能报销吗在实际配置层面HR 插件允许通过settings.local.json预置公司级政策要点让技能在未连接知识库时也能给出基础回答。README 中的示例配置片段{ company: Your Company, benefits: { healthInsurance: Provider Name, pto: Unlimited / X days, parentalLeave: X weeks } }这些字段如pto、parentalLeave与上表的 PTO/Leave、Benefits 主题一一对应说明配置层与技能层在主题划分上是刻意对齐的。该文件在 Cowork 中放入共享文件夹即可被自动发现在 Claude Code 中则放在human-resources/.claude/settings.local.json。五、标准回答流程How to Answer原文档给出了五步回答流程这是技能运行时的核心执行逻辑搜索知识库找到相关的政策文档给出清晰、通俗的回答plain-language answer引用政策原文给出具体措辞标注例外情况与特殊场景指出边界情况的联系人谁负责处理文档之外的问题。围绕这五步原文档特别强调了三条必须遵守的护栏Guardrails这是本技能在合规与准确性上的底线Always cite the source document and section—— 回答必须引用来源文档与章节If no policy is found, say so clearly rather than guessing—— 找不到政策时必须明确告知未找到严禁臆测编造For legal or compliance questions, recommend consulting HR or legal directly—— 涉及法律或合规问题时直接建议员工咨询 HR 或法务。这三条护栏本质上定义了技能的能力边界policy-lookup是检索器 翻译器而不是政策制定者。它只负责把已存在的政策讲清楚绝不越权发明政策也不对法律问题下结论。六、输出模板详解原文档为技能规定了标准化的 Markdown 输出模板保证每一次回答结构一致、便于员工快速定位信息。完整模板如下## Policy: [Topic] ### Quick Answer [1-2 sentence direct answer to their question] ### Details [Relevant policy details, explained in plain language] ### Exceptions / Special Cases [Any relevant exceptions or edge cases] ### Who to Contact [Person or team for questions beyond whats documented] ### Source [Where this information came from — document name, page, or section]五个区块各司其职与五步回答流程严格对应输出区块对应流程步骤设计意图Quick Answer第 2 步先给 12 句话的直接答案满足快速获取结论的需求Details第 23 步展开政策细节用通俗语言解释并引用原文Exceptions / Special Cases第 4 步明确列出例外与边界情形避免员工误读为普适条款Who to Contact第 5 步指向文档之外的咨询对象HRBP、福利专员等Source第 1 步引用标注文档名、章节或页码落实必须引用来源的护栏这个模板是先结论、后细节、再例外、留出口、标出处的经典客服式信息架构——员工只需扫一眼Quick Answer就能获得答案深入阅读则按需展开同时Source保证了任何回答都可溯源核验。七、连接器增强机制从占位符到真实工具原文档中反复出现~~knowledge base与~~HRIS两个带双波浪线的占位符。理解这套约定是使用增强模式的前提。占位符约定的设计原理根据 human-resources/CONNECTORS.md 的说明插件文件用~~category作为该类工具的占位符——例如~~HRIS可能对应 Workday、BambooHR 或任何提供 MCP 服务器的 HRIS。插件本身是**工具无关tool-agnostic**的工作流只按类别描述HRIS、ATS、知识库、邮件等而不绑定具体产品用户连接该类别的任意 MCP 服务器均可生效。knowledge base知识库若连接了~~knowledge base技能将自动获得两项能力自动搜索员工手册与政策文档无需再手动粘贴内容引用时给出具体文档、章节与页码回答的可信度与可核验性大幅提升。CONNECTORS.md 给出的该类目可选服务器包括Notion、Atlassian (Confluence)内置以及Guru、Coda其他可选。这些都是企业常用的政策文档承载平台。HRIS人力资源信息系统若连接了~~HRIS技能将进一步获得员工个性化数据PTO 余额PTO balance福利选择情况benefits elections参保状态enrollment status。这意味着回答可以从公司的育儿假是 X 周升级为根据你的档案你已参保 Y 计划当前 PTO 余额为 Z 天。CONNECTORS.md 列出的可选 HRIS 包括Workday、BambooHR、Rippling、Gusto。注意一个细节仓库内其他技能的If Connectors Available小节与 policy-lookup 保持同样的结构例如 draft-offer/SKILL.md 在连接~~HRIS后可拉取薪酬带宽数据、校验编制审批、自动填充福利细节连接~~ATS后可拉取候选人信息并更新 Offer 状态。这印证了占位符 工具无关是整套插件的统一约定。八、在 HR 插件生态中的协同定位/policy-lookup并非孤立命令它与 HR 插件的其他能力存在明确的协同关系自然语言触发与显式调用的双入口README 的 Example Workflows 中Understanding Benefits了解福利一节展示了无需斜杠命令的用法——直接问Whats our parental leave policy?相关技能会自动触发并检索已连接的知识库作答。即员工既可以用/policy-lookup显式调用也可以不输入命令、纯口语提问让模型自主路由到本技能。与配置文件的联动settings.local.json中预置的benefits等字段见 README.md 的 Settings 小节在未连接知识库时可作为回答的基础素材插件在未配置时会以交互方式向用户询问这些信息保证技能始终可用。输出模板的家族相似性/draft-offer等同类命令同样采用结构化 Markdown 区块 If Connectors Available 增强说明 Tips的文档骨架说明 policy-lookup 的模板化输出是整个插件可维护、可扩展的设计基础。九、使用技巧与实战建议原文档最后给出了两条使用技巧结合前文分析可进一步提炼出可落地的实践要点用自然语言提问——Can I work from Europe for a month? 优于 international remote work policy。口语化的问句既降低了员工的使用门槛也为 Agent 提供了更丰富的语义线索用于检索匹配。让问题足够具体——PTO for part-time employees in California 明显优于 PTO policy。具体的约束条件人群 地域 主题能让检索精准命中对应章节也方便Exceptions / Special Cases区块准确呈现边界情形。在工程实践层面若要复刻本技能可以遵循仓库内沉淀的以下模式用三段式 frontmatter 声明技能元数据并在description中植入 3 个以上真实触发例句用 ASCII 图或结构化列表在文档开头交代 Standalone/Supercharged 双模式让使用者或模型一眼理解能力边界固定五步回答流程 三条护栏把引用来源、不臆测、法律问题转介写成强制约束用五区块 Markdown 模板统一输出结构确保机器可解析、员工可速读用~~category占位符声明可增强点保持工具无关性任何同类 MCP 服务器接入即可生效。结语policy-lookup是一个小而完整的 Agent 技能范本它用约百行 Markdown 定义了一个具备触发语义、检索流程、回答规范、输出模板与工具增强接口的完整技能。对希望在企业知识管理场景中落地 AI 助手的开发者而言human-resources/skills/policy-lookup/SKILL.md 连同 human-resources/CONNECTORS.md、human-resources/README.md 构成了可直接参考的三件套技能本体定义行为连接器文档定义集成边界README 定义安装与配置入口——三者结合即可在 Claude Cowork 中交付一个有据可查、答必引源的企业政策查询 Agent。【免费下载链接】knowledge-work-pluginsOpen source repository of plugins primarily intended for knowledge workers to use in Claude Cowork项目地址: https://gitcode.com/GitHub_Trending/kn/knowledge-work-plugins创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考