Workflow Routing【免费下载链接】LifeOS⛰️ The Life Operating System — an intent engineering platform that moves you from your current state to your ideal state, in life and work.项目地址: https://gitcode.com/GitHub_Trending/pe/LifeOSWhen executing a workflow, output this notification:Running **WorkflowName** in **SkillName**...WorkflowTriggerFileWorkflowOnetrigger phraseWorkflows/WorkflowOne.md违规判定缺少该章节、工作流名不是 TitleCase、文件路径与实际文件名不符。 ### Examples 章节必备 markdown ## Examples **Example 1: [Use case]**User: [Request] → [Action] → [Result]缺少即判 WRONG。SkillSystem.md 给出的依据是description 告诉模型何时激活Examples 展示技能如何工作让模型学到完整的输入→行为→输出模式每技能 2-3 个示例使用自然语言的真实请求。Gotchas 章节必备信息密度最高## Gotchas [Known failure modes, API quirks, common mistakes]ValidateSkill 原文强调Gotchas 是任何技能中信息密度最高的部分引用自 Anthropic 的内部最佳实践它应收集 Claude 不知道的 API 怪癖、观察到的常见错误、不明显的顺序依赖、导致静默失败的边缘案例并且随每次失败持续积累。发布清洁度预备门Publish-Clean Readiness Gate这是 2026-07-23 分离指令之后的硬要求每一个技能——公共TitleCase与私有_ALLCAPS一律——正文都必须发布清洁publish-clean敏感数据一律改为从LIFEOS/USER/树按路径引用。检查工作流明确要求运行确定性门控工具而不要手写 grep硬编码的模式清单会腐化且漏掉拒绝列表的大部分条目bun ~/.claude/LIFEOS/TOOLS/SkillHygieneGate.ts --skill SkillNameExit 0 PASS任何违规 FAIL把违规数据移到~/.claude/LIFEOS/USER/CUSTOMIZATIONS/SKILLS/SkillName/或其规范的 USER 归属位置改为按路径引用。门控之外的补充检查包括硬编码的密钥、API key、token、bearer 凭据零容忍——技能里只允许出现环境变量名值放~/.claude/.env拒绝列表为归因attribution而忽略的裸名需单独检索正文中 principal 与 partner 的名字非公共引用或功能性检测模式的都应泛化。SkillHygieneGate 的实现要点该门控工具在本仓库中是 SkillHygieneGate.ts从源码可以确认几个关键设计完整命令行bun SkillHygieneGate.ts [--json] [--skill NAME] [--root dir] [--max-detail N]其中--skill把扫描范围限定到单个技能--json输出机器可读报告--root可指向非默认安装根fixture 模式。退出码语义0干净1有违规2扫描错误——源码注释直接写明a broken gate never reads as clean坏掉的门控绝不被当作干净。拒绝列表单一来源模式集读取自~/.claude/LIFEOS/USER/SECURITY/DENY_LIST.txt——与发布流水线用的是同一份清单因此技能干净 ≡ 发布干净在构造上成立工具永不 fork 自己的模式集。防御性失败若 deny-list 不存在但存在哈希版DENY_HASHES.json说明个人数据存在但明文清单缺失门控会显式报错退出 1 而不是通过若 deny-list 条目少于 20 条判定清单被截断拒绝扫描fail于 exit 2两份清单都不存在时全新、无个人数据的树才安静跳过并退出 0。主目录路径形状除身份字符串外工具额外追加两条大小写敏感的 home 路径正则/Users/name/、/home/name/因为任何用户主目录字面量都是机器绑定、不可发布的正则特意用(?-i)保证在全局忽略大小写的扫描中保持敏感避免对orgs/projects/users/billing这类 REST 风格路径误报源码注释记录了在 ISA/Examples 上真实发生过的误报。扫描与结构检查底层用rg -i按临时模式文件扫描~/.claude/skills/排除node_modules、缓存等运行时目录另用git ls-files检查被 git 跟踪的 vendored 依赖——磁盘上的node_modules是运行时产物无妨但提交进版本库的依赖目录是结构性违规。白名单LIFEOS/USER/CONFIG/skill-hygiene-allowlist.json中的条目逐条带理由是经评审的追加而非批量逃生门同时兼容 containment-zones.ts 导出的PATTERN_ALLOWLIST_FILES那些文件本身就内嵌待检测的模式。只报告不修改注释声明 Report-only by design — this tool never modifies a file它被/ic完整性检查、sweep 工作流和 CreateSkill 预检共同消费。Step 5aBPE 合规检查对技能指令应用 Bitter-Pilled EngineeringBPE测试逐项勾选每条指令都提供了 Claude 无法自行推导的知识没有为补偿模型局限而写的指令格式强制、CoT 脚手架能用确定性脚本的地方不用基于提示词的绕路方案SKILL.md 少于 500 行大型技能应使用References/或根级上下文文件。这与 SKILL.md 中的 BPE 章节互相印证核心判据是一个更聪明的模型会让这条规则变得多余吗——是则删。SkillSystem.md 的 Authoring Standard 进一步给出四个合法的保留类安全门、已验证的 gotcha、工具契约精确调用配方、输出格式契约确定性的*.ts工具则整体豁免。Step 5b官方规范漂移检查advisoryLifeOS 的规范格式固化在SkillSystem.md里但它编码的其实是 Anthropic 的 Agent Skills 格式而 Anthropic 会修订它。该步骤要求对照官方的 Agent Skills 文档页与参考技能仓库比较其 frontmatter 契约被识别的字段、description 长度限制、加载行为与本地规范的差异发现任何漂移都要同时引用两个来源作为发现项上报——因为这里的漂移是关于我们自己规范的发现而不是对被验证技能的发现。该步骤是咨询性的官方页面不可达时记一条⏳ skipped (unreachable)注记并继续验证漂移只报告、绝不自动采纳确认后的漂移应路由给 principal 或作为 Upgrade 技能的建议项处理。这体现了一个工程态度本地教义与上游契约之间的同步是持续义务但同步本身需要人审。Step 6-7工作流文件与目录结构检查工作流文件Step 6ls ~/.claude/skills/[SkillName]/Workflows/四项验证每个文件都是 TitleCase 命名每个文件在## Workflow Routing章节中都有对应条目每个路由条目都指向一个真实存在的文件路由表中的名称与文件名完全一致。目录结构Step 7ls -la ~/.claude/skills/[SkillName]/验证Tools/目录存在即使为空技能目录内没有backups/备份一律放~/.claude/History/Backups/或~/.claude/LIFEOS/MEMORY/Backups/参考文档放在技能根目录而不是Workflows/里。这与规范中的扁平文件夹结构硬约束一致最深只允许skills/SkillName/Category/两级允许的子目录只有Workflows/纯执行工作流、Tools/纯可执行工具、References/大技能的扩展参考材料其余文档一律放技能根。CLI-First 集成检查Step 7a仅针对带 CLI 工具的技能若技能在Tools/下有工具需逐工具验证其以旗标暴露行为配置bun ~/.claude/skills/[SkillName]/Tools/[ToolName].ts --help检查的旗标类别与 CliFirstArchitecture.md 的旗标标准对应模式旗标--fast、--thorough、--dry-run输出旗标--format、--quiet、--verbose资源旗标如--model如适用;后处理旗标如适用。对调用 CLI 工具的工作流还要求存在意图到旗标映射表grep -l Intent-to-Flag ~/.claude/skills/[SkillName]/Workflows/*.md要求的模式是一个三列表格把用户自然语言映射到具体旗标与使用时机## Intent-to-Flag Mapping | User Says | Flag | When to Use | |-----------|------|-------------| | fast | --model haiku | Speed priority | | (default) | --model sonnet | Balanced |【免费下载链接】LifeOS⛰️ The Life Operating System — an intent engineering platform that moves you from your current state to your ideal state, in life and work.项目地址: https://gitcode.com/GitHub_Trending/pe/LifeOS创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考 Workflow Routing
Workflow Routing【免费下载链接】LifeOS⛰️ The Life Operating System — an intent engineering platform that moves you from your current state to your ideal state, in life and work.项目地址: https://gitcode.com/GitHub_Trending/pe/LifeOSWhen executing a workflow, output this notification:Running **WorkflowName** in **SkillName**...WorkflowTriggerFileWorkflowOnetrigger phraseWorkflows/WorkflowOne.md违规判定缺少该章节、工作流名不是 TitleCase、文件路径与实际文件名不符。 ### Examples 章节必备 markdown ## Examples **Example 1: [Use case]**User: [Request] → [Action] → [Result]缺少即判 WRONG。SkillSystem.md 给出的依据是description 告诉模型何时激活Examples 展示技能如何工作让模型学到完整的输入→行为→输出模式每技能 2-3 个示例使用自然语言的真实请求。Gotchas 章节必备信息密度最高## Gotchas [Known failure modes, API quirks, common mistakes]ValidateSkill 原文强调Gotchas 是任何技能中信息密度最高的部分引用自 Anthropic 的内部最佳实践它应收集 Claude 不知道的 API 怪癖、观察到的常见错误、不明显的顺序依赖、导致静默失败的边缘案例并且随每次失败持续积累。发布清洁度预备门Publish-Clean Readiness Gate这是 2026-07-23 分离指令之后的硬要求每一个技能——公共TitleCase与私有_ALLCAPS一律——正文都必须发布清洁publish-clean敏感数据一律改为从LIFEOS/USER/树按路径引用。检查工作流明确要求运行确定性门控工具而不要手写 grep硬编码的模式清单会腐化且漏掉拒绝列表的大部分条目bun ~/.claude/LIFEOS/TOOLS/SkillHygieneGate.ts --skill SkillNameExit 0 PASS任何违规 FAIL把违规数据移到~/.claude/LIFEOS/USER/CUSTOMIZATIONS/SKILLS/SkillName/或其规范的 USER 归属位置改为按路径引用。门控之外的补充检查包括硬编码的密钥、API key、token、bearer 凭据零容忍——技能里只允许出现环境变量名值放~/.claude/.env拒绝列表为归因attribution而忽略的裸名需单独检索正文中 principal 与 partner 的名字非公共引用或功能性检测模式的都应泛化。SkillHygieneGate 的实现要点该门控工具在本仓库中是 SkillHygieneGate.ts从源码可以确认几个关键设计完整命令行bun SkillHygieneGate.ts [--json] [--skill NAME] [--root dir] [--max-detail N]其中--skill把扫描范围限定到单个技能--json输出机器可读报告--root可指向非默认安装根fixture 模式。退出码语义0干净1有违规2扫描错误——源码注释直接写明a broken gate never reads as clean坏掉的门控绝不被当作干净。拒绝列表单一来源模式集读取自~/.claude/LIFEOS/USER/SECURITY/DENY_LIST.txt——与发布流水线用的是同一份清单因此技能干净 ≡ 发布干净在构造上成立工具永不 fork 自己的模式集。防御性失败若 deny-list 不存在但存在哈希版DENY_HASHES.json说明个人数据存在但明文清单缺失门控会显式报错退出 1 而不是通过若 deny-list 条目少于 20 条判定清单被截断拒绝扫描fail于 exit 2两份清单都不存在时全新、无个人数据的树才安静跳过并退出 0。主目录路径形状除身份字符串外工具额外追加两条大小写敏感的 home 路径正则/Users/name/、/home/name/因为任何用户主目录字面量都是机器绑定、不可发布的正则特意用(?-i)保证在全局忽略大小写的扫描中保持敏感避免对orgs/projects/users/billing这类 REST 风格路径误报源码注释记录了在 ISA/Examples 上真实发生过的误报。扫描与结构检查底层用rg -i按临时模式文件扫描~/.claude/skills/排除node_modules、缓存等运行时目录另用git ls-files检查被 git 跟踪的 vendored 依赖——磁盘上的node_modules是运行时产物无妨但提交进版本库的依赖目录是结构性违规。白名单LIFEOS/USER/CONFIG/skill-hygiene-allowlist.json中的条目逐条带理由是经评审的追加而非批量逃生门同时兼容 containment-zones.ts 导出的PATTERN_ALLOWLIST_FILES那些文件本身就内嵌待检测的模式。只报告不修改注释声明 Report-only by design — this tool never modifies a file它被/ic完整性检查、sweep 工作流和 CreateSkill 预检共同消费。Step 5aBPE 合规检查对技能指令应用 Bitter-Pilled EngineeringBPE测试逐项勾选每条指令都提供了 Claude 无法自行推导的知识没有为补偿模型局限而写的指令格式强制、CoT 脚手架能用确定性脚本的地方不用基于提示词的绕路方案SKILL.md 少于 500 行大型技能应使用References/或根级上下文文件。这与 SKILL.md 中的 BPE 章节互相印证核心判据是一个更聪明的模型会让这条规则变得多余吗——是则删。SkillSystem.md 的 Authoring Standard 进一步给出四个合法的保留类安全门、已验证的 gotcha、工具契约精确调用配方、输出格式契约确定性的*.ts工具则整体豁免。Step 5b官方规范漂移检查advisoryLifeOS 的规范格式固化在SkillSystem.md里但它编码的其实是 Anthropic 的 Agent Skills 格式而 Anthropic 会修订它。该步骤要求对照官方的 Agent Skills 文档页与参考技能仓库比较其 frontmatter 契约被识别的字段、description 长度限制、加载行为与本地规范的差异发现任何漂移都要同时引用两个来源作为发现项上报——因为这里的漂移是关于我们自己规范的发现而不是对被验证技能的发现。该步骤是咨询性的官方页面不可达时记一条⏳ skipped (unreachable)注记并继续验证漂移只报告、绝不自动采纳确认后的漂移应路由给 principal 或作为 Upgrade 技能的建议项处理。这体现了一个工程态度本地教义与上游契约之间的同步是持续义务但同步本身需要人审。Step 6-7工作流文件与目录结构检查工作流文件Step 6ls ~/.claude/skills/[SkillName]/Workflows/四项验证每个文件都是 TitleCase 命名每个文件在## Workflow Routing章节中都有对应条目每个路由条目都指向一个真实存在的文件路由表中的名称与文件名完全一致。目录结构Step 7ls -la ~/.claude/skills/[SkillName]/验证Tools/目录存在即使为空技能目录内没有backups/备份一律放~/.claude/History/Backups/或~/.claude/LIFEOS/MEMORY/Backups/参考文档放在技能根目录而不是Workflows/里。这与规范中的扁平文件夹结构硬约束一致最深只允许skills/SkillName/Category/两级允许的子目录只有Workflows/纯执行工作流、Tools/纯可执行工具、References/大技能的扩展参考材料其余文档一律放技能根。CLI-First 集成检查Step 7a仅针对带 CLI 工具的技能若技能在Tools/下有工具需逐工具验证其以旗标暴露行为配置bun ~/.claude/skills/[SkillName]/Tools/[ToolName].ts --help检查的旗标类别与 CliFirstArchitecture.md 的旗标标准对应模式旗标--fast、--thorough、--dry-run输出旗标--format、--quiet、--verbose资源旗标如--model如适用;后处理旗标如适用。对调用 CLI 工具的工作流还要求存在意图到旗标映射表grep -l Intent-to-Flag ~/.claude/skills/[SkillName]/Workflows/*.md要求的模式是一个三列表格把用户自然语言映射到具体旗标与使用时机## Intent-to-Flag Mapping | User Says | Flag | When to Use | |-----------|------|-------------| | fast | --model haiku | Speed priority | | (default) | --model sonnet | Balanced |【免费下载链接】LifeOS⛰️ The Life Operating System — an intent engineering platform that moves you from your current state to your ideal state, in life and work.项目地址: https://gitcode.com/GitHub_Trending/pe/LifeOS创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考