用途:peach-doc-feature 将现有功能中隐含的设计依据、业务决策与历史背景转为结构化规格文档,输出到 docs/기능별설명/{카테고리명}/{기능명}/,文件命名格式为 {기능명}-{주제}.md。개요.md 作为入口与索引,供 AI 只加载所需文档。它的产出不是普通文档集合,而是可在后续规划、实现与 QA 阶段重新注入上下文的 as-is Context Pack。新功能规格应先使用 peach-gen-spec。
主要能力:采用三层隐性知识提取流程。第一层由 AI 用 Read/Glob/Grep 做代码静态分析,并用 Bash 执行 Git 考古(变更频率、co-change、提交信息);第二层通过 AskUserQuestion 向开发者进行对话式提问(CDM 探针问题集);第三层 AI 自我验证并补问遗漏。主题文件类型包括 처리흐름、에러코드、설계결정(ADR 格式)、매핑-表名、파싱、상태코드、입력、TDD-가이드 等。
使用方式:触发关键词为“功能文档化”“现有功能分析”“as-is 整理”“docs/功能별说明 生成”。输入为分类名、功能名及可选一行说明。复杂功能可按主题细分为 8-12 个文件,简单功能 3-4 个;{기능명}-개요.md 必建,{기능명}-TDD-가이드.md 始终独立。TDD 指南含测试文件列表、执行命令(如 bunx vitest run {路径})与示例数据位置。
适用场景:既有功能改进或修改前做 as-is 文档化;新功能实现后对高改动风险的核心功能做选择性文档化;与 peach-team-dev、peach-team-3a 或 gen-spec 协作时作为预加载上下文。
限制:仅在存在可分析代码时有效;代码无法解释的原因需依赖开发者回答,未答复项记为“미확인 사항”;具体工具链、版本、平台支持等未提供。