Home / ccdawn / codex-skills · skills/engineering/briefbound-project-dissection/SKILL.md · GitHub

briefbound-project-dissection skillA

briefbound-project-dissection is agent-read markdown (skill) from ccdawn/codex-skills: 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..

Indexed from public GitHub and served as immutable, content-addressed versions. Install it pinned to an exact SHA-256 with the mdr CLI, and every file is verified against the hash recorded here before it reaches your agent. The deterministic audit below grades the latest version, and the same file always earns 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-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

Latest version
mdr add ccdawn/codex-skills/briefbound-project-dissection@git:20260916.05a1148
Exact content
mdr add ccdawn/codex-skills/briefbound-project-dissection@sha256:4310053d54c12227

Pin to a label to follow the author's releases, or to a sha256 to freeze the exact bytes forever. Either way the resolved hash is written to mdr.lock, and mdr install reproduces it on any machine.

Badge

mdr badge

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

1 badge views in 30 days

Versions

versioncommittedcommitsizeaudit
git:20260916.05a1148 latest2026-09-16 05a1148 4,868 BA view

Audit of the latest version

A  17 of 17 checks passed. Deterministic, no model, 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 (4868 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-09-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/4310053d54c12227d9cfab1fcb33471ba7968800a7e8f00f935d17e0b8d55e3b

Your agent 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.

More from ccdawn/codex-skills

AGENTS.md agents
ccdawn/codex-skills · AGENTS.md
git:20260813.dec1d14 · audit A · 6 stars
CLAUDE.md claude
ccdawn/codex-skills · CLAUDE.md
git:20260813.dec1d14 · audit A · 6 stars
briefbound-huawei-nslb-score-loop skill
ccdawn/codex-skills · skills/competition/briefbound-huawei-nslb-score-loop/SKILL.md · Use when a Huawei Algorithm Challenge 37 NSLB workspace needs live status, adaptive solver search, comparable…
git:20260916.292b0ac · audit A · 6 stars
briefbound-score-loop 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:20260916.292b0ac · audit A · 6 stars
briefbound-creative-toolbox 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
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-api-contract 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
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:20260919.ae05288 · audit A · 6 stars
briefbound-bdd-tdd-development 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
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
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
briefbound-design-system skill
ccdawn/codex-skills · skills/engineering/briefbound-design-system/SKILL.md · Use when a frontend task primarily concerns cross-component design tokens, semantic theming, component APIs, variants…
git:20260916.292b0ac · audit A · 6 stars

Every file in ccdawn/codex-skills

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