harness-step2-fill-docs SKILL.md skillA
harness-step2-fill-docs from simbajigege/book2skills is an agent skill: a SKILL.md folder an AI agent loads when a task calls for it.
mdr add simbajigege/book2skills/harness-step2-fill-docs@git:20260713.a707ed3Pins git:20260713.a707ed3 in mdr.lock. Pin the fingerprint instead.
- Audit grade
- A, 17 of 17 checks passed
- Kind
- SKILL.md skill
- Repository
- simbajigege/book2skills
- Path
skills/harness-step2-fill-docs/SKILL.md- Versions recorded
- 2
- Latest version
- git:20260713.a707ed3, committed Jul 13, 2026
- First version recorded
- Apr 14, 2026
- Size
- 11,933 bytes
- Repository stars
- 202
- License
- MIT
Harness Engineering 第一阶段第二步：深度分析项目代码，填充业务解决方案、架构、约定、技术决策和质量标准等 docs/ 知识库内容。 在 harness-step1-create-agents-md 创建好目录骨架之后使用。当用户说"填充文档内容"、 "完善 docs/ 文件"、"让文档有实质内容"、"分析项目写架构文档"、"写 ARCHITECTURE.md"、 "写技术决策文档"、"从业务视角理解项目"、"完善 business-solution.md"时，立即使用此 skill。 前置条件：项目中已有 AGENTS.md 和 docs/ 目录骨架（由 harness-step1 创建）。.
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
# Harness Step 2: 填充 docs/ 知识库内容 ## 目标 通过深度阅读项目代码，将隐藏在代码里的业务能力、用户流程、架构知识、命名约定、技术决策， 显式地写入 docs/ 各文件。让 agent 在任何 session 都能快速理解项目全貌。 **核心原则**：推断出来的内容要标注来源，无法确定的内容标注「待补充」， 不要用模糊的占位符糊弄过去。 --- ## 执行步骤 ### Step 1：深度扫描 在写任何文档之前，先充分读懂项目。按顺序执行： ```bash # 1. 确认 docs/ 骨架已存在 ls docs/ # 2. 读懂目录结构（3层） find . -maxdepth 3 \ -not -path '*/node_modules/*' -not -path '*/.git/*' \ -not -path '*/__pycache__/*' -not -path '*/dist/*' \ -not -path '*/.next/*' -not -path '*/build/*' | sort # 3. 读主要入口文件 # （根据技术栈判断：main.ts / main.py / app.go / index.js 等） # 4. 读模块边界（各主要目录的 index 文件或第一个文件） # 目标：搞清楚每个目录的职责 # 5. 读依赖声明 cat package.json 2>/dev/null || cat pyproject.toml 2>/dev/null || \ cat go.mod 2>/dev/null || cat Cargo.toml 2>/dev/null # 6. 读已有文档（复用，不重复） cat README.md 2>/dev/null cat AGENTS.md 2>/dev/null ``` 扫描目标——在写文档前，必须能回答这些问题： - 这个项目服务哪些用户/角色？他们要完成什么任务？ - 它解决哪些业务痛点，哪些能力已经由页面、路由、API 或 service 实现？ - 用户从输入资料/发起操作到得到业务结果的核心流程是什么？ - 哪些只是 README 宣传、路线图或合理二开设想，尚不能视为现有能力？ - 这个项目分成哪几个主要模块？每个模块做什么？ - 代码调用链是怎样的？（UI → ? → ? → 数据层） - 用了哪些主要的库/框架？能推断出选择原因吗？ - 文件命名有什么规律？变量命名有什么规律？ - 什么情况会导致测试失败？验收标准是什么？ --- ### Step 2：写 `docs/business-solution.md` …
Read the whole file at its exact version.
How to install
mdr add simbajigege/book2skills/harness-step2-fill-docs@sha256:a6e253095d420f25The line at the top of this page pins the label git:20260713.a707ed3, 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.
[](https://markdownregistry.com/a/art_7icpcizybes4wgeq)
5 badge image fetches in 30 days. What the badge shows.
Versions
The registry has recorded 2 versions of this file, between Apr 14, 2026 and Jul 13, 2026, about one every 90 days.
| version | committed | commit | size | audit | |
|---|---|---|---|---|---|
| git:20260713.a707ed3 latest | 2026-07-13 | a707ed3 | 11,933 B | A | view · diff |
| git:20260414.6a7e3e4 | 2026-04-14 | 6a7e3e4 | 8,557 B | A | view |
Audit of the latest version
- pass: Frontmatter block present
- pass: Frontmatter declares a name
- pass: Frontmatter declares a description
- pass: Size between 200 bytes and 200 KB (11933 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
simbajigege/book2skills · 202 stars · license MIT · pushed 2026-08-26 · branch main
API
GET https://markdownregistry.com/api/v1/artifacts/art_7icpcizybes4wgeq GET https://markdownregistry.com/api/v1/resolve?ref=simbajigege/book2skills/harness-step2-fill-docs GET https://markdownregistry.com/api/v1/blob/a6e253095d420f253d5015f873e6f5530397183a033dcbec83d6f1f39f95dbdd
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.