代码库映射技能：自动生成技术栈、架构、安全等8类代码文档

sdd%3Acode-mapping by aaronbassett/agent-foundry

1 周安装量

1 GitHub Stars

GitHub

安装命令

npx skills add https://github.com/aaronbassett/agent-foundry --skill sdd:code-mapping

开发自动化技术文档

🇨🇳中文介绍

代码库映射技能

此技能为生成全面的代码库文档提供模板和分析指导。它支持四个重点领域，每个领域生成两份专业文档。

重点领域路由

调用时，检查 focus 参数以确定使用哪些模板和分析指南：

重点领域	使用的模板	分析指南
`tech`	stack.md, integrations.md	tech-analysis.md
`arch`	architecture.md, structure.md	arch-analysis.md
`conventions`	conventions.md, testing.md	conventions-analysis.md
`security`

广告位招租

在这里展示您的产品或服务

触达数万 AI 开发者，精准高效

联系我们

相关 Skills

FlyClaw：零登录航班聚合查询工具，Python实现多源航班信息与价格搜索

4,000,000 周安装

find-skills 技能搜索工具 - Vercel Labs 开源智能体技能包管理器

812,900 周安装

Vercel React 最佳实践指南 | 58条Next.js性能优化规则与代码重构

269,400 周安装

Vercel Web界面规范检查工具 - 自动检测代码是否符合Web设计指南

218,000 周安装

所有文档都写入：.sdd/codebase/

文件使用大写命名：STACK.md, INTEGRATIONS.md, ARCHITECTURE.md, STRUCTURE.md, CONVENTIONS.md, TESTING.md, SECURITY.md, CONCERNS.md

每个生成的文档必须：

具备可操作性：内容应指导未来的开发决策
包含文件路径：在反引号中引用实际路径以便导航（例如，src/api/auth.py）
保持最新：反映生成时代码库的实际状态
关注执行内容：仅捕获运行的内容（语言、运行时、框架、依赖项）
限制依赖项：记录 5-10 个最重要的依赖项，而非所有条目
指定版本：仅在兼容性重要时指定
使用规范性语言：用清晰的模式指导未来的代码生成

内容属于特定文档 - 避免重复：

如果内容是关于...	放入...	不要放入...
语言、框架、版本	STACK.md	ARCHITECTURE.md
外部 API、数据库、身份验证服务	INTEGRATIONS.md	STACK.md
系统设计、模式、数据流	ARCHITECTURE.md	STRUCTURE.md
目录布局、模块边界	STRUCTURE.md	ARCHITECTURE.md
代码风格、命名、错误处理	CONVENTIONS.md	TESTING.md
测试策略、框架、模式	TESTING.md	CONVENTIONS.md
身份验证、授权、漏洞	SECURITY.md	CONCERNS.md
技术债务、风险、待办事项	CONCERNS.md	任何其他文档

如何使用此技能

阅读特定重点的分析指南，来自 references/focus-guides/{focus}-analysis.md
加载相关模板，来自 references/templates/
分析代码库，遵循分析指南的说明
填充模板，使用发现的信息
写入文档，直接写入 .sdd/codebase/
仅返回确认信息：文件路径 + 行数

模板位于 references/templates/：

stack.md - 语言、框架、依赖项
integrations.md - 外部服务、API、数据存储
architecture.md - 系统设计、模式、数据流
structure.md - 目录布局、模块边界
conventions.md - 代码风格、命名、模式
testing.md - 测试策略、框架、模式
security.md - 身份验证、授权、漏洞
concerns.md - 技术债务、风险、已知问题

分析指南位于 references/focus-guides/：

tech-analysis.md - 如何分析技术栈和集成
arch-analysis.md - 如何分析架构和结构
conventions-analysis.md - 如何分析约定和测试
security-analysis.md - 如何分析安全和关注点

🇺🇸English

Codebase Mapping Skill

This skill provides templates and analysis guidance for generating comprehensive codebase documentation. It supports four focus areas, each producing two specialized documents.

Focus Area Routing

When invoked, check the focus parameter to determine which templates and analysis guides to use:

Focus Area	Templates to Use	Analysis Guide
`tech`	stack.md, integrations.md	tech-analysis.md
`arch`	architecture.md, structure.md	arch-analysis.md
`conventions`	conventions.md, testing.md	conventions-analysis.md
`security`	security.md, concerns.md	security-analysis.md

Output Location

All documents are written to: .sdd/codebase/

Files use UPPERCASE naming: STACK.md, INTEGRATIONS.md, ARCHITECTURE.md, STRUCTURE.md, CONVENTIONS.md, TESTING.md, SECURITY.md, CONCERNS.md

Document Quality Requirements

Each generated document MUST:

Be Actionable : Content should guide future development decisions
Include File Paths : Reference actual paths in backticks for navigation (e.g., src/api/auth.py)
Be Current : Reflect the actual state of the codebase at time of generation
Focus on What Executes : Capture only what runs (languages, runtime, frameworks, dependencies)
Limit Dependencies : Document 5-10 most important dependencies, not every entry
Specify Versions : Only when compatibility matters
Use Prescriptive Language : Guide future code generation with clear patterns

Exclusions by Document

Content belongs in specific documents - avoid duplication:

If Content Is About...	Put It In...	NOT In...
Languages, frameworks, versions	STACK.md	ARCHITECTURE.md
External APIs, databases, auth services	INTEGRATIONS.md	STACK.md
System design, patterns, data flow	ARCHITECTURE.md	STRUCTURE.md
Directory layout, module boundaries	STRUCTURE.md	ARCHITECTURE.md
Code style, naming, error handling	CONVENTIONS.md	TESTING.md
Test strategy, frameworks, patterns	TESTING.md	CONVENTIONS.md
Auth, authorization, vulnerabilities	SECURITY.md	CONCERNS.md
Tech debt, risks, TODOs	CONCERNS.md	Any other doc

How to Use This Skill

Read the focus-specific analysis guide from references/focus-guides/{focus}-analysis.md
Load the relevant templates from references/templates/
Analyze the codebase following the analysis guide instructions
Fill templates with discovered information
Write documents directly to .sdd/codebase/
Return confirmation only : file paths + line counts

Template Files

Templates are located in references/templates/:

stack.md - Languages, frameworks, dependencies
integrations.md - External services, APIs, data stores
architecture.md - System design, patterns, data flow
structure.md - Directory layout, module boundaries
conventions.md - Code style, naming, patterns
testing.md - Test strategy, frameworks, patterns
security.md - Auth, authorization, vulnerabilities
concerns.md - Tech debt, risks, known issues

Focus Guides

Analysis guides are located in references/focus-guides/:

tech-analysis.md - How to analyze tech stack and integrations
arch-analysis.md - How to analyze architecture and structure
conventions-analysis.md - How to analyze conventions and testing
security-analysis.md - How to analyze security and concerns

Weekly Installs

Repository

aaronbassett/ag…-foundry

GitHub Stars

First Seen

1 day ago

Installed on

zencoder1

amp1

cline1

openclaw1

opencode1

cursor1

agent-browser 浏览器自动化工具 - Vercel Labs 命令行网页操作与测试

147,400 周安装