用途:为软件项目或代码库创建与维护高质量技术文档,并在功能、测试、部署等变更后同步更新。触发场景包括用户请求创建或审查文档、增删改功能、修改测试或部署流程。
主要能力:维护 README.md(项目概览、结构、安装与常用命令)、TODO.md(路线图与任务跟踪,仅当已存在时维护)、docs/DESIGN.md(视觉与 UX 设计)、docs/architecture-and-walkthrough.md(架构决策 ADR、服务关系、用户旅程)、docs/testing.md(测试范围、工具、CI/CD 与手动验证)、deployment/README.md(部署方式、Terraform、密钥与流水线),以及 conductor/ 下的 product.md、product-guidelines.md、tech-stack.md(仅当已存在,且严禁改动该目录其他文件)。
使用方式:先读取现有文档与 conductor/tech-stack.md,核对代码、配置、环境变量与命令参数后再更新;对未知设计选择主动提问。若存在 technical-writer 技能则必须协同使用,否则按流程检查并建议安装:npx skills ls -g,经同意后执行 npx skills add https://github.com/shubhamsaboo/awesome-llm-apps --skill technical-writer -g -y。按十步审查清单执行,最后用表格汇总各文档更新状态与原因。
格式规则:标题后必须空行;配置、模型字段与设计决策用表格;代码用带语言标识的围栏代码块;禁止 Mermaid 或 ASCII 图,需图示时生成 PNG 存入仓库并以相对链接嵌入。
限制:TODO.md 与 conductor/ 文档仅在已存在时维护;不得修改 workflow.md、tracks.md、setup_state.json、code_styleguides/ 与 archive/;不得假设现有文档准确,须先验证。