新闻详情

新闻详情

首页 / 资讯中心 / 详情

Product-Manager-Skills v0.81 技术复盘:Skill Input 输入约定、`$ARGUMENTS` 禁用决策与库漂移自动检查

发布时间:2026/9/29 2:18:25来源:尧图网络
Product-Manager-Skills v0.81 技术复盘:Skill Input 输入约定、`$ARGUMENTS` 禁用决策与库漂移自动检查
AI 技能AI 插件【免费下载链接】Product-Manager-SkillsProduct Management skills framework built on battle-tested methods for Claude Code, Cowork, Codex, and AI agents.项目地址https://gitcode.com/gh_mirrors/pr/Product-Manager-Skills点击查看免费下载导读本文基于仓库根目录交接文档 04JUL26.md 及配套发布公告 2026-07-04-v0-81-input-sections.md完整还原 Product-Manager-Skills 库在 v0.812026 年 7 月 4 日的版本状态与三项核心工程决策为全部 55 个 skill 强制引入## Input输入章节、在技能体内明确禁用 Claude Code 的$ARGUMENTS模板语法、以及新增库漂移检查脚本让文档与仓库内容永远同步。读完你将对这套 Pedagogic-first教学优先 技能库的 Skill 结构规范、校验脚本链check-skill-metadata.py→test-a-skill.sh --smoke→check-library-drift.py→ CI 发布流水线以及孤儿提交导致的技能丢失教训有源码级的完整理解。一、v0.81 版本快照55 个技能 6 个命令的仓库现状按 04JUL26.md 的记录v0.81 于 2026 年 7 月 4 日发布commit、tag、release 资产全部就绪CI 绿灯。当时技能库规模为55 个 skills按类型拆分为23 个 component组件型可复用的 PM 交付物模板如 user-story、定位声明、PRD 章节等25 个 interactive交互型通过自适应提问收集上下文并给出推荐如 discovery-interview-prep7 个 workflow工作流型编排多个技能的多阶段端到端流程。外加6 个 commands命令型能力位于 commands/。发布公告 2026-07-04-v0-81-input-sections.md 交代了这一版的出发点其他技能库普遍提供INPUTS区块与$ARGUMENTS模板化参数本库是否在用户输入引导上有所缺失答案是一半是、一半否——缺口真实存在此前没有任何 skill 告诉用户该带什么上下文、以及预置上下文会被如何处理但其他库采用的修复手段$ARGUMENTS模板对本库而言是错误的修复理解为什么错正是这一版最有价值的部分。二、核心约定一每个 Skill 的## Input章节强制、位于 Purpose 与 Key Concepts 之间v0.81 最大的结构性变化是每个 skill 都必须包含一个## Input章节位置固定于 Purpose 与 Key Concepts 之间且由校验器强制检查。这不仅作用于 55 个既有技能文件还同步覆盖了校验脚本、作者向导、模板与贡献者文档。以 discovery-interview-prep/SKILL.md 的 Input 章节为例其标准结构如下**Works best with:**主体说明该技能最需要的核心输入。例如你的研究目标——你需要从客户那里学到什么**Also useful:**可选增强能让输出更精准的补充上下文如客户细分、访问约束、已携带的假设inline-input 规则逐字约定随调用提供的任何内容——技能名后的文本、粘贴的上下文转储、或追加的ARGUMENTS:行——都视为已给出的答案。技能应直接使用它并跳过已覆盖的部分不得重新询问**Arriving empty-handed? That works too.**空手到达兜底说明引导式流程会从第一个问题开始带你补齐。以discovery-interview-prep为例技能会先询问你的首要访谈目标然后通过追问逐步收窄示例调用给出 12 个示范如Prep interviews to understand why enterprise customers churn after 6 months — I can get 5 interviews in 2 weeks.2.1 邀请而非门禁Invitation, not Gate原则交接文档强调这是承重决策load-bearing decision而非偏好Input 章节是邀请不是门禁任何内容都不能被标注为 Required。用户读完该章节后必须确信即使什么都不带技能也会引导他完成。文档记录了一个具体背景——初稿曾使用 Provide: 措辞被维护者 Dean 明确驳回。这一原则同时是 v0.75 Pedagogic-first教学优先 立场的自然延伸剥离教学脚手架learning scaffolding属于缺陷Input 约定是该原则的扩展而非独立规则。两个教学意图并重技能既要指导 Agent 执行也要让人类 PM 看懂一个规范的请求长什么样。2.2 交互型技能的 7 段式 Skill 解剖结构Input 加入后技能正文的解剖结构固化为7 个章节、顺序强制Purpose目的Input输入v0.81 新增Key Concepts核心概念Application应用Examples示例Common Pitfalls常见陷阱References参考该顺序由 check-skill-metadata.py 的REQUIRED_SECTIONS列表第 42-50 行与check_required_sections()第 84-106 行验证先用正则提取全部##二级标题检查七个章节是否都存在再验证它们在文档中出现的相对顺序与规定顺序一致positions ! sorted(positions)即报section_order_invalid。2.3argument-hintfrontmatter唯一的模板语法豁免虽然技能体内禁用$ARGUMENTS但 frontmatter 中的argument-hint字段是唯一获批的例外专为 Claude Code 的自动补全服务。53 个技能已携带该字段例如discovery-interview-prepargument-hint: [research goal]agent-orchestration-advisorargument-hint: [workflow or task to orchestrate]Claude Code 用户由此获得/user-story [feature or user need]这类补全提示其他运行时Claude Desktop/Web、Codex、Streamlit playground会无害地忽略该字段。三、核心约定二inline-input 规则如何在实战中生效发布公告给出了一个关键承诺discovery-interview-prep收到你的目标与约束后会从第一个你还没回答的问题开始。仓库为此提供了完整对话转写示例 workshop-facilitation/examples/inline-input-flow.md展示 inline-input 规则在真实会话中的落地方式。3.1 正确示范先确认已覆盖再从缺口继续用户在调用时直接给出完整上下文Use discovery-interview-prep: I need to understand why enterprise customers churn after 6 months. I can only get 5 interviews, and I have 2 weeks before the roadmap review.正确的引导者facilitator行为是开场说明会更快通常需要 7-10 分钟和约 6 个问题——但你的请求已回答了大部分上下文问题逐条复述已提取的答案并打勾研究目标 ✓、约束 ✓、截止驱动因素 ✓明确标注这已覆盖 Context Q1、Q3、Q4进度标签保持诚实直接以Context Q2/6开头而非从 Q1/6 重新计数因为 Q1 已被回答只追问缺口仅剩受访者是谁与是否携带假设两个问题其余问题全部跳过给出的推荐基于已覆盖答案目标6 个月企业流失、约束5 个访谈、2 周、两个猜测onboarding 或集成缺失被整合进三种方法论选项并明确标注推荐项。3.2 反模式重问已答问题示例同样记录了必须避免的反面行为用户已在调用消息中回答了目标问题引导者却仍从Context Q1/6 — Whats your primary goal...开始。文档指出这种重问会教会用户提前给上下文是浪费进而训练他们藏起信息每一次多余的重问都是会话不需要的往返。纠正动作在任何流程提问前先用问题清单扫描调用文本与粘贴的上下文明确credit已覆盖部分然后从第一个真正未答的问题开始。四、核心约定三为什么本库刻意不用$ARGUMENTS$ARGUMENTS是 Claude Code 的输入替换机制调用/skill-name some text时token 在模型看到内容之前被展开。许多技能库围绕它构建本库却刻意不采用交接文档给出三条理由与 CONTRIBUTING.md 的 Why We Dont Use$ARGUMENTS 一节完全一致可移植性Portability替换只发生在 Claude Code 内。在 Claude Desktop/Web 包、Codex 与 Streamlit playground 中$ARGUMENTS会以字面的、未经解释的模板语法呈现——读者面前是破碎的脚手架教学性Pedagogy这些技能同时教导人类 PM。纯语言描述的 Input 章节展示了一个规范请求的样子并告诉你可以空手而来、被引导完成$ARGUMENTS什么都教不了不必要Its unnecessaryClaude Code 本就会把输入参数追加到技能内容末尾。一个写着把内联输入当作已给出的答案的技能在每个运行时都能获得相同行为且无需任何模板语法。交接文档将这一决策与 v0.75 的教学优先立场归为同一类便利捷径只会优化单一运行时与单一受众而本库服务多个运行时与多类受众。因此该约定被命名、写入文档并从第一天起被机器强制执行杜绝善意 PR 一次一次侵蚀它。4.1 校验器如何执行$ARGUMENTS禁令check-skill-metadata.py 中check_forbidden_template_syntax()第 55-70 行的实现值得细看它先用正则剔除全部代码块...与行内反引号...再对剩余正文搜索$ARGUMENTS模式第 52 行FORBIDDEN_TEMPLATE_PATTERN。这意味着裸用$ARGUMENTS是硬性校验失败template_syntax_forbidden在反引号中点名提及这一反模式例如作者技能里教别人不要写$ARGUMENTS是允许的——校验器会先把这些提及剥离。这解释了交接文档中backticked mentions naming the anti-pattern are allowed的表述。贡献者提交的现代化改造PR 若引入模板语法将被要求转换回 Input 约定而非合并。五、强制执行地图四层校验从本地到 CI交接文档用一张表总结了什么检查拦住什么问题这是理解本库质量体系的钥匙检查项位置拦截对象必需章节含 Input、$ARGUMENTS禁令scripts/check-skill-metadata.py结构漂移、模板语法Input 含示例调用 空手到达措辞./scripts/test-a-skill.sh --smoke警告级空洞的 Input 章节Marketplace 条目 ↔skills/*/目录README/CLAUDE.md 技能链接可解析scripts/check-library-drift.py文档声称的内容超出仓库实际上述全部在每个 PR 与 tag 上执行scripts/validate-skills.sh 经由 .github/workflows/build-release.yml回归到达 main5.1 元数据与结构校验check-skill-metadata.pycheck-skill-metadata.py 是结构合规的总闸逐文件检查YAML frontmatter 合法且存在split_frontmatter()第 73-81 行name必填、小写 kebab-case^[a-z0-9](?:-[a-z0-9])*$第 51 行、不超过 64 字符description必填且不超过 200 字符Claude Web 上传限制intent必填非空type必须为component/interactive/workflow三者之一第 41 行目录名必须与 frontmattername一致第 150-152 行文件必须命名为SKILL.md七个必需章节存在且顺序正确无裸$ARGUMENTS见上文。运行方式不带参数时校验skills/*/SKILL.md第 173 行也可显式传入单个文件路径。5.2 冒烟检查test-a-skill.sh --smoketest-a-skill.sh 的--smoke模式针对 Input 章节的内容质量做警告级检查第 195-204 行Input 章节中搜索example含忽略大小写——缺失则警告 Input section has no example invocation搜索empty-handed|nothing required|provide nothing|no input|with nothing|starting with nothing等措辞——缺失则警告 Input section never says the user can arrive with nothing (invitation, not gate)对 interactive 技能额外检查 Application 章节是否含至少 3 个编号选项与至少 1 个问号交互引导特征并调用 check-skill-triggers.py 做触发就绪审计。本地一键运行./scripts/test-library.sh --smoke。交接文档注明当前有 3 个既有的冒烟警告interactive 技能选项数统计类已知且与本次改动无关。5.3 库漂移检查check-library-drift.pyv0.81 新增v0.81 发布后补提交了 check-library-drift.pycommit93921da其文档字符串写明了存在动机v0.81 修复的两类故障恰好就是它要永久拦截的对象——一个被文档引用数月、却只存在于孤儿提交上的技能agent-orchestration-advisor以及一个静默落后技能库 8 个条目的marketplace.json。文档声称的内容超出仓库实际会一次一个断链地侵蚀信任。它执行三类一致性检查第 32-75 行每个skills/name/目录必须在 .claude-plugin/marketplace.json 中有条目marketplace_entry_missing每个 marketplace 条目必须指向真实存在的技能目录marketplace_ghost_entry杜绝幽灵条目README.md 与 CLAUDE.md 中提及的skills/name/SKILL.md链接必须真实可解析doc_link_broken并自动跳过skill-name、new-skill-name、your-skill-name等占位符第 29 行。5.4 CI 发布流水线validate-skills.sh build-release.ymlscripts/validate-skills.sh 是发布前的总闸遍历skills/*/验证每个SKILL.md存在、以---开头、frontmatter 含name与description随后调用check-library-drift.py。任何失败都会让脚本以非零退出码结束。.github/workflows/build-release.yml 把它编排进 CI第 25-36 行checkout含fetch-depth: 0确保 git 历史可用于追踪孤儿提交→validate-skills.sh→check-dist-freshness.py确认 dist/ 与 catalog/ 与 skills/ 同步→build-release.sh打包。CI 对 PR、main 分支 push、以及v*tag 均触发tag 触发时通过softprops/action-gh-releasev2自动发布 GitHub Release第 48-57 行。交接文档总结的发布机制因此是pushv*tag → CI 校验、构建全部 ZIP 包、自动发布 release 资产tag 之后无需任何手工操作。六、失而复得agent-orchestration-advisor与孤儿提交的教训v0.81 发布前的审计发现了一个隐蔽问题Phase 6 的第 34 号交互型技能agent-orchestration-advisorskills/agent-orchestration-advisor/SKILL.md共 782 行内容涉及设计多 Agent 工作流的四个编排维度、Agent 边界、启动控制塔监控等自 2 月起就被 README 和 CLAUDE.md 引用却只存在于孤儿提交a41415c上从未合并到 main——文档声称已发布仓库里却根本没有这个文件。处理过程与结果通过git log --all从 git 历史中找回升级到当前标准trigger-oriented 的 description、intent、theme 元数据以及必不可少的 Input 章节最终发布技能库总数由此定格为 55。这个案例沉淀为两条会话经验Gotchas写入 04JUL26.md不要轻信文档说已发布——验证 main 分支上路径真实存在git log --all能找出从未合并的工作marketplace.json 是手工维护的新技能需手动添加条目name、source、不带 Use when... 从句的 description、取自既有七个类别的 category、tags漂移检查会提醒你。此外README 有三处声明技能数量badge、ASCII 横幅、tagline加上.claude-plugin/marketplace.json的metadata.description四处必须同步变更且横幅框对宽度敏感。七、v0.81 的其他交付与后续工作队列7.1 其他交付Streamlit playground 的 What to bring 预检每个技能详情页现在会在开始前把该技能的 Input 章节渲染进一个 expander并标注 all optional确保教学意图在 UI 中存续相关实现见 app/main.py 与 app/STREAMLIT_INTERFACE.md示例流程workshop-facilitation/examples/inline-input-flow.md提供完整转写含诚实的进度标签调用即覆盖时显示Context Q2/6与要避免的重问反模式。7.2 交接文档列出的开放工作队列按粗略优先级Theme 元数据回填55 个技能中仅 19 个带theme/best_for/scenarios/estimated_timefrontmatter其余 36 个落入 Streamlit 的 All other skills expander属机械性工作遵循已打标技能的格式即可Phase 6 余量AI PM Orchestratorai-product-evalsComponent、ai-observability-frameworkComponent、ai-maintenance-planningComponent、ai-product-orchestratorWorkflow源材料列于 CLAUDE.mdv0.80 AI Product Builder Track 简报从未执行15MAY26.md 与 research/v080-ai-product-builder-execution-brief.md 原计划 v0.80 作为该 Track实际 v0.80 发布了 stakeholder 套件简报内容硬性排除项、源材料、技能计划仍是未来版本的有效原材料需与 Dean 决定执行、重编号或退役docs/Using PM Skills with Claude.md 增加 以参数调用技能小节Input 章节已在每个技能内教学该模式此小节旨在一次性、通用地教授/skill-name your context写法属 v0.81 延后的小任务Streamlit 后续流式响应、相关技能面板、会话导出、搜索潜在 Phase 8定价与变现套件7 个技能清单见 CLAUDE.md。7.3 会话经验备忘批量技能编辑通过 Bash 运行 Python 脚本而非逐文件编辑工具文件在多次读取之间会漂移包含冒号的 YAML description 值需加引号发布机制见上文第五节tag 即触发全自动发布。八、对贡献者的直接影响如果你要向本库贡献新技能v0.81 之后的最低要求是七个章节齐全且顺序正确Purpose → Input → Key Concepts → Application → Examples → Common Pitfalls → References否则 check-skill-metadata.py 直接判定失败Input 章节必须位于 Purpose 与 Key Concepts 之间包含 works-best-with、also-useful、inline-input 规则、空手到达兜底、示例调用五要素措辞是邀请而非门禁正文禁止裸$ARGUMENTS反引号内点名提及允许提交前本地自检./scripts/test-a-skill.sh --skill your-skill-name --smoke新技能需手动登记到 .claude-plugin/marketplace.json否则 check-library-drift.py 会报marketplace_entry_missingREADME 技能数量相关三处badge、ASCII 横幅、tagline与 marketplacemetadata.description需同步更新。这些约束的共同目标正如交接文档开篇所强调的读取 04JUL26.md 前务必先读 CLAUDE.md治理与蒸馏协议因为 Input 约定、$ARGUMENTS禁令与教学优先立场是这套技能库既有详实实操、又有源码级强制执行的设计基石。赞分享AI 技能AI 插件【免费下载链接】Product-Manager-SkillsProduct Management skills framework built on battle-tested methods for Claude Code, Cowork, Codex, and AI agents.项目地址https://gitcode.com/gh_mirrors/pr/Product-Manager-Skills点击查看免费下载相关推荐TanStack FormSvelte表单分组FormGroup完全指南用子表单优雅构建多步骤向导TanStack FormSvelte表单分组FormGroup完全指南用子表单优雅构建多步骤向导 导读 本文讲解 TanStack Form 在 SAI 技能AI 插件Trivy 自定义检查的 Input Schema 详解为 Rego 检查启用输入类型校验Trivy 自定义检查的 Input Schema 详解为 Rego 检查启用输入类型校验 Input Schema 是 Trivy 自定义 Rego 检查体应用安全漏洞扫描SBOM供应链安全云原生Impeccable Doctor 巡检器AI 设计技能中 PRODUCT/DESIGN 工件漂移的报告与修复指南Impeccable Doctor 巡检器AI 设计技能中 PRODUCT/DESIGN 工件漂移的报告与修复指南 本篇技术指南面向 Impeccable——AI 技能前端CLIdsh-plugin上一篇Type-Driven Correctness 实战练习从 NVMe 到固件升级的六道硬件诊断练习题下一篇探索跨平台设计的无缝之旅Flutter Platform Widgets深度解读创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考
网站建设高端定制企业官网
RELATED

相关资讯

更多精彩内容,欢迎继续阅读

较早相关资讯

最新相关资讯

tensortrade 浮点流排序操作(Ordering)API 深度指南:clamp、min 与 max 的实现原理与实战用法 2026/9/29 6:04:41

tensortrade 浮点流排序操作(Ordering)API 深度指南:clamp、min 与 max 的实现原理与实战用法

人工智能金融科技机器学习 【免费下载链接】tensortrade An open source reinforcement learning framework for training, evaluating, and deploying robust trading agents. 项目地址: https://gitcode.com/gh_mirrors/te/tensortrade 点击查看 免费下载 本指南…

阅读更多 →
Pixelle-Video AI 短视频生成上手指南:从一个主题到成片 2026/9/29 6:04:41

Pixelle-Video AI 短视频生成上手指南:从一个主题到成片

Pixelle-Video AI 短视频生成上手指南:从一个主题到成片 【免费下载链接】Pixelle-Video 🚀 AI 全自动短视频引擎 | AI Fully Automated Short Video Engine 项目地址: https://gitcode.com/GitHub_Trending/pi/Pixelle-Video 周三下午两点&#…

阅读更多 →
claude code proxy代理完全攻略:TaoToken统一Key接入与效率提升10倍的秘密 2026/9/29 6:04:41

claude code proxy代理完全攻略:TaoToken统一Key接入与效率提升10倍的秘密

/* MD / 富文本中的 .toc(含博客园搬家等嵌套结构);.toc-box 在侧栏,不受影响 */#content_views .toc,/* 编辑器常在目录前后插入空 p(:empty 仍占 20px),一并去掉避免顶空隙 */#content_views.markdown_views > p:empty:has(+ .toc),#content_views.markdown_views …

阅读更多 →
ZeroLaunch-rs图标加载:智能识别Steam游戏图标 2026/9/29 6:04:35

ZeroLaunch-rs图标加载:智能识别Steam游戏图标

ZeroLaunch-rs图标加载:智能识别Steam游戏图标 🎮 痛点场景:为什么Steam游戏图标加载如此困难? 作为Windows用户,你是否遇到过这样的困扰:在程序启动器中搜索Steam游戏时,要么显示默认的空白图标…

阅读更多 →
CodeQL C++ 查询 `cpp/non-https-url` 详解:在源码级拦截以 HTTP 协议构造的 URL 2026/9/29 6:04:35

CodeQL C++ 查询 `cpp/non-https-url` 详解:在源码级拦截以 HTTP 协议构造的 URL

静态分析SAST应用安全漏洞扫描代码质量 【免费下载链接】codeql CodeQL: the libraries and queries that power security researchers around the world, as well as code scanning in GitHub Advanced Security 项目地址: https://gitcode.com/gh_mirrors/co/code…

阅读更多 →
使用 Rust SDK 操作 AWS Global Accelerator:globalaccelerator-helloworld 示例实战指南 2026/9/29 6:04:35

使用 Rust SDK 操作 AWS Global Accelerator:globalaccelerator-helloworld 示例实战指南

示例工程教程后端 【免费下载链接】aws-doc-sdk-examples Welcome to the AWS Code Examples Repository. This repo contains code examples used in the AWS documentation, AWS SDK Developer Guides, and more. For more information, see the Readme.md file below. 项目地…

阅读更多 →

今日资讯

本周资讯

本月资讯

看完文章仍有疑问?

联系尧图顾问,获取一对一建站咨询

立即免费咨询 📞 400-888-8888
📞 ✉