build-feature

用途

build-feature 是 todoist-cli 仓库中的一项开发流程技能，用于新增命令、标志或行为。它强调先与项目负责人确认开放决策，再以测试优先的薄切片方式实现。资料给出的触发场景是当被要求“add”“build”等功能时使用。

主要流程

1. 阅读最接近的现有功能及测试作为模板。资料举例：返回实体的写入参考 src/commands/task/add.ts，列表参考 src/commands/today.ts，带 --yes 的破坏性写入参考 src/commands/label/delete.ts；新增命令或子命令时，add-command 是需触碰文件的清单；并阅读 AGENTS.md 中的规则。

2. 一轮内确定所有开放决策。列出请求中未明确的事项，例如命令与标志命名、位置参数或命名标志、人类可读与 --json 输出、错误码、--dry-run 与 --yes、只读令牌下的行为；一次性向负责人提问并给出建议。

3. 把“完成”写成可检查的行为，例如“td label create --name work --json 调用 addLabel 并打印 JSON”，每条行为对应一个测试。

4. 以薄切片、测试优先方式实现：在公共接口（program.parseAsync）写测试，先看到失败，再使其通过，并运行对应测试文件。

5. 同步更新受影响的配套内容，包括：命令或标志对应 SKILL_CONTENT 与 npm run sync:skill；新增 SDK 方法对应 mock-api、API_SPINNER_MESSAGES、只读方法加入 KNOWN_SAFE_API_METHODS；返回实体的变更更新 --json 格式与 AGENTS.md 列表；删除类写入更新 mutation-json 条目；彩色或符号输出提供 --accessible 替代；新错误码更新 ErrorCode 类型；结构调整更新 CODEBASE.md。

6. 按 verify 流程验证并汇报；若功能需要先重构，则作为单独变更处理。

适用场景与限制

该技能面向 todoist-cli 项目内的功能开发，依赖项目已有的目录结构、测试支持与文档约定。资料未提供所支持的编程语言、运行环境、安装步骤、收费方式或效果保证，这些信息暂未提供。