feature-implementation

Implement an explicitly authorized feature from a settled specification or dependency-ordered work items, delivering and validating one observable behavior slice at a time. Use for new feature deliver

SKILL.md

GitHub

English

Execution Contract

Default to standard; bounded natural-language invocation is allowed. Complete one primary task by default. Continue an authorized end-to-end workflow within each Skill's permissions; Router remains recommendation-only. Pause for new material decisions or scope, not authorization already given. For a human-only blocker, give location, action, success signal and resume step; never request secret values or assume completion. Validate according to actual risk; security, production, migrations, releases and other high-risk work use audit. Read references/execution-modes.en.md only when mode selection is unclear.

Feature Implementation

Deliver a settled feature within the user's authorized scope, one verifiable behavior slice at a time.

Boundary

  • Require a settled specification or work items, known impact, acceptance criteria and write scope. Reuse reliable evidence and existing authorization; do not demand separate documents or repeated approval. Route material open decisions to requirements-clarification, unknown impact to change-impact-analysis, and missing sequencing to safe-change-plan.
  • A diagnosed local defect belongs to safe-fix-implementation; test-only and docs-only edits belong to safe-test-implementation and documentation-sync.
  • Preserve existing changes. Edit production code and supporting tests/docs only within authorization. Do not install dependencies, access the network, run migrations, change production data, commit, push, publish, or perform unrelated refactors.
  • Inspect command definitions and transitive hooks before running local validation. Block commands with prohibited or unknown side effects; never substitute script inspection for execution evidence.

Workflow

  1. Map acceptance criteria to dependency-ordered behavior slices, affected files and focused checks. Reuse an adequate existing plan; do not expand a small feature into a mandatory planning pipeline.
  2. For the next slice, inspect existing code and tests. When authoring tests, read references/testing-contract.en.md bundled with this Skill; no separate Skill installation is required. This Skill owns authorized production and supporting test changes in the cycle.
  3. Implement the smallest complete behavior and its authorized supporting tests/docs. Honor the selected test mode; do not create all future tests or speculative abstractions first.
  4. Run the focused check and record its actual result. Resolve in-scope failures before the next dependent slice. Mark missing tools, unsafe commands and unrun checks as unverified or blocked, not passed; continue independent authorized work when useful.
  5. Repeat until all in-scope acceptance criteria are implemented and verified, or a named blocker prevents completion. Pause for new material decisions, scope expansion or human-only prerequisites; preserve completed slices for resumption.
  6. Inspect the final diff against acceptance criteria and use safe-code-review when the user authorized the full delivery/review flow. State whether review was performed; passing tests do not prove a clean review. Run only the necessary regression scope; existing valid evidence need not be rerun without a relevant change.
  7. Return the acceptance-to-evidence map. Completion requires all in-scope behavior delivered, relevant checks passed and no blocking review finding; otherwise state partial/blocked status and the exact remaining work. Passing local checks is not release approval.

Output Contract

State complete, partial or blocked, then list delivered behavior with changed paths and acceptance/check evidence. Include remaining failures, unverified criteria and the smallest resume action only when present. Distinguish observed results from proposed checks. Keep routine output compact; expand per-slice commands, risks and evidence on request or in audit mode.

简体中文

执行契约

默认使用 standard;允许边界明确的自然语言隐式调用。 默认完成一个主任务。用户已授权完整流程时,在各 Skill 权限内连续完成;Router 仍只推荐。新重大决策或超出授权时暂停,不重复索取已有授权。 必须由用户完成的阻塞步骤:给出操作位置、具体动作、成功标志、恢复步骤;不要求粘贴秘密值,不代替用户确认完成。 按实际风险选择验证;安全、生产、迁移、发布等高风险工作使用 audit。模式不明确时才读取 references/execution-modes.zh-CN.md。

功能实施

在用户授权范围内实施已确认功能,一次交付一个可验证的行为切片。

职责边界

  • 需要已确认规格或工作项、已知影响、验收条件和写入范围。复用可靠证据及已有授权,不强制另建文档或重复审批。重大未决项交给 requirements-clarification,未知影响交给 change-impact-analysis,缺少实施顺序交给 safe-change-plan。
  • 已诊断的局部缺陷使用 safe-fix-implementation;仅测试或仅文档修改使用 safe-test-implementation、documentation-sync。
  • 保护已有改动,仅在授权范围内修改生产代码及配套测试/文档。不安装依赖、不联网、不执行迁移、不修改生产数据、不 commit/push/发布,也不做无关重构。
  • 执行本地验证前检查命令定义及间接钩子。禁止或副作用未知的命令标记阻塞,读取脚本不能替代执行证据。

工作流程

  1. 将验收条件映射为按依赖排序的行为切片、影响文件和定向检查。已有计划足够时直接复用,不把小功能扩展成强制规划流水线。
  2. 检查下一切片的代码和测试。编写测试时读取随本 Skill 分发的 references/testing-contract.zh-CN.md,无需另行安装其他 Skill。本 Skill 负责循环内已授权的生产代码与配套测试修改。
  3. 实施最小完整行为及已授权的配套测试/文档,遵守所选测试模式,不先批量编写未来测试或推测性抽象。
  4. 运行定向检查,记录真实结果。下一依赖切片开始前先处理范围内失败。工具缺失、不安全命令或未运行检查标记未验证或阻塞,不写成通过;有用时继续独立且已授权的工作。
  5. 重复至范围内全部验收条件完成验证,或被明确阻塞项挡住。出现新重大决策、范围扩张或必须人工完成的前置步骤时暂停相关工作,保留已完成切片便于续接。
  6. 核对最终 diff 与验收条件;用户已授权完整交付/审查流程时使用 safe-code-review。注明是否实际完成审查,测试通过不代表审查无问题。只运行必要回归,相关内容未变时不重复已有有效验证。
  7. 输出验收—证据映射。仅当范围内行为全部交付、相关检查通过且无阻塞审查问题时标记完成;否则明确部分完成/阻塞和剩余工作。本地检查通过不等于批准发布。

输出契约

先给完成、部分完成或阻塞状态,再列交付行为、修改路径及验收/检查证据。有剩余失败、未验证条件或恢复动作时才补充,区分实际结果与建议检查。日常输出简洁;用户要求或 audit 模式再展开逐切片命令、风险和证据。