implement
GitHub执行单一受限实验,将意图转化为最小代码变更。遵循RED-THEN-GREEN流程,运行测试验证,生成证据并返回结果摘要,不提交代码。
Trigger Scenarios
Install
npx skills add boshu2/agentops --skill implement -g -y
SKILL.md
Frontmatter
{
"name": "implement",
"consumes": [],
"metadata": {
"tier": "execution",
"effects": [
"modify_declared_subject",
"derive_subject_manifest"
],
"graph_root": true,
"disposition": "keep",
"capabilities": [
"execute_one_experiment",
"collect_factual_evidence"
],
"dependencies": [],
"canonical_status": "canonical"
},
"produces": [
"subject-manifest.v1"
],
"practices": [
"tdd",
"refactoring",
"small-batch-flow"
],
"context_rel": [
{
"kind": "customer-of",
"with": "plan"
}
],
"description": "Execute one bounded RED to GREEN experiment from bead or caller intent; return derived subject identity and check facts. Triggers: \"implement\", \"implement this bead\", \"run the experiment\". Full plan-to-validation requests route to rpi.",
"hexagonal_role": "driving-adapter",
"user-invocable": true,
"output_contract": "subject-manifest.v1 digest, author context ID, and exact acceptance-check receipts returned through the response or runtime channel",
"skill_api_version": 1
}
Implement
Execute exactly one bounded experiment described by the resolved bead or caller intent. Implement owns subject edits and factual evidence; the runtime derives identity and receipts.
Prompt
Implement bead ag-1234 from its text: acceptance "ao gate check lists
skill.probe-coverage", scope cli/internal/gates/** plus regen outputs, first
check `cd cli && go test ./internal/gates/...`. RED first, smallest change,
return the manifest digest and check receipts, stop.
It's working if
- After source activation and startup association, the first behavior check is the acceptance check; its output shows the expected failure (or an honest green structural baseline for documentation, relocation, or refactor work).
- Every path in
git diff --statfalls inside the declared scope; an outside consumer is reported asfile:line, not absorbed. - The response carries the
subject-manifest.v1digest, author context ID, and verbatim check output; nogit commitorgit pushappears.
Workflow
- Read the intent, acceptance, and scope from their existing source; before
the first write, read
boundaries.mdin the rpi skill'sreferencesdirectory for what Implement does not own. Before execution can fail, the caller passes source-store/project/work identity and permitted intent locators at dispatch/start. At startup, return observed native runtime, session/context identity (or explicit unknowns) through the caller-owned runtime channel for native comments/metadata recording; do not defer this association until handoff. Follow the fact distinctions in session associations. Parent and resume links need observed provenance; controller dispatch alone does not establish native parentage. If startup observation or recording fails, preserve that failure and the pre-execution reference with the caller, leaving unobserved IDs unknown. Implement does not mutate the tracker. - Run the declared first acceptance check before changing behavior. RED-first applies when acceptance is behavioral: preserve evidence that the check fails for the expected missing behavior. Relocations, doc merges, and pure refactors record an honest green pre-change baseline instead.
- Make the smallest in-scope change that satisfies the active behavior.
- Run the targeted acceptance checks and capture factual results.
- Refactor only while those checks stay green. Refactoring does not change the acceptance test.
- Have the runtime derive actual changed paths and
subject-manifest.v1from the before/after subject. - Run
ao provenance evidence-orphans --root <repo-root>with one--changed <path>per changed path the runtime derived, and put its JSON output in the check receipts the validator reads, so orphaned evidence arrives as a receipt rather than as a surprise at verify time. Run it again after every repair round, over the paths as they stand, because a repair can orphan evidence the first pass did not. Read the output as written and never hand-list the orphans instead. - Return the manifest digest, author context ID, and exact check receipts in the response or runtime channel. Stop.
Specialists (standards, domain, test, refactor, security) advise only. During edits, run the smallest deterministic checks that can falsify the change, reuse exact-input receipts whose subject and tool identity still match, and run the full suite at the integration boundary unless the intent makes it the first check.
Scope conflict rule
On discovering a live consumer of the change outside the declared write scope (a test asserting the old path, a generated twin, a gate reading the moved file), stop and report the exact file and line to the caller, who may revise the intent and start a separate invocation; a different acceptance contract is a new intent.
Before declaring GREEN, self-audit the diff for mocks, placeholders, TODO stubs, hardcoded fixture values, weakened assertions, regenerated goldens, widened tolerances, suppression directives, or specification edits standing in for real behavior. A changed test, gate, fixture, golden, or acceptance source must be required by the original intent, with green coming from the implemented behavior; a check that passes against a substitute or weakened oracle is not evidence: finish the behavior or report it as not built.
Boundary
Do not commit, push, claim, close, release, land, reserve, retry, or invoke a semantic validator. A failed check is evidence for the caller, not permission to create a packet or validation loop.
Version History
-
8061085
Current 2026-09-09 05:16
新增启动时原生运行时与上下文身份关联记录;引入边界检查文件读取;增加血缘证据孤儿检查步骤。
-
7b07a7d
2026-08-19 21:59
收敛保留的工作区内容并强化证据边界;对齐技能契约与操作契约,解决不一致性。
- 3f402e5 2026-07-24 22:07


