用途:把现有功能中代码未明说的隐性知识(设计依据、业务决策、历史)转成结构化规格书,形成 as-is Context Pack,便于后续修改前定位范围、保留决策背景、完成测试。触发关键词:功能文档化、现有功能分析、as-is 整理、docs/功能별설명 生成。新增功能应改用 peach-gen-spec。
主要能力:三层提取流水线。一层由 AI 自动分析代码与 Git 历史:模块结构、依赖、模式,变更频率(如 git log --oneline {文件} | wc -l)、共同变更模式、提交信息中的设计依据;并生成按主题拆分的 md 草稿。二层由 AI 就代码无法判断的项向开发者提问,使用 AskUserQuestion,每批 3-5 个问题,采用 CDM 探针问题(最难的决策、设计变更原因、新手陷阱、不可删除的代码、基于发现的动态问题)。三层自检“仅读此文档能否修改功能”,补充追问。
文档结构:路径为 docs/功能별설명/{分类}/{功能}/;分类如 회원관리、게시판、결제、상품、주문、정산,空格以连字符替代;全部文件名采用 {功能}-{主题}.md。{功能}-개요.md 必建,包含摘要、整体流程、相关代码文件表(Controller/Service/DAO/Type/Store/Component)与文档索引表;{功能}-TDD-가이드.md 始终独立。主题类型包括处理流程、错误码、设计决策(ADR 格式:决定/背景/决定/后果)、数据映射、解析规则、状态码映射、输入数据。文件数按复杂度灵活:简单 3-4 个,复杂 8-12 个,单文件超 100 行考虑拆分。TDD 指南含测试文件列表、执行命令(bunx vitest run {路径})、样例数据位置、速查表。
用法与场景:修改现有功能前做 as-is 文档化;新功能完成后对高改动可能的核心功能选择性文档化。后续将整个文件夹注入上下文,AI 以 개요.md 为入口按索引仅加载所需文档;可与 peach-gen-spec、peach-agent-team、peach-agent-team-refactor 联动。
限制:需能访问现有代码方可有效;“不知道/不适用”的回答会记为未确认事项。未提供具体安装方式、平台、收费与效果信息。