skill-sub — independently scanned and version-tracked by SaferSkills.
SaferSkills independently audited skill-sub (Agent Skill) and scored it 100/100 (green). The audit ran 55 deterministic rules across Security, Supply Chain, Maintenance, Transparency, and Community; it found 0 high-severity and 0 lower-severity findings. The full rule-by-rule trace and per-finding evidence are below. Free, methodology-open.
Findings & checks · 0 flagged
Every scanned point with the score it earned and what moved between them.
First recorded scan — no prior version to compare against.
The primary manifest — the file an agent reads to learn what this artifact does.
正向触发：
否定条件：
📚 渐进式加载：本技能采用渐进式 MD 体系，SKILL.md为入口（≤230行），详细内容拆分到references/*.md按需加载。
| # | 功能 | 说明 |
|---|---|---|
| 1 | 调用链管理 | 创建、查询、更新、删除调用链 |
| 2 | 执行计划生成 | 生成结构化执行计划，含并行/串行标记 |
| 3 | 条件执行 | 支持条件步骤，按条件判断是否执行 |
| 4 | 循环与分支编排 | 支持 for-each/while 循环和 if-else 分支 |
| 5 | Dry-Run 模式 | 模拟执行，不实际调用技能 |
| 6 | 链备份与版本管理 | 自动备份，支持版本恢复 |
| 7 | 粘连点（Adhesion Point） | 标记 skill 无法自动化的缺口，提供三种解决方案保证链不断；支持自愈 —— 每次执行自动扫描是否有新 skill 可填补 |
| 文件名 | 分类 | 包含内容 | 审计关联 |
|---|---|---|---|
references/LICENSE.md | 许可协议 | 开源许可证声明（MIT）。包含：MIT 许可证完整文本。 | R-26 |
references/adhesion.md | 参考文档 | > v1.25.0 新增。粘连点是调用链中无法由 skill 自动化的缺口标记。 | 无 |
references/antipatterns.md | 规范指南 | skill 编写中的常见反模式。包含：错误做法示例、正确做法示例、避坑指引。 | R-18 |
references/chain_schema.md | 参考文档 | > 本文档定义 Chain / Step / retry_policy / failure_mode 的完整结构。 | 无 |
references/changelog.md | 版本管理 | 版本更新日志。包含：版本号、变更类型、修复项、升级说明。 | R-24 |
references/examples.md | 使用示例 | 各场景完整执行示例。包含：CLI 命令、执行过程、输出结果。 | R-25 C-17 |
references/faq.md | 常见问题 | 常见疑问与解答。包含：问题分类、原因分析、解决方案。 | R-19, R-25 C-19 |
references/loop_branch.md | 参考文档 | > 本文档是 SKILL.md 的渐进式补充，包含循环与分支编排的完整示例。 | 无 |
references/permissions.md | 权限与测试 | 权限扫描说明与测试结论。包含：风险等级、高权限操作说明、测试概览、计时统计。 | R-15, R-16 |
references/reference.md | 命令参考 | CLI 完整命令参考。包含：所有参数、子命令、选项、示例用法。 | 无 |
references/workflow.md | 参考文档 | > 本文档是 SKILL.md 的渐进式补充，详细描述执行流程、里程碑判断规则、三层回退策略。 | 无 |
# 第一步：初始化
python {SKILL_DIR}/scripts/chain_manager.py init
# 第二步：创建调用链（两个 skill + 一个粘连点连接）
python {SKILL_DIR}/scripts/chain_manager.py create --name "代码发布" \
--description "从代码分析到发布的完整流程" \
--steps '[
{"index":1,"type":"skill","step_name":"代码审查","skill_name":"code-review","action":"审查PR"},
{"index":2,"type":"adhesion","step_name":"审批发布","adhesion":{"reason":"发布审批需要人工决策","solutions":[{"mode":"manual","description":"人工审批发布申请"}]}},
{"index":3,"type":"skill","step_name":"部署","skill_name":"deploy","action":"部署到生产环境"}
]'
# 第三步：生成执行计划
python {SKILL_DIR}/scripts/chain_executor.py plan --name "代码发布" --verbose💡 小贴士：创建时如果步骤有 ERROR，会提示具体原因（如"连续缺口应合并为一个粘连点"），按提示修正后重试即可。
# 使用脚本模式：给定步骤ID直接生成链
python {SKILL_DIR}/scripts/chain_planner.py script \
--steps "skill-standardization.R-01,triphasic-execution.execute,skill-standardization.R-25" \
--name "标准化审查链"
# 输出：
# ✅ 调用链 '标准化审查链' 创建成功
# 链目录: ~/.workbuddy/skills/.standardization/skill-sub/chains/标准化审查链/
# ├── chain.json
# └── blueprints.json# 根据意图搜索步骤
python {SKILL_DIR}/scripts/chain_planner.py suggest \
--intent "代码审查 分析 报告" --topk 5
# 输出：
# 🔍 增强推荐: 代码审查 分析 报告
# 1. skill-standardization.R-01 [0.87] → 权限扫描
# 2. analysis-toolkit.数据分析 [0.72] → 数据分析
# 3. ...
# 🔗 自动衔接分析:
# ⛔ step1 → step2 (semantic, 0.35) 需 adhesion
# ✅ step2 → step3 (none, 0.85)# 生成执行计划（详细输出）
python {SKILL_DIR}/scripts/chain_executor.py plan --name "代码发布" --verbose
# 查看调用链详情
python {SKILL_DIR}/scripts/chain_manager.py show --name "代码发布"
# 列出所有调用链
python {SKILL_DIR}/scripts/chain_manager.py list
# 删除（自动备份）
python {SKILL_DIR}/scripts/chain_manager.py delete --name "代码发布" --force--schedule 参数schedule 时，AI 必须当场完成注册→ 详见核心能力的渐进式文件索引
配置界面：运行以下命令启动配置界面：
python {SKILL_DIR}/scripts/settings.py| 配置项 | 选项 | 说明 |
|---|---|---|
| 记忆参考 | 是 / 否 | 创建/执行调用链时，是否读取用户记忆文件增强步骤描述 |
| 命名方式 | 自动 / 人工 | 创建调用链时，由 AI 自动命名还是询问用户 |
| 默认重试次数 | 1-10（默认3） | 所有步骤的默认最大重试次数 |
| 场景 | 说明 |
|---|---|
| 多 skill 编排 | 涉及 2 个及以上 skill，步骤间有明确依赖关系 |
| 可固化流程 | 流程稳定、可复现，不是一次性操作 |
| 跨步骤衔接 | skill 之间需要数据转换、人工审批、流程补全 |
| 场景 | 原因 |
|---|---|
| 单 skill 任务 | 直接调 skill 本身即可，不需要调用链 |
| 一次性操作 | 调用链的价值在于复用，一次性工作不值得建链 |
| 无依赖的并行任务 | 多个独立任务应并行执行，不需要编排 |
| 高度动态的流程 | 每次执行步骤都不一样，粘连点也解决不了，直接 AI 手动处理 |
| 限制项 | 值 | 说明 |
|---|---|---|
| 最大步骤数 | 30 层（含嵌套） | 超过后校验器会告警，但不阻断执行 |
| 粘连点占比 | 30% | 超过告警，建议合并或补充 skill |
| 粘连点连续 | 禁止 | 连续缺口合并为一个粘连点 |
| 依赖深度 | 10 层 | 过深依赖链难以维护和排查 |
| 循环最大迭代 | 默认 10，可配置 | 超过按 on_max_iteration 处理 |
| 报错信息 | 原因 | 解决方法 |
|---|---|---|
| 连续缺口应合并为一个粘连点 | 两个 adhesion 步骤相邻 | 合并为一个 adhesion，用 hybrid 方案覆盖全部缺口 |
| 粘连点占比超过 30% | adhesion 步骤太多 | 检查是否有 skill 可以替代 |
| 缺少 solutions | adhesion 步骤没有提供方案 | 至少加一个 manual 方案 |
| 依赖不存在的步骤 | depends_on 引用了无效索引 | 检查依赖步骤的 index 是否正确 |
| 引用的 skill 不存在 | skill_name 对应的 skill 未安装 | 检查 skill 名称是否正确 |
| 检测到定时/自动化意图，但未提供 --schedule | 描述中含"每天/每周/定时"等词但没给调度配置 | 添加 --schedule 参数，或删除描述中的时间相关词 |
强制规则：用户描述中包含定时/自动化意图（如"每天"、"每周"、"自动执行"等）时，必须提供 --schedule 参数配置调度信息，否则链创建被拦截。不依赖 AI 自觉判断。~30 seconds. Free. No account. Every finding cites a rule and a line of evidence.