SuperAPI AI 工具集

sdlc-documentation

写作与研究

查看项目

更新于 10-16 05:40

技能介绍

用途

SDLC Documentation 是一个用于软件开发生命周期(SDLC)文档编写、评审与整合的父技能入口。它适用于创建或评审 SDLC 文档集、交付证据、可追溯性、阶段门禁和生命周期交接,也适用于整合规划、设计、测试、部署、用户上线、部署后及维护文档,以及将项目文档与实现、验证、发布和支持义务对齐。

主要能力

该技能以父技能形式作为活动的 SDLC 文档入口点,阶段特定细节保留在 references 中,只加载当前正在编写或评审的阶段。工作流包括:加载 world-class-engineering 作为基线交付质量;按需加载阶段参考文件,包括 references/sdlc-planning.md(项目规划与启动)、references/sdlc-design.md(解决方案与技术设计文档)、references/sdlc-testing.md(测试规划、证据与验收门禁)、references/sdlc-user-deploy.md(用户上线与采用文档)、references/sdlc-post-deployment.md(上线评审与稳定化证据)、references/sdlc-maintenance.md(支持、维护与持续改进)。在任务需要时,可与 project-requirements、advanced-testing-strategy、deployment-release-engineering 或 implementation-status-auditor 配合使用。

使用方式

使用前需收集具体的系统、仓库、环境、约束和交付物,然后识别需要哪个已吸收的参考文件,不要默认加载所有迁移参考。仅在工作流中命名的 references/.md 文件需要其深度时才加载。

适用场景

适用于创建或评审 SDLC 文档集、交付证据、可追溯性、阶段门禁和生命周期交接;整合规划、设计、测试、部署、用户上线、部署后及维护文档;将项目文档与实现、验证、发布和支持义务对齐。

限制

当任务与本父技能无关,或更适合由工作流中命名的更窄的活动父技能处理时,不应使用。当请求只需要一个简单答案且不需要加载任何参考模块时,也不应使用。质量要求包括:每份文档必须与决策、验收标准、发布门禁或运营义务挂钩;保持从需求到设计、实现、测试证据、发布和支持的可追溯性;避免无法指导实现或审计决策的通用 SDLC 文本。反模式包括:将已吸收的参考文件视为活动技能或单独的路由入口点;加载每个迁移的子参考而不是匹配任务的那一个;在没有约束、证据或下一步验证步骤的情况下生成通用建议。输出包括 SDLC 文档、评审发现、可追溯性说明、阶段门禁清单或交接包。