用途:分析代码库并生成架构/代码说明文档,所有说明以“why(为什么这样做)”为中心,而非“what(做了什么)”。
主要能力与两种模式:
- diff 模式:/code-architecture-writer diff <base_branch> [output.md],比较基准分支(如 main),输出分支间变更文件的说明文档,默认输出 CODE_CHANGES_EXPLANATION.md。
- flow 模式:/code-architecture-writer flow <entrypoint.py> [output.md],从入口文件追踪完整执行流程,默认输出 ARCHITECTURE_FLOW.md。
工作流程分四阶段:目标分析(diff 用 git diff 提取变更文件,flow 追踪 import/调用链)、深度阅读(读取文件、分析“为什么是这个文件”、映射函数/类关系)、文档生成(变更文件汇总表、逐文件 why 说明、ASCII 执行流程图、设计决策问答表)、质量检查(完整性、why 覆盖、代码片段与真实代码一致、图表准确)。
使用方式:在支持该技能的 Claude 环境中以斜杠命令调用,需提供基准分支或入口文件路径,可选指定输出文件。
限制与注意:代码片段必须用 Read 工具从真实文件摘录,禁止凭记忆重构;变更量须直接采用 git diff --stat 结果;提交哈希用 git rev-parse --short;行号须准确;每个文件与变更块都必须包含 why 说明;diff 模式不得遗漏任何变更文件,flow 模式须覆盖调用链核心文件。说明正文以韩语撰写,代码、变量名、文件名保持原文,技术术语保留英文。具体安装方式、收费与平台支持暂未提供。