Agent skill

Source Consumer Sync

by devcodex-labs in devcodex-labs/devcodex

真相源-消费者同步规范 — 为规范源、模板、validate、文档站与部署副本变更建立 Concept Sync Map,区分当前消费者与历史镜像

AGPL-3.0Auto-check passed

Install Source Consumer Sync

skills CLI
$ npx skills add devcodex-labs/devcodex --skill source-consumer-sync -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install devcodex-labs/devcodex source-consumer-sync --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/devcodex-labs/devcodex.git skills-src && mkdir -p .claude/skills && cp -r skills-src/content/skills/source-consumer-sync .claude/skills/source-consumer-sync && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
source-consumer-sync
GitHub stars
439
Token cost
~929 tokens
SKILL.md length
281 words
Files
2
Skills in repo
70
Repo updated
First seen
Licence
AGPL-3.0

At a glance

真相源-消费者同步规范 — 为规范源、模板、validate、文档站与部署副本变更建立 Concept Sync Map,区分当前消费者与历史镜像

  • Works in 3 steps: 文档已明确标注历史版本/基线/归档。 → 页面不再以“当前行为”口吻描述现状。 → 本轮 validate 或 targeted tests 不把它当作当前消费者。
  • SKILL.md covers 职责, 触发条件, Concept Sync Map and 分类规则, plus 5 more sections
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md

What it does

Source Consumer Sync is an agent skill from devcodex-labs/devcodex. 真相源-消费者同步规范 — 为规范源、模板、validate、文档站与部署副本变更建立 Concept Sync Map,区分当前消费者与历史镜像

Its SKILL.md is about 930 tokens, which your agent loads only when the skill is triggered. The skill folder holds 1 other file (for example `intent.json`).

The repository describes itself as: Intent-driven AI coding workflow runtime for consistent context, skills, approvals, validation, and handoffs across six AI coding hosts. The licence is AGPL-3.0.

Example prompts

  • “/source-consumer-sync”

Workflow steps

3 steps, taken from the first numbered list in SKILL.md.

  1. 文档已明确标注历史版本/基线/归档。
  2. 页面不再以“当前行为”口吻描述现状。
  3. 本轮 validate 或 targeted tests 不把它当作当前消费者。

What it can do on your machine

Read from SKILL.md and the folder at commit 1dd4525. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    No scripts in the folder and no shell commands in SKILL.md (its code samples are markdown).

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Source Consumer Sync loads about 929 tokens when it runs. Until then it costs about 24 tokens; SKILL.md has 281 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~24
When it runs · the whole SKILL.md, loaded when a task matches
~929

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from devcodex-labs/devcodex at commit 1dd4525, republished under its AGPL-3.0 licence (© devcodex-labs). 281 words, ~929 tokens.

Download SKILL.mdSave it as .claude/skills/source-consumer-sync/SKILL.md (or your agent's skills folder). This skill also uses 1 other file; get the full folder from GitHub.
name
source-consumer-sync
description
真相源-消费者同步规范 — 为规范源、模板、validate、文档站与部署副本变更建立 Concept Sync Map,区分当前消费者与历史镜像

Source Consumer Sync Skill

职责

当任务会修改 instructions、skills、prompts、validate、README、website、Profile 或部署副本口径时,本 Skill 负责建立 Concept Sync Map,明确:

  • 哪个文件是当前真相源
  • 哪些文件是当前消费者,必须同批同步
  • 哪些文件只是历史镜像,可以在满足条件时保留
  • 哪些 validate probes、targeted tests 与部署副本必须一起更新

触发条件

场景是否触发
控制面 / 规范源 / 模板 / validate / 报告模板变更🔴 必须
README / website / Profile 当前行为说明变更🔴 必须
部署副本同步口径变更🔴 必须
仅局部业务代码改动N/A

Concept Sync Map

字段必填说明
sourceOfTruth✅当前事实源,例如 instructions.md、某个 Skill、某个 prompt 或脚本
currentConsumers✅当前会被用户、runtime、validate 或部署副本实际消费的文件
historicalMirrors条件仅作归档/历史基线的文件,允许保留旧事实但必须明确历史性质
validateProbes✅validate 编号、targeted tests 或其他自动化探针
deployCopies条件.github/、.claude/、AGENTS.md、.agents/、.codex/ 等需要同步的副本
yellowDeviationBoundary✅哪些新增当前消费者/探针可以按黄色偏离收口,而不需要回 CP2

分类规则

当前消费者

满足任一条件即视为当前消费者,本轮必须同步:

  • 当前 README / website / guide / Profile 正在描述现行行为
  • validate / targeted tests 直接依赖该描述或字段
  • 部署副本会把该内容发给实际宿主
  • 报告模板、实施模板会在下一轮继续消费该字段
历史镜像

仅在以下条件同时满足时,才可作为历史镜像暂不改动:

  1. 文档已明确标注历史版本/基线/归档。
  2. 页面不再以“当前行为”口吻描述现状。
  3. 本轮 validate 或 targeted tests 不把它当作当前消费者。

执行步骤

  1. 锁定本轮 sourceOfTruth。
  2. 建立 currentConsumers / historicalMirrors 清单。
  3. 为当前消费者补齐 validateProbes 和必要 targeted tests。
  4. 列出 deployCopies:用户级全局 adapter 可建议 devcodex global-adapters apply(或 npm -g / pack 路径),但必须把全局环境修改作为独立授权动作;workspace .devcodex 才使用 bare devcodex update。ConceptSyncMap、Auto、Profile 或 stale 状态不授予任一部署 mutation。
  5. 定义 yellowDeviationBoundary,把允许纳入的额外消费者写入进度或报告。
  6. 实施后做双向联查:正向 grep 真相源,反向 grep 旧口径残留。

能力面新增或变化时,Concept Sync Map 必须把 skills/spec-governance/capability-surface-decision.v1.schema.json 与任务目录 capability-surface-decisions/*.json 作为中央 schema/record 真相源,记录 decisionRef + schemaDigest。Owner Skills、Prompt、TestRoute、report、public docs、Profile 和部署副本只能作为 readers/consumers;任何消费者复制中央选择字段、出现第二 writer,或 decision identity 已失效时均阻断同步。

部署副本同步还必须执行物理所有权复核:以 target root 下规范化绝对 destination 为键,而不是只按 surface 名称去重。同一路径出现多个 current writer/manifest entry 时阻断;宿主专用 adapter 可以位于项目内,但不得被公共 bridge 描述为所有宿主的共享消费者。

Registry 驱动的同步面

规范吸纳、控制面或历史规则分层时,不在本 Skill 维护版本号清单。执行方必须读取 ../spec-governance/gate-registry.json,用 gateGroup 找到 ownerSkills / requiredEvidence / route / legacyAnchors,再建立本轮 Concept Sync Map。

每个适用分组至少核对:

  1. 规范真相源与目标 Owner Skill。
  2. Prompt/template、TestRoute、report schema 等当前执行消费者。
  3. validate/targeted/negative fixture 等验证探针。
  4. README、website、Profile 和 changelog 等公开消费者。
  5. AGENTS、CLAUDE、Copilot、Codex、plugin package 等部署副本。
  6. 历史镜像及其失效、保留或兼容边界。
  7. 能力面任务的 decisionRef / schemaDigest / writer / readers 是否仍与中央记录一致。

跨仓消费者验证、Profile/宿主能力、修复协作、发布凭据、用户文档、派生消费者与返工闭环等专属字段由 registry 指向的 Owner Skill 定义。本 Skill 只保存关系、同步状态和偏离原因,不复制 Owner 的完整门禁正文。

历史 V73~V95 名称只作为 registry legacyAnchors 的检索入口;新增版本不得继续扩展本文件的版本专属长列表。

黄色偏离边界

以下情况可按黄色偏离处理,但必须记录到实施进度或报告:

  • 为同一事实新增一个当前消费者或一个 validate probe
  • 因部署同步需要追加一个当前副本检查点
  • 为避免“真相源已修、当前消费者未修”补同步少量当前页面

以下情况不是黄色偏离:

  • 新增另一套真相源
  • 把当前页面降格为历史镜像但未明确标注
  • 扩大到大批历史归档翻修

输出格式

markdown
## ConceptSyncMap

| 字段 | 内容 |
|------|------|
| sourceOfTruth | |
| currentConsumers | |
| historicalMirrors | |
| validateProbes | |
| deployCopies | |
| yellowDeviationBoundary | |

与其他 Skill 的关系

  • spec-governance:SCV-1 的核心输入来自本 Skill 的 Concept Sync Map。
  • execution-contract:通过 consumerScope 和 deviationLog 约束同步边界。
  • document-sync:实施后根据 Concept Sync Map 判断 README / website / Profile / changelog 等是否必须同步。
  • report:控制面任务报告中需显式列出 Concept Sync Map、黄色偏离和部署同步证据。

© devcodex-labs, AGPL-3.0. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

SKILL.md and 1 other file in content/skills/source-consumer-sync of devcodex-labs/devcodex.

  • SKILL.md
  • intent.json

Open the folder on GitHubat commit 1dd4525

Compare with similar skills

Source Consumer Sync next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Source Consumer Sync compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Source Consumer Sync this skilldevcodex-labs/devcodex439—~929Automated safety check: PassAGPL-3.0
Consumer Goods Sync Management Configureforcedotcom/sf-skills1.1k—~5.2kAutomated safety check: PassApache-2.0
Claude-Mem Cloud Syncthedotmack/claude-mem97k—~1kAutomated safety check: NotesApache-2.0
Agent Sync Coordinatorruvnet/ruflo74k2 repos~4kAutomated safety check: PassMIT
I18n Syncaffaan-m/ECC274k—~1.8kAutomated safety check: PassMIT
JavaScript Concept Page Workflowleonardomso/33-js-concepts67k—~3.9kAutomated safety check: PassMIT

Similar skills

  • A skill your agent uses to set up Salesforce Consumer Goods (CG) Cloud Mobile Sync end-to-end for the Sync Management App managed package — it runs all three acts in order (Act 1 Setup Sync, Act 2…

    1.1k GitHub stars~5.2k tokensUpdated 4 days ago
    Sales & SupportAuto-check passed
  • Claude-Mem Cloud Sync

    thedotmack/claude-mem

    Checks claude-mem cloud sync status and guides you through connecting a cmem.ai Pro account without the sync token ever passing through the chat.

    97k GitHub stars~1k tokensUpdated today
    Agent WorkflowsAuto-check: notes
  • Agent skill for sync-coordinator - invoke with $agent-sync-coordinator

    74k GitHub starsUsed in 2 repos~4k tokens
    Auto-check passed
  • I18n Sync

    affaan-m/ECC

    Translate and synchronize application JSON locale files using source-key usage, project terminology, and focused validation.

    274k GitHub stars~1.8k tokensUpdated 2 days ago
    Frontend & DesignAuto-check passed
  • JavaScript Concept Page Workflow

    leonardomso/33-js-concepts

    Orchestrates five skills to produce a complete JavaScript concept documentation page, from resource curation through writing, tests, fact-checking and SEO.

    67k GitHub stars~3.9k tokensUpdated 26 days ago
    Writing & ContentAuto-check passed
  • JavaScript Concept Page Writer

    leonardomso/33-js-concepts

    Writes or reviews documentation pages for the 33 JavaScript Concepts project, following its structure, a beginner-friendly voice and rules against AI-sounding language.

    67k GitHub stars~14k tokensUpdated 26 days ago
    Writing & ContentAuto-check passed

More from devcodex-labs/devcodex

All 70 skills in this repo
  • Accessibility I18n

    devcodex-labs/devcodex

    无障碍与国际化专家 Owner — 当任务涉及可访问性、键盘操作、焦点、屏幕阅读器、ARIA、语言地区、本地化、RTL、翻译资源、用户可见文案或多语言文档时使用;要求把包容性体验和本地化验证绑定到真实用户路径。

    439 GitHub stars~718 tokensUpdated 20 days ago
    Auto-check passed
  • AI Agent System Architecture

    devcodex-labs/devcodex

    AI Agent 系统架构专家 Owner — 当任务涉及 Agent 路由、工具调用、上下文管理、记忆、状态机、权限、人机协作、可观测性、回放验证或模型辅助治理时使用;要求把 Agent 行为设计成可解释、可恢复、可审计。

    439 GitHub stars~2.4k tokensUpdated 20 days ago
    Auto-check passed
  • API Contract Architecture

    devcodex-labs/devcodex

    API 契约架构专家 Owner — 当任务涉及 public API、HTTP/SDK/CLI 契约、版本兼容、错误模型、分页过滤、幂等、Schema、类型、迁移或消费者影响时使用;要求先冻结消费者契约,再设计实现与验证。

    439 GitHub stars~865 tokensUpdated 20 days ago
    Auto-check passed
  • Architecture Design

    devcodex-labs/devcodex

    架构设计文档编排 Owner — 当用户要求架构设计、系统设计、技术架构或可指导开发、Review 与任务拆分的完整方案时使用;要求从业务流程反推节点、状态、数据、一致性、异常补偿、ADR 与实施任务。

    439 GitHub stars~1.1k tokensUpdated 20 days ago
    Auto-check passed
  • Audit Common

    devcodex-labs/devcodex

    审查公共维度 G0~G5 + Profile Freshness Check — 所有 audit 子类型必先执行的基础维度层

    439 GitHub stars~4.1k tokensUpdated 20 days ago
    Auto-check passed
  • Audit Session

    devcodex-labs/devcodex

    审计工作流的跨会话状态机 — 在 <audit-root/.audit-state/<session-id.json 持久化轮次/发现项/收敛状态,支持 Token 中断后精准恢复

    439 GitHub stars~1.8k tokensUpdated 20 days ago
    Auto-check passed

Questions about Source Consumer Sync

What does Source Consumer Sync do?

真相源-消费者同步规范 — 为规范源、模板、validate、文档站与部署副本变更建立 Concept Sync Map,区分当前消费者与历史镜像. Source Consumer Sync is an agent skill from devcodex-labs/devcodex.

How do I install Source Consumer Sync in Claude Code?

Run `npx skills add devcodex-labs/devcodex --skill source-consumer-sync -a claude-code`. Or copy the skill folder (content/skills/source-consumer-sync in devcodex-labs/devcodex) into .claude/skills/source-consumer-sync in your project. Claude Code loads it when a task matches its description.

How do I install Source Consumer Sync in Codex?

Run `npx skills add devcodex-labs/devcodex --skill source-consumer-sync -a codex`. Or copy the skill folder (content/skills/source-consumer-sync in devcodex-labs/devcodex) into .agents/skills/source-consumer-sync in your project. Codex loads it when a task matches its description.

Can I use Source Consumer Sync in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add devcodex-labs/devcodex --skill source-consumer-sync -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/source-consumer-sync, .gemini/skills/source-consumer-sync, .github/skills/source-consumer-sync and .opencode/skills/source-consumer-sync in your project.

What does Source Consumer Sync need to run?

SKILL.md names no scripts, command-line tools or credentials: Source Consumer Sync is instructions for the agent only.

Does Source Consumer Sync access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is Source Consumer Sync safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Source Consumer Sync use?

Source Consumer Sync is published under the AGPL-3.0 licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Source Consumer Sync use?

About 929 tokens (SKILL.md is roughly 3.7k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Source Consumer Sync?

Skills that share tags, products or a category with Source Consumer Sync: Consumer Goods Sync Management Configure (forcedotcom/sf-skills, 1.1k stars), Claude-Mem Cloud Sync (thedotmack/claude-mem, 97k stars), Agent Sync Coordinator (ruvnet/ruflo, 74k stars) and I18n Sync (affaan-m/ECC, 274k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Source Consumer Sync?

devcodex-labs (a GitHub organization) maintains it in devcodex-labs/devcodex, which has 439 GitHub stars. The repository holds 70 skills in this directory. The repository was last updated on September 17, 2026.

Source: devcodex-labs/devcodex on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.