SuperAPI AI 工具集

feature-manifest

通用与其它

查看项目

更新于 10-16 09:54

技能介绍

用途:该技能用于操作功能清单系统,追踪功能与其实现之间的对应关系。当需要新建功能、修改已有功能代码、查看某文件属于哪个功能、校验清单准确性、更新变更日志或运行功能健康检查时启用。

主要能力与常用命令: 列出所有功能:npm run feature:info -- --list 查看某功能详情:npm run feature:info -- <feature-id> 查找某文件归属的功能:npm run feature:info -- --files <path> 校验全部清单:npm run feature:validate 检查功能健康(陈旧、孤立、覆盖率):npm run feature:health 创建新功能清单:npm run feature:create

新建功能流程:先创建清单(npm run feature:create -- --id=my-feature --name="My Feature"),再实现功能并逐步登记实现文件、测试、依赖与环境变量,提交前运行校验。 修改已有功能流程:先读取清单,修改实现文件后把新文件加入 implementation.files,更新 history.last_modified 与变更日志,再运行校验。

清单结构包含 id、name、status(planned/in-progress/complete/deprecated)、priority、description、implementation(files、entry_point、database_tables、api_routes)、tests(unit/integration/e2e)、dependencies(internal/external/env_vars/secrets)、history、changelog 等字段。

健康报告解读:健康功能表示清单与代码一致且存在测试;陈旧功能指清单 90 天以上未更新,或代码在清单更新后发生变更;无测试指已完成但未登记测试;孤立文件指 src/ 下未被任何清单追踪的文件;建议清单指应新建清单的新目录。

最佳实践:一个清单对应一个功能;每次变更都更新清单;变更日志只追加不修改旧条目;登记全部文件避免孤立;用依赖字段标明功能间关系。

限制:资料仅给出上述命令、流程与结构,未提供安装方式、平台要求、定价及实际效果等更多信息。