architecture-scout SKILL.md skillA

architecture-scout from lixiuxiu559/agentforge is an agent skill: a SKILL.md folder an AI agent loads when a task calls for it.

Install it, pinned
mdr add lixiuxiu559/agentforge/architecture-scout@git:20260929.5c4b103

Pins git:20260929.5c4b103 in mdr.lock. Pin the fingerprint instead.

Audit grade
A, 17 of 17 checks passed
Kind
SKILL.md skill
Repository
lixiuxiu559/agentforge
Path
skills/architecture-scout/SKILL.md
Versions recorded
4
Latest version
git:20260929.5c4b103, committed Sep 29, 2026
First version recorded
Sep 24, 2026
Size
5,423 bytes
Repository stars
4
License
MIT

仅在用户明确要求架构机会调查时使用。调查值得深化的模块边界、跨模块修改的根因和难测试的结构;只报告,不修改代码,允许零候选。.

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

# 架构机会侦察

仅在用户主动要求架构调查时运行;实施或评审完成后不自动触发。

调查代码库中**有证据表明值得进一步设计**的模块边界。不把“代码看起来不漂亮”当作重构理由,也不把热点自动当架构问题。

这是**候选发现**,不是设计或实施:报告后停下,等用户选一个;不自行修改代码、架构文档或 ADR。

## 适用时机

- 大功能开工前:“怎样让接下来的改动更容易?”
- 某个概念每次修改都要跨多个文件、反复协调
- 现有模块难以通过公开接口测试
- 用户明确要求检查代码库结构或寻找改造机会

不作为 `implementation-workflow` 每次完成后的必经质量门。`complexity-audit` 分析函数级 CRAP 风险;`diff-review` 评审本次改动;本技能调查**模块级、面向未来改动的摩擦**。

## 委派

需要独立上下文时,用宿主通用子 agent 工具实际派发。传入目标项目的绝对路径、范围/基线、约束、所需技能资源的绝对路径和交付要求(资源不可读时附必要方法);子 agent 只做分配的任务,回报证据、完成状态与未验证项。仅在任务及文件/工具产物互不冲突时并行;无派发能力时自行执行并说明。

## 1. 先确定范围

用户指定模块、痛点或即将开展的需求时,以其为范围;否则通过近期相关提交找调查起点。提交热点**只决定先查哪里**,不证明那里需要改造。范围过大时先缩到具体业务概念;不要无目标全仓扫描。

## 2. 按调查规模取证

| 范围 | 调查方式 |
|---|---|
| 少数文件、单个明确问题 | 主 Agent 直接查 |
| 单个模块但调用链较长 | 1 个调查子 agent |
| 多模块、需要交叉核对 | 并行 2–3 个调查子 agent,按**结构/历史/测试与约束**分工 |
| 大范围且改造方向有争议 | 可增加第 4 个调查子 agent 专门找**反证与最小替代** |

**调查子 agent 只收集事实和反证,不决定哪个模块该重构。** 按 `references/research-briefs.md` 派发,各自返回证据;主 Agent 统一生成报告。

多个报告回来后按**证据**而非投票汇总:去重、核对互相矛盾的观察,抽查关键文件/行号,标记未知项。不得把几个调查子 agent 的猜测合并成“多方确认”。

## 3. 筛选候选:先过硬门槛

一个候选至少说清:

1. **真实摩擦**:具体哪类修改需要跨哪些模块;给出文件、调用路径或历史变更证据。
2. **当前边界为何浅**:接口暴露了什么本应隐藏的知识。
3. **删除测试**:去掉这层后,复杂度会集中在更小的接口后面,还是仅仅转移到调用方?转移或无法证明时,不推荐“深化”。
…

Read the whole file at its exact version.

How to install

The exact contents, by fingerprint
mdr add lixiuxiu559/agentforge/architecture-scout@sha256:03bad07f48b866ed

The line at the top of this page pins the label git:20260929.5c4b103, 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_zfetzqr33lzvnxgx.svg)](https://markdownregistry.com/a/art_zfetzqr33lzvnxgx)

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

Versions

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

versioncommittedcommitsizeaudit
git:20260929.5c4b103 latest2026-09-29 5c4b103 5,423 BA view · diff
git:20260929.105a6572026-09-29 105a657 5,034 BA view · diff
git:20260928.1f1d0042026-09-28 1f1d004 5,063 BA view · diff
git:20260924.4f0fdb92026-09-24 4f0fdb9 4,818 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 (5423 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

lixiuxiu559/agentforge · 4 stars · license MIT · pushed 2026-10-31 · branch main

API

GET https://markdownregistry.com/api/v1/artifacts/art_zfetzqr33lzvnxgx
GET https://markdownregistry.com/api/v1/resolve?ref=lixiuxiu559/agentforge/architecture-scout
GET https://markdownregistry.com/api/v1/blob/03bad07f48b866ed3a5d098b41c3797425105d26d645262236e28c44bc5b38bd

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 lixiuxiu559/agentforge

AGENTS.md AGENTS.md file
lixiuxiu559/agentforge · AGENTS.md
git:20261031.86f03d1 · audit A · 4 stars
architecture-design SKILL.md skill
lixiuxiu559/agentforge · skills/architecture-design/SKILL.md · 将需求、原型或明确技术问题转为完整的系统设计,默认交付含可见图示的 HTML。比较可行方案并由用户决定关键取舍,再完成整体与必要专项设计、风险验证和一致性复核;复杂专项可委派子…
git:20261030.1326a85 · audit A · 4 stars
bug-debugging SKILL.md skill
lixiuxiu559/agentforge · skills/bug-debugging/SKILL.md · 针对具体错误、失败测试、偶发异常或性能回归定位根因,并在用户确认修复方案后实施修复。适用于“排查这个 bug”“为什么这里失败”“修好这个异常”;不用于泛泛讲解报错含义、无具体症状的全仓找 bug 或仅评审 diff。
git:20260930.d24348c · audit A · 4 stars
complexity-audit SKILL.md skill
lixiuxiu559/agentforge · skills/complexity-audit/SKILL.md · 代码复杂度风险审计能力。当需要评估函数是否难以安全修改、分析复杂度与测试覆盖率、定位高 CRAP 值方法,或执行 Java、Python、Go、JavaScript、TypeScript 复杂度体检时使用。该能力只生成审计报告,不修改代码。
git:20260928.1f1d004 · audit A · 4 stars
diff-review SKILL.md skill
lixiuxiu559/agentforge · skills/diff-review/SKILL.md · 三轴代码评审。沿 Correctness(有 bug 吗)、Standards(符合本仓库文档化的编码规范吗)、Spec(忠实实现原始需求吗)三条轴评审一个 diff,各轴独立报告、不合并、不重排。当用户要求评审改动、做提交前审查、找…
git:20260929.9c61219 · audit A · 4 stars
implementation-workflow SKILL.md skill
lixiuxiu559/agentforge · skills/implementation-workflow/SKILL.md · 实施编排工作流。当用户要求实现功能、修复 Bug、重构代码、补充测试、拆分开发任务、并行编码或按质量门完成开发时使用。负责评估任务、拆分依赖、调度实施子任务,并按风险选择性调用 diff-review…
git:20261030.1326a85 · audit A · 4 stars
mutation-testing SKILL.md skill
lixiuxiu559/agentforge · skills/mutation-testing/SKILL.md · 通过项目已有突变测试工具审计现有测试能否发现代码逻辑错误。用户要求运行突变测试、分析存活突变体或无覆盖突变体时使用。支持 Java、Python、Go、JavaScript、TypeScript;只报告,不修改代码或测试。业务测试用例设计与…
git:20261009.171c8e9 · audit A · 4 stars
pm SKILL.md skill
lixiuxiu559/agentforge · skills/pm/SKILL.md · 将产品想法或需求变更整理为可评审、可验证的 PRD,默认交付便于阅读的 HTML 文件。当用户要求撰写或完善 PRD、梳理需求、明确业务规则、范围、用户故事或验收标准时使用。只澄清影响业务规则、范围或验收的缺口;需求明确时直接产出。只交付需…
git:20261029.640ec95 · audit A · 4 stars
prototype SKILL.md skill
lixiuxiu559/agentforge · skills/prototype/SKILL.md · 将 PRD 或明确的页面需求转为可走查的 HTML 原型与页面、字段、交互状态清单。当用户要求画原型、设计页面、制作 mockup 或修改已有原型时使用;只交付原型设计,不实施生产前端、设计 API 或部署。
git:20261029.640ec95 · audit A · 4 stars
research SKILL.md skill
lixiuxiu559/agentforge · skills/research/SKILL.md · 对需要多步取证、交叉验证或比较分析的问题开展系统调查,形成有证据支持的结论。适用于跨模块行为调查、版本差异分析、技术方案比较及存在多种解释的疑难问题。不用于简单事实查询、定位符号或配置、单次文档查阅,以及其他技能中的常规信息确认。
git:20261023.3bafb01 · audit A · 4 stars
test-design SKILL.md skill
lixiuxiu559/agentforge · skills/test-design/SKILL.md · 独立基于业务规则和可用材料设计测试用例、评估场景与断言缺口,默认交付便于阅读的 HTML 测试设计。适用于开发前的用例设计、检查已有用例遗漏和评估业务场景覆盖;不要求已有架构方案,不编写或执行测试,不运行覆盖率/突变工具或诊断修复失败。
git:20261029.640ec95 · audit A · 4 stars
wiki SKILL.md skill
lixiuxiu559/agentforge · skills/wiki/SKILL.md · 为代码仓库生成并维护项目 Wiki(项目文档、知识库、代码导读、架构说明、模块说明、开发指南),既供 Agent 按目录查阅,也供人阅读;Markdown 提交在仓库…
git:20261031.d2c78c3 · audit A · 4 stars

Every file in lixiuxiu559/agentforge

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