3.8 KiB
| kind | id | version | title | description | inputs | outputs | bc-version | technologies | countries | application-area | sub-skills | ||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| action-skill | al-code-review | 1 | AL code review | Reviews AL source changes by composing the AL review leaf skills, using TCOG-specific performance guidance where available. |
|
|
|
|
|
|
|
AL code review
Reviews AL source changes by composing the AL review leaf skills. This custom-layer variant preserves the standard BCQuality multi-domain review flow, but replaces the performance leaf with the tCOG custom performance review so local conventions participate in the same code-review route.
Source
The sub-skills invoked by this skill are exactly those listed in frontmatter sub-skills. The skill does not discover sub-skills implicitly.
Relevance
A sub-skill is relevant when both of the following hold:
- The orchestrator supplied inputs that satisfy the sub-skill's declared
inputs. - The orchestrator did not disable the sub-skill via configuration.
Per the DO contract, this super-skill must not filter sub-skills by diff content. Each leaf is responsible for deciding whether the task is applicable inside its own execution.
Sub-skills that fail either check are not invoked and are recorded in skipped-sub-skills with reason configuration or not-applicable.
Worklist
The worklist is the list of sub-skills judged relevant by the previous step. Every sub-skill in the worklist is invoked in the Action step.
Action
Execute the worklist as discrete iterations, one sub-skill at a time.
For each sub-skill:
- Invoke the sub-skill with the orchestrator-supplied inputs, passing only the subset declared by that sub-skill.
- Capture the sub-skill's full findings-report verbatim in
sub-results. - If the sub-skill outcome is
failed, keep its report insub-resultsbut do not roll its findings up into the top-level result. - Otherwise, append each finding from the sub-skill's
findings[]to the super-skill's top-levelfindings[], settingfrom-sub-skillto the producing sub-skill'sskill.id. If the rolled-up finding uses a slugidrather than a reference path, prefix it with<from-sub-skill>:to avoid collisions.
After every sub-skill completes, perform one self-review pass over the same diff to look for concrete cross-cutting concerns that no single leaf could surface on its own. Validate each candidate against the BCQuality knowledge already loaded by the leaves:
- If a loaded knowledge file matches the concern, upgrade it to a knowledge-backed finding and attribute it to the owning sub-skill.
- If loaded knowledge explicitly contradicts the concern, suppress it.
- Otherwise, emit it as an agent finding with
references: [], anidprefixed withagent:,confidenceno higher thanmedium, andseverityno higher thanminor.
Populate suggested-code whenever the fix is small, local, and mechanical.
Aggregate summary counts and coverage across invoked sub-skills whose outcome is not failed. Agent findings produced by the super-skill contribute to counts but not to coverage.
Output
Output conforms to the DO findings-report contract in skills/do.md, including sub-results and skipped-sub-skills for this super-skill.