PinZheng(docs): add platform outreach guardrails - #37
Merged
Conversation
Require the platform-outreach skill for non-GitHub promotion and record the project-specific visual hierarchy.
📝 WalkthroughWalkthrough
ChangesPlatform outreach
Estimated code review effort: 1 (Trivial) | ~2 minutes 🚥 Pre-merge checks | ✅ 5✅ Passed checks (5 passed)
✨ Finishing Touches🧪 Generate unit tests (beta)
Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out. Comment |
![coderabbitai[bot]](https://avatars.githubusercontent.com/in/347564?s=60&v=4){kind=small}
There was a problem hiding this comment.
Actionable comments posted: 1
🤖 Prompt for all review comments with AI agents
Verify each finding against current code. Fix only still-valid issues, skip the
rest with a brief reason, keep changes minimal, and validate.
Inline comments:
In `@agent.md`:
- Around line 52-56: The platform-outreach hook in agent.md references a missing
skill contract. Add .agents/skills/platform-outreach/SKILL.md defining the
required community-voice, media preflight, draft-integrity, completion-state,
ledger, and publication-gate requirements, including stop-before-publication
rules, or update the hook to an existing skill while keeping terminology
consistent.
🪄 Autofix
Fix all unresolved CodeRabbit comments on this PR:
- Push a commit to this branch (recommended)
- Create a new PR with the fixes
Comment on lines
+52
to
+56
| Before any dashboard, directory form, launchpad, community, article site, or | ||
| other non-GitHub platform work, invoke `$platform-outreach`. Follow its | ||
| community-voice recipe, media preflight, draft-integrity, completion-state, | ||
| ledger, and publication-gate requirements. Its stop-before-publication rules | ||
| override the general submission authority in this file for these surfaces. |
There was a problem hiding this comment.
🗄️ Data Integrity & Integration | 🟠 Major | ⚡ Quick win
🧩 Analysis chain
🏁 Script executed:
#!/bin/bash
set -euo pipefail
skill_files=()
while IFS= read -r file; do
skill_files+=("$file")
done < <(
fd -t f --hidden |
rg '(^|/)(SKILL\.md|platform-outreach[^/]*)$' || true
)
if ((${`#skill_files`[@]} == 0)); then
echo "platform-outreach skill definition not found" >&2
exit 1
fi
rg -n --hidden \
'platform-outreach|media preflight|draft-integrity|completion-state|ledger|publication-gate' \
"${skill_files[@]}"Repository: Ducksss/codex-profiles
Length of output: 213
🏁 Script executed:
#!/bin/bash
set -euo pipefail
echo "== matching skill/platform files =="
git ls-files | rg '(^|[\/])(SKILL|Platform|platform|skill|outreach|SKILL\.md)') || true
echo
echo "== agent.md lines =="
if [ -f agent.md ]; then
nl -ba agent.md | sed -n '1,90p'
fi
echo
echo "== references in tracked files =="
rg -n --hidden \
'platform-outreach|\$platform-outreach|media preflight|draft-integrity|completion-state|ledger|publication-gate|community-voice' \
. || trueRepository: Ducksss/codex-profiles
Length of output: 249
🏁 Script executed:
#!/bin/bash
set -euo pipefail
echo "== matching skill/platform files =="
git ls-files | rg '(^|[\/])(SKILL|Platform|platform|skill|outreach|SKILL\.md)' || true
echo
echo "== agent.md lines =="
if [ -f agent.md ]; then
nl -ba agent.md | sed -n '1,90p'
fi
echo
echo "== references in tracked files =="
rg -n --hidden \
'platform-outreach|\$platform-outreach|media preflight|draft-integrity|completion-state|ledger|publication-gate|community-voice' \
. || trueRepository: Ducksss/codex-profiles
Length of output: 1018
🏁 Script executed:
#!/bin/bash
set -euo pipefail
echo "== agent.md path candidates =="
git ls-files | rg '(^|/)agent\.md$|(^|/)SKILL\.md$|outreach|platform' || true
echo
echo "== agent.md content =="
if [ -f agent.md ]; then
awk '{printf "%5d\t%s\n", NR, $0}' agent.md | sed -n '1,120p'
else
echo "agent.md not found at repo root"
for f in $(git ls-files | rg '(^|/)agent\.md$'); do
echo "-- $f --"
awk '{printf "%5d\t%s\n", NR, $0}' "$f" | sed -n '1,120p'
done
fi
echo
echo "== references in tracked files =="
rg -n --hidden \
'platform-outreach|\$platform-outreach|media preflight|draft-integrity|completion-state|ledger|publication-gate|community-voice' \
. || trueRepository: Ducksss/codex-profiles
Length of output: 8345
🏁 Script executed:
#!/bin/bash
set -euo pipefail
echo "== locate AGENTS.md and skill files =="
git ls-files | rg '(^|/)AGENTS\.md$(|/)' || true
for file in $(git ls-files | rg '(^|/)SKILL\.md$'); do
dir="$(dirname "$file")"
printf '%-80s | basename: %s\n' "$dir" "$(basename "$dir")"
done
echo
echo "== outreach references in AGENTS.md and platform-related files =="
for file in $(git ls-files | rg '(^|/)AGENTS\.md$(|/)' || true); do
if rg -n --hidden 'platform-outreach|\$platform-outreach|outreach|outreach-tracker' "$file" >/dev/null; then
echo "-- $file --"
rg -n --hidden 'platform-outreach|\$platform-outreach|outreach|outreach-tracker' "$file" || true
fi
done
echo
echo "== all current references to $platform-outreach/platform-outreach/invocation syntax =="
rg -n --hidden '\$platform-outreach|platform-outreach|community-voice recipe|media preflight|draft-integrity|completion-state|publication-gate' . || trueRepository: Ducksss/codex-profiles
Length of output: 1097
Add or update the $platform-outreach skill contract.
agent.md requires invoking $platform-outreach for non-GitHub platform work, but the repository has no matching skill definition. Add .agents/skills/platform-outreach/SKILL.md with the referenced community-voice, media preflight, draft-integrity, completion-state, ledger, and publication-gate gates, or change this hook to an existing skill and keep the terminology consistent.
🤖 Prompt for AI Agents
Verify each finding against current code. Fix only still-valid issues, skip the
rest with a brief reason, keep changes minimal, and validate.
In `@agent.md` around lines 52 - 56, The platform-outreach hook in agent.md
references a missing skill contract. Add
.agents/skills/platform-outreach/SKILL.md defining the required community-voice,
media preflight, draft-integrity, completion-state, ledger, and publication-gate
requirements, including stop-before-publication rules, or update the hook to an
existing skill while keeping terminology consistent.
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Summary
$platform-outreachfor non-GitHub dashboard and platform work.Why
This keeps outreach community-first, visually complete, and stopped before public consequences without duplicating the full skill inside
agent.md.Impact
Future non-GitHub outreach runs receive the correct skill, media, identity, and publication-gate instructions.
Validation
make testmake lintquick_validate.py platform-outreachgit diff --cached --checkSummary by CodeRabbit