# task-impl

**Repository Path**: larntin/task-impl

## Basic Information

- **Project Name**: task-impl
- **Description**: Codex Skills 基于本地项目下 docs/*.md  doc/*.md 文档规范，面试任务实现的技能。
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-02-12
- **Last Updated**: 2026-02-20

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# task-impl / task

本仓库当前维护两个并行的本地规划技能：

- `task-impl`：完整 spec 驱动、带计划持久化与生命周期管理。
- `task`：轻量 prompt 驱动、基于全局上下文快速产出计划，不做计划文件持久化。

## 技能对比

| 维度 | `task-impl` | `task` |
|---|---|---|
| 需求主来源 | `features/<feature-key>/feature-spec.md` | 当前用户提示词 |
| 全局上下文 | `00/10/20/30`（存在即读） | 至少 `00` 或 `10` 之一 |
| DB 规则 | DB 相关任务时 DB 参考变为必需 | 与 `task-impl` 一致，DB 相关任务时条件性必需 |
| 计划输出 | `# Plan` 标准结构 + 每任务完整字段 | `# Plan` 标准结构（简洁版） |
| 持久化 | 必须写入 `<feature-dir>/task_impl_plan.md` | 不要求持久化 |
| 生命周期 | `DRAFT -> APPROVED -> EXECUTING -> DONE` | 按对话反馈整版重生计划 |
| 与 `create-plan` 关系 | 仅复用风格，不调用技能 | 仅复用风格，不调用技能 |

## 何时用哪个技能

- 选择 `task-impl`：
  - 你有清晰的 `feature-spec.md`。
  - 需要计划可追溯、可落盘、可管理修订和状态流转。
  - 需要更严格的文档契约（含可选 DB 条件必需规则）。

- 选择 `task`：
  - 你要快速把当前提示词转为可执行计划。
  - 只需要读取全局项目框架（`project-overview` / `architecture`）。
  - DB 相关任务时同样执行 DB 参考文档校验。
  - 不需要生成 `task_impl_plan.md` 这类持久化计划文件。

## `task-impl` 快速说明

核心能力：
- 从 `docs/**`（优先）和 `doc/**`（回退）读取需求与上下文。
- 产出有序任务、每任务测试计划、可度量通过标准。
- 持久化到 `<feature-dir>/task_impl_plan.md`，并维护 revision 与状态。

关键文档模式：
- 全局：`00-project-overview.md`、`10-architecture.md`、`20-functional-requirements.md`、`30-non-functional-requirements.md`
- 功能：`features/<feature-key>/feature-spec.md`（必需），其余功能文档可选
- DB 参考：`**/*.dbml`、`**/database*.md`（DB 任务时条件性必需）

详细规则见：
- `task-impl/SKILL.md`
- `AGENTS.md`

## `task` 快速说明

核心能力：
- 以“当前提示词”作为具体需求输入。
- 先读取全局上下文（`00-project-overview.md`、`10-architecture.md`，`docs/` 优先于 `doc/`）。
- 支持与 `task-impl` 相同的 DB 参考路径模式（`**/*.dbml`、`**/database*.md`）及条件性阻塞规则。
- 生成与 `create-plan` 一致结构的简洁计划，不调用 `create-plan` 技能本身。

最小门槛：
- prompt 目标清晰。
- `project-overview` / `architecture` 至少可用其一。
- 若任务涉及 DB 变更，DB 参考文档必须可用。
- 若二者都缺失，仅提 1-3 个阻塞问题并停止。

详细规则见：
- `task/SKILL.md`
- `task/README.md`

## 统一输出风格（两者共享）

两者都使用同一计划结构：
- `# Plan`
- `## Scope`（`In` / `Out`）
- `## Action items`
- `## Open questions`

并遵循：
- Action items 原子化、有序、动词开头。
- 至少包含 1 个验证/测试项。
- 适用时包含 1 个风险/边界场景项。
- 非阻塞信息缺失时使用显式假设；阻塞缺失仅提 1-3 个问题。

## 示例入口

- `task-impl` 示例：
  - `task-impl/examples/coverage-matrix.md`
  - `task-impl/examples/scenario-complete/`
  - `task-impl/examples/scenario-dbml-missing-db-task-blocking/`
  - `task-impl/examples/scenario-plan-file-lifecycle/`

- `task` 示例：
  - `task/examples/01-basic-plan-with-global-context.md`
  - `task/examples/02-single-global-doc-with-assumptions.md`
  - `task/examples/03-missing-global-context-blocking-questions.md`
  - `task/examples/04-feedback-revision-full-plan.md`