Mdc workflow
Multi-Document Co-driven Agent Workflow for Claude Code — stop your docs from rotting. 中英文双语
npx -y skills add nbhhdd/mdc-workflow --skill mdc-workflowAssembled from the repository path, not quoted from the project. Check it against their README if it does not work.
One thing to look at
- 1 stars1 stars. Stars are a popularity signal and not a quality one, but at this level it is likely that nobody has read this closely except its author, and you would be relying on your own review.
What its author says it does
Copied from the file, not written here
Initialize or upgrade a project's Multi-Document Co-driven (MDC) workflow system. Use when the user asks to "set up MDC", "initialize document workflow", "create project docs system", "set up TS-Protocol", "create multi-document agent workflow", "建立文档工作流", "初始化文档体系", "搭建 MDC", or wants to establish a structured documentation-driven development system. Also triggers when user describes document-code desync problems or wants reusable AI collaboration standards.
SKILL.md
4.8 KB, as published. Nobody here has run it
MDC Workflow — Multi-Document Co-driven Agent Workflow
为任意项目建立"多文档解耦 + 时间戳闭环 + 按需路由 + 自反思校验"的 AI 协作基础设施。
Establish a "multi-document decoupling + timestamp closed-loop + on-demand routing + self-reflection" AI collaboration infrastructure for any project. No code required — pure Markdown orchestrates the LLM.
Quick Start / 快速开始
- User types
/mdc-workflowor says "建立文档工作流 / set up MDC workflow" - Ask about: project name, tech stack, scale, language preference
- Pick template set by scale (ultra-minimal → full)
- Generate docs, filling
{{PLACEHOLDERS}}with project context - List files to be created → wait for user confirmation → write
Scale Selection / 规模选择
| Scale | Files Generated | When to Use |
|---|---|---|
| ultra-minimal | AGENTS.md + project-docs/错误记录.md | Personal tool, < 5 source files |
| minimal | ultra-minimal + 00-总览/README.md | Solo project, < 10 files |
| standard | AGENTS.md + 5 docs (router, code-standards, error-archive, file-standards, test-strategy) | Team 3-10, 6+ months |
| full | standard + 01-方向 + 02-需求 + 03-架构 + 05-AI + 08-版本 | Team > 10, 2+ years |
Language Selection / 语言选择
Ask: "项目文档使用什么语言?/ What language for the project docs?"
| Answer | Template Dir | Doc Directory Names |
|---|---|---|
| 中文 / Chinese / zh | templates/zh/ | 00-总览/, 06-代码规范/, 10-错误记录/ etc. |
| English / en | templates/en/ | 00-overview/, 06-standards/, 10-errors/ etc. |
| 双语 / Bilingual | Generate from both, primary router in preferred language | Mixed |
Template Inventory / 模板清单
Chinese (templates/zh/)
| Stage | Template | Output |
|---|---|---|
| Entry | AGENTS.md | ./AGENTS.md |
| Entry (ultra-minimal) | AGENTS.ultra-minimal.md | ./AGENTS.md |
| Router | router.md | project-docs/00-总览/README.md |
| Code Standards | code-standards.md | project-docs/06-代码规范/代码编写与AI协作规范.md |
| Error Archive | error-archive.md | project-docs/10-错误记录/错误档案.md |
| File Standards | file-standards.md | project-docs/07-文件规范/项目文件存放规范.md |
| Test Strategy | test-strategy.md | project-docs/04-测试文档/测试策略与验收标准.md |
English (templates/en/)
| Stage | Template | Output |
|---|---|---|
| Entry | AGENTS.md | ./AGENTS.md |
| Entry (ultra-minimal) | AGENTS.ultra-minimal.md | ./AGENTS.md |
| Router | router.md | project-docs/00-overview/README.md |
| Code Standards | code-standards.md | project-docs/06-standards/code-and-ai-collaboration.md |
| Error Archive | error-archive.md | project-docs/10-errors/error-archive.md |
| File Standards | file-standards.md | project-docs/07-files/project-file-standards.md |
| Test Strategy | test-strategy.md | project-docs/04-testing/test-strategy.md |
Post-Generation / 生成后
- Tell user the doc system is ready
- Remind: AI enters workflow via
AGENTS.mdeach new session - Optional: run
scripts/check-docs.shto verify doc-code timestamp consistency - Tell user: run
/mdc-workflowlater to add missing doc modules
Compatibility / 兼容性
If project already has docs:
- Never overwrite existing content without permission
- Add
last_updatedfield to existing doc headers - Fill missing entries in the router's metadata index
- Mark stale docs with
[needs update]instead of editing silently
Scripts / 脚本
scripts/check-docs.sh— Cross-platform script that scansproject-docs/forlast_updatedtimestamps and compares against git log modification times of associated code modules. Reports any doc that is older than its linked code.
Anti-Abuse / 防滥用
- Do NOT overwrite existing files unless user explicitly approves
- Do NOT run destructive operations on non-git projects
- Always list files to be created → wait for confirmation → then write
- Templates are read-only; generated files are written to the user's project