Source Consumer Sync logo

Source Consumer Sync

Organization
devcodex-labs
source-consumer-sync

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

Overview

Publisherdevcodex-labs
Repositorydevcodex
Skill namesource-consumer-sync
Stars
433
Forks
44
Bundled files
1
LicenseAGPL-3.0
Links
  • Markdown instructions

    A SKILL.md file the model loads on demand, so it only costs tokens when a request actually matches.

  • Works with any LLM

    AI skills are plain Markdown, not provider-specific code, so this works with GPT, Claude, Gemini, Grok, or a local model.

  • 1 bundled files

    Scripts, templates, and references the model can read while it works. Files are read-only and never executed.

  • Open source

    Published by devcodex-labs on GitHub. Read the source before you install it.

Installation

Install the Source Consumer Sync AI skill in TypingMind to use it with any LLM, or drop it into another agent that reads SKILL.md.

1

Install in TypingMind

TypingMind installs a skill straight from its GitHub folder — it reads SKILL.md, bundles the resource files, and stores the result locally.

  1. Open the app and go to Plugins → Skills.
  2. Choose "Install from GitHub".
  3. Paste the skill folder URL below and confirm.
    https://github.com/devcodex-labs/devcodex/tree/main/content/skills/source-consumer-sync
  4. Enable the skill in any chat where you want it available.
Plugins → Skills → Add skill → From GitHub URL, then paste the folder URL and press Continue.
2

Install in another agent

Any agent that reads the Agent Skills format can use this skill — copy the folder into that agent's skills directory.

Claude Code — .claude/skills
git clone --depth 1 https://github.com/devcodex-labs/devcodex.git /tmp/devcodex
mkdir -p .claude/skills
cp -r /tmp/devcodex/content/skills/source-consumer-sync .claude/skills/source-consumer-sync
Restart Claude Code after copying so it picks up the new skill.

Use it in TypingMind

Enable Source Consumer Sync in any TypingMind chat and the model takes it from there. Its name and description sit in the system prompt, and the moment a request matches, the model loads the full instructions itself — you never invoke it by hand, and it costs no tokens until it is actually used.

The model loads Source Consumer Sync on its own as soon as a request matches it.

Works with any AI model

AI skills are plain Markdown instructions rather than provider-specific code, so Source Consumer Sync is not tied to the model it was written for. Install it once in TypingMind and use it with GPT-5, Claude, Gemini, Grok, DeepSeek, Mistral, Llama, or a local model you run yourself — all on your own API keys.

  • Loaded only when it is needed

    The system prompt carries just the name and description. The instructions are fetched on the first matching request, so an idle skill costs nothing.

  • Switch models mid-chat

    Because the skill is instructions rather than code, changing model does not break it — the next model reads the same SKILL.md.

Skill instructions

This is the SKILL.md content the model loads. Read it before installing — a skill is instructions your model will follow.

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、黄色偏离和部署同步证据。

Bundled files

The model reads these on demand while the skill is loaded. They are exposed as readable files and are never executed.

Frequently asked questions

What does the Source Consumer Sync AI skill do?

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

Why use Source Consumer Sync on TypingMind?

Because you install it once and use it with any model. Source Consumer Sync is plain Markdown rather than provider-specific code, so the same skill runs on GPT-5, Claude, Gemini, Grok, or a local model — and you can switch model mid-chat without it breaking. TypingMind runs on your own API keys, so you pay providers directly instead of a per-seat subscription, and your skills and chats stay in your own storage.

How do I install Source Consumer Sync in TypingMind?

Open Plugins → Skills → Install from GitHub in TypingMind and paste https://github.com/devcodex-labs/devcodex/tree/main/content/skills/source-consumer-sync. TypingMind reads its SKILL.md and bundles its files and installs it as a skill you can enable per chat.

Which AI models can use Source Consumer Sync?

Any model you connect in TypingMind. AI skills are plain Markdown instructions rather than provider-specific code, so GPT, Claude, Gemini, Grok, and local models can all load this skill when a request matches it.

How many AI models can I use with Source Consumer Sync?

As many as you like. As long as a model supports skills, you can use Source Consumer Sync with it — GPT, Claude, Gemini, Grok, DeepSeek, Mistral, Llama and more — all on TypingMind with your own API keys.

Is the Source Consumer Sync AI skill free?

Yes. It is published on GitHub by devcodex-labs under the AGPL-3.0 license. You only pay your own AI provider for the tokens you use.

What are AI skills?

An AI skill is a reusable instruction bundle that teaches an AI model how to do one specific task. It follows the open Agent Skills format: a SKILL.md file with a name and description, plus any scripts, templates or reference files the model may need. The model reads the instructions only when your request matches the skill, so an installed skill costs nothing until it is used.

How are AI skills different from plugins or MCP servers?

A plugin or MCP server gives a model new tools to call — code that runs somewhere and returns a result. An AI skill gives the model knowledge and process instead: how to approach a task, which steps to follow, what good output looks like. Skills are plain Markdown, so they need no server, no API key and no runtime, and they work with any model.

View all

Set up your own AI workspace now

Get notified about new features and future giveaways by subscribing to our newsletter 👇