briefbound-project-dissection SKILL.md skillA

briefbound-project-dissection from ccdawn/codex-skills is an agent skill: a SKILL.md folder an AI agent loads when a task calls for it.

Install it, pinned
mdr add ccdawn/codex-skills/briefbound-project-dissection@git:20260929.25d03f6

Pins git:20260929.25d03f6 in mdr.lock. Pin the fingerprint instead.

Audit grade
A, 17 of 17 checks passed
Kind
SKILL.md skill
Repository
ccdawn/codex-skills
Path
skills/engineering/briefbound-project-dissection/SKILL.md
Versions recorded
2
Latest version
git:20260929.25d03f6, committed Sep 29, 2026
First version recorded
Sep 16, 2026
Size
4,929 bytes
Repository stars
6
License
MIT

Use when the user wants to understand or learn a repository through source-guided architecture explanation, a representative execution path, design tradeoffs and a reading route; not for risk-first project audits or isolated function questions.

Collected from public GitHub. Every version is saved exactly as it was and never changes. Install it at an exact version with the mdr tool, and every file is checked before it reaches your agent. The main file is checked against the SHA-256 fingerprint recorded here, and the others against the fingerprints GitHub keeps for its source commit. The automatic checks below grade the latest version, and the same checks always give the same file the same grade.

What the file says

# Briefbound 项目拆解教学

把仓库变成能推理、能迁移的理解:从实际数据结构和入口追到业务结果,解释设计选择的代价与失效边界。中文讲解,关键文件、函数与 API 保留原名。

## Briefbound task contract

- Context Boundary: 目标仓库、用途、基准 commit/工作区差异、已读模块、代表链路和未覆盖范围。
- Output Contract: 中文拆解报告、代码证据、阅读路线;完整拆解默认附架构总览和主链路图及独立 HTML/SVG/PNG。
- Allowed Action: 只读目标源码;在任务输出目录生成事实材料、报告与图解。远程源码可克隆到任务临时目录;不安装或运行被调研项目。
- Success Evidence: 解释与代码位置对应,事实与推断分开,主链路可追溯,图解实际导出并通过检查,未覆盖范围如实披露。
- Stop Condition: 缺少决定结论的源码、关键关系无法确认、范围扩大或输出格式无法完成。
- Route Out: 风险审查交 briefbound-project-review;复用选型交 briefbound-feature-reuse-research;图解交 briefbound-diagram-design;验证后的真实残留转 briefbound-development-cleanup;目标分歧交 briefbound-router。

## 统一调用契约

用户可见内容默认中文;Route Out 仅以 Briefbound task contract 为准。末行 `下一步建议: <一个具体动作>`,且限于决策类建议(推荐方向、优先级或需用户拍板的选项,如后续深读方向),不把可自行完成的执行步骤包装成建议交回。继承已确认仓库、用途和深度,不重复询问。普通局部函数解释直接回答,不启动整仓报告。

## 取证与讲解

1. 明确项目解决的问题和最具代表性的场景。先读 README、核心数据结构、入口和测试,再沿该场景追调用、数据转换与输出;不要默认把所有项目套成四层架构。
2. 全仓拆解时读取 [取证与交付](references/dissection-guide.md),复用 `scripts/scan_repo.py <repo> --out <task-output>/facts` 生成事实材料。已有足够材料或局部问题无需重复全量扫描。扫描输出也是待核对的数据,不是架构结论。
3. 先建立主干再补必要分支;默认追一条代表链路,但不能因固定层数截断关键事务、异步调用或错误传播。
4. 对所选核心模块解释:承担什么职责;本项目约束下有哪些选择及代价;迁移到别处时何时适用、何时失效。不固定句数,不虚构作者否决过某替代方案。
…

Read the whole file at its exact version.

How to install

The exact contents, by fingerprint
mdr add ccdawn/codex-skills/briefbound-project-dissection@sha256:81171a96a5151dce

The line at the top of this page pins the label git:20260929.25d03f6, which is what most people want. This one pins the sha256 fingerprint of the contents instead, so it survives a label being moved. Either way the exact version is written to mdr.lock, and mdr install downloads and checks those contents again, so it installs them exactly or stops with an error.

Badge

mdr badge

[![mdr](https://markdownregistry.com/badge/art_6ugybthny23z2xgb.svg)](https://markdownregistry.com/a/art_6ugybthny23z2xgb)

2 badge image fetches in 30 days. What the badge shows.

Versions

The registry has recorded 2 versions of this file, between Sep 16, 2026 and Sep 29, 2026, about one every 13 days.

versioncommittedcommitsizeaudit
git:20260929.25d03f6 latest2026-09-29 25d03f6 4,929 BA view · diff
git:20260916.05a11482026-09-16 05a1148 4,868 BA view

Audit of the latest version

A  17 of 17 checks passed. Fixed automatic checks with no AI involved, so the same checks give the same answer every run.
  • pass: Frontmatter block present
  • pass: Frontmatter declares a name
  • pass: Frontmatter declares a description
  • pass: Size between 200 bytes and 200 KB (4929 bytes)
  • pass: No zero-width or bidi control characters
  • pass: No instruction hidden inside an HTML comment
  • pass: No link to an exfiltration or paste host
  • pass: No credential-shaped string
  • pass: No instruction to send local credentials anywhere
  • pass: No text hidden with inline styles
  • pass: No prompt-injection phrasing
  • pass: No curl or wget piped into a shell
  • pass: No recursive delete of root, home or parent
  • pass: No instruction to read or print local credentials
  • pass: No base64 blob over 200 characters
  • pass: No link to a raw IP address
  • pass: No script tag

Source

GitHub

ccdawn/codex-skills · 6 stars · license MIT · pushed 2026-10-22 · branch main

API

GET https://markdownregistry.com/api/v1/artifacts/art_6ugybthny23z2xgb
GET https://markdownregistry.com/api/v1/resolve?ref=ccdawn/codex-skills/briefbound-project-dissection
GET https://markdownregistry.com/api/v1/blob/81171a96a5151dce24d6f3887683b04f09a329c7246ec493699c1af227bd7893

Your AI assistant does the legwork. You hear about the deals worth your word. Hand yours the standing instructions at modelranch.com and it joins the network that reads files like this one.

Guides: the SKILL.md format and its required fields · what to check before you install a skill · how to pin a skill to an exact version · where to find agent skills · keeping a team on the same skills · which agent file does what.

More from ccdawn/codex-skills

AGENTS.md AGENTS.md file
ccdawn/codex-skills · AGENTS.md
git:20260813.dec1d14 · audit A · 6 stars
CLAUDE.md CLAUDE.md file
ccdawn/codex-skills · CLAUDE.md
git:20260813.dec1d14 · audit A · 6 stars
briefbound-pengyou SKILL.md skill
ccdawn/codex-skills · skills/companion/briefbound-pengyou/SKILL.md · Use when 用户开启闲聊会话——点名「陪我聊聊」「随便聊聊」「聊两句」「朋友模式」,或明确想没目的地东聊西聊。AI 像朋友一样主动找话题、带节奏、说不同意见,而不是顺着用户聊。工作、编码、任务型请求不加载本技能;用户情绪低落想倾诉时转…
git:20261021.9e6ce32 · audit A · 6 stars
briefbound-score-loop SKILL.md skill
ccdawn/codex-skills · skills/competition/briefbound-score-loop/SKILL.md · Use when repeated work is governed by an explicit metric, active baseline, candidate search, promotion rule…
git:20260929.25d03f6 · audit A · 6 stars
briefbound-creative-toolbox SKILL.md skill
ccdawn/codex-skills · skills/creative/briefbound-creative-toolbox/SKILL.md · Use when the user wants non-obvious but useful ideas, concept invention, naming, reframing, variation, selection…
git:20260916.292b0ac · audit A · 6 stars
briefbound-diagram-design SKILL.md skill
ccdawn/codex-skills · skills/creative/briefbound-diagram-design/SKILL.md · Use when creating or redrawing structured diagrams such as architecture, flowcharts, sequences, ER/UML, timelines or…
git:20260916.ed1d50d · audit A · 6 stars
briefbound-adr SKILL.md skill
ccdawn/codex-skills · skills/engineering/briefbound-adr/SKILL.md · Use when the user asks to record a settled architecture or technology decision as an ADR(写 ADR、记录决策、技术选型定案存档), or a…
git:20260929.20085bb · audit A · 6 stars
briefbound-api-contract SKILL.md skill
ccdawn/codex-skills · skills/engineering/briefbound-api-contract/SKILL.md · Use when a change touches an external contract surface - REST/GraphQL endpoints, request/response schemas, DB schema…
git:20260920.280b6d2 · audit A · 6 stars
briefbound-autonomous-collaboration-loop SKILL.md skill
ccdawn/codex-skills · skills/engineering/briefbound-autonomous-collaboration-loop/SKILL.md · Use when the user explicitly enables an automated same-project multi-thread development loop that keeps peer Codex…
git:20260929.25d03f6 · audit A · 6 stars
briefbound-bdd-tdd-development SKILL.md skill
ccdawn/codex-skills · skills/engineering/briefbound-bdd-tdd-development/SKILL.md · Use when an already-defined new behavior or high-risk implementation contract needs a failing test before…
git:20260916.292b0ac · audit A · 6 stars
briefbound-bug-review SKILL.md skill
ccdawn/codex-skills · skills/engineering/briefbound-bug-review/SKILL.md · Use when an observed bug, correctness regression, failing test, build failure, abnormal behavior, or unresolved root…
git:20260916.292b0ac · audit A · 6 stars
briefbound-code-structure-guard SKILL.md skill
ccdawn/codex-skills · skills/engineering/briefbound-code-structure-guard/SKILL.md · Use when active development or explicit refactoring has concrete code-structure risk: a source file is accumulating…
git:20260916.292b0ac · audit A · 6 stars

Every file in ccdawn/codex-skills

Browse by kind, by grade A, or by owner.